Skip to main content
The Yuzu API lets you create and manage video-generation flows from your own systems — typically to wire Yuzu into a CRM, automation, or notetaker pipeline.

​
Base URL

https://app.yuzulabs.io/api/v1

​
Authentication

All endpoints require a Bearer token in the Authorization header: 
Authorization: Bearer yzlk_your_api_key_here
API keys start with yzlk_ and are created from Settings → API Keys in your Yuzu workspace. Keys are scoped to a single workspace and can be restricted to specific operations (see Scopes below).
Treat keys as secrets. They grant access to your workspace’s data and quota. Rotate immediately if exposed.

​
Scopes

ScopeWhat it allows
flows:createStart new flows.
flows:readRead flow status, scripts, and rendered video URLs.
flows:approveApprove, edit, or reject scripts when manual approval is enabled.
flows:cancelCancel an in-progress flow.
*All of the above.

​
Errors

Errors return a JSON body with a stable code: 
{
  "success": false,
  "error": "Email content must be at least 50 words",
  "code": "VALIDATION_ERROR"
}
StatusCodeMeaning
400VALIDATION_ERRORRequest body failed validation.
401INVALID_API_KEYMissing or invalid API key.
403INSUFFICIENT_SCOPEKey doesn’t have the required scope.
404FLOW_NOT_FOUNDThe flow ID doesn’t exist or isn’t in your workspace.
429QUOTA_EXCEEDEDWorkspace video quota reached.
5xxINTERNAL_ERRORTransient — retry with exponential backoff.

​
Available flows

Sales Email Video Flow

60–70 second follow-up videos generated from a sales-call summary email.