Script to Video

POST

https://api.zebracat.ai/v1/video/script

Video Generation

Generate a video from a provided voice-over script.

The API creates a background task that:

Generates voice-over audio from the script

Creates AI visuals matching the script

Renders the final video

Use the returned task_id to poll for status via GET /api/public/video/status.
When complete, your registered webhook will receive a video.completed event.

Request

Authorization

API Key

Add parameter in header

X-API-KEY

Example:

X-API-KEY: ********************

Body Params application/jsonRequired

Examples

Responses

🟢202

application/json

Task created successfully.

Body

🟠400

🟠401

🟠402

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.zebracat.ai/v1/video/script' \
--header 'X-API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "script": "string",
    "language": "string",
    "duration": 15,
    "voice_id": "string",
    "footage_type": "ai_image",
    "style_id": 0,
    "mood": "energetic",
    "aspect_ratio": "vertical",
    "prompt_style": "ad",
    "character_id": 0,
    "brand_id": 0,
    "avatar_id": 0,
    "should_render": false
}'

Response Example

202 - Example 1

{
    "task_id": "string",
    "status": "string"
}

List Prompt Styles

Get Video Task Status