Create Video

POST https://www.kkiai.com/v1/video/create

Request Parameters

Authorization

Add the Authorization parameter to the Header. Its value is the Token concatenated after Bearer.

Example: Authorization: Bearer ********************

Header Parameters

Parameter	Type	Required	Description	Example
Content-Type	string	Required		application/json
Accept	string	Required		application/json
Authorization	string	Optional		Bearer {{YOUR_API_KEY}}

Body Parameters (application/json)

Parameter	Type	Required	Description
enable_upsample	boolean	Optional
enhance_prompt	boolean	Optional	Since veo only supports English prompts, you can enable this switch to automatically convert Chinese prompts to English prompts
images	array[string]	Optional	For veo2-fast-frames model, supports up to two images (first and last frames). For veo3-pro-frames model, supports up to one image (first frame). For veo2-fast-components model, supports up to 3 images (images are elements in the video)
model	enum<string>	Required
prompt	string	Required
aspect_ratio	string	Optional	⚠️ Only supported by veo3, "16:9" or "9:16"

Request Example

{
    "enable_upsample": true,
    "enhance_prompt": true,
    "images": [
        "https://filesystem.site/cdn/20250702/w8AauvxxPhYoqqkFWdMippJpb9zBxN.png"
    ],
    "model": "veo3.1-fast",
    "prompt": "make animate",
    "aspect_ratio": "16:9"
}

cURL Example

curl --location --request POST 'https://www.kkiai.com/v1/video/create' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "enable_upsample": true,
    "enhance_prompt": true,
    "images": [
        "https://filesystem.site/cdn/20250702/w8AauvxxPhYoqqkFWdMippJpb9zBxN.png"
    ],
    "model": "veo3.1-fast",
    "prompt": "make animate",
    "aspect_ratio": "16:9"
}'

Response

🟢 200 Success

Response Body

Parameter	Type	Required	Description
id	string	Required
status	string	Required
status_update_time	integer	Required
enhanced_prompt	string	Required

Response Example

{
    "id": "veo3-fast-frames:1757555257-PORrVn9sa9",
    "status": "pending",
    "status_update_time": 1757555257582
}