API quickstart

This walk-through generates a 60–70 second sales-email video from a call summary using the public API. If you’re driving Yuzu from the dashboard instead, see the UI quickstart.

1. Get an API key

Sign in at app.yuzulabs.io.
Open Settings → API Keys.
Click Create key, give it a name, and select scopes: flows:create, flows:read, flows:approve, flows:cancel. Use * for full access.
Copy the key. It starts with yzlk_ and is only shown once.

Keys are scoped to a single workspace. Treat them like passwords — never commit them to source control.

2. Make sure your workspace is ready

Before the first request, your workspace needs:

At least one avatar that’s been processed (16:9).
A configured ElevenLabs voice (or use the workspace default).
Available video quota.

You can confirm all three from Settings → Brand & Voice.

3. Create a video

curl -X POST https://app.yuzulabs.io/api/v1/flows/sales-email-video \
  -H "Authorization: Bearer yzlk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "emailContent": "Great call with John from Acme Corp today. We discussed video marketing pain points: (1) production time, (2) brand consistency, (3) scaling content. Next step: send a product demo.",
    "autoApproveScript": true,
    "prospectName": "John",
    "prospectCompany": "Acme Corp"
  }'

You’ll get back a flowId. The flow runs asynchronously — script → segments → voice → render.

4. Poll for completion

curl https://app.yuzulabs.io/api/v1/flows/sales-email-video/{flowId} \
  -H "Authorization: Bearer yzlk_your_api_key_here"

When status is completed, the response includes videoUrl.

Next steps

Full API reference

Every parameter, status, and error code.

Authentication and errors

Bearer tokens, scopes, error codes.

Overview

Flows

API quickstart

1. Get an API key

2. Make sure your workspace is ready

3. Create a video

4. Poll for completion

Next steps

Full API reference

Authentication and errors

​1. Get an API key

​2. Make sure your workspace is ready

​3. Create a video

​4. Poll for completion

​Next steps

Full API reference

Authentication and errors

1. Get an API key

2. Make sure your workspace is ready

3. Create a video

4. Poll for completion

Next steps