Skip to main content
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

  1. Sign in at app.yuzulabs.io.
  2. Open Settings → API Keys.
  3. Click Create key, give it a name, and select scopes: flows:create, flows:read, flows:approve, flows:cancel. Use * for full access.
  4. 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.