提交视频生成任务 - KFC V50 API Docs

请求参数

Body 参数application/json

prompt

string

必需

视频生成的文本描述，建议详细描述场景、动作、风格等

<= 2000 字符

示例值:

一只橘色的猫咪在蓝天白云中飞翔，阳光洒在它的毛发上，画面唯美而梦幻

model

enum<string>

使用的模型名称

可选

枚举值:

veo2veo2-fastveo2-fast-componentsveo2-fast-framesveo2-proveo3veo3-fastveo3-proveo3-pro-frames

默认值:

veo3

示例值:

veo3

images

array[string <uri>]

可选

参考图片URL数组，用于辅助视频生成

<= 5 items

示例值:

["https://example.com/reference1.jpg","https://example.com/reference2.jpg"]

enhance_prompt

boolean

是否增强提示词

可选

默认值:

false

示例值:

true

示例

基本请求包含参考图片

{
    "prompt": "一只橘色的猫咪在蓝天白云中飞翔，阳光洒在它的毛发上，画面唯美而梦幻",
    "model": "veo3",
    "enhance_prompt": true
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

cURL

基本请求包含参考图片

curl --location --request POST '/veo/v1/api/video/submit' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "一只橘色的猫咪在蓝天白云中飞翔，阳光洒在它的毛发上，画面唯美而梦幻",
    "model": "veo3",
    "enhance_prompt": true
}'

返回响应

🟢200成功

application/json

任务提交成功

Body

success

boolean

请求是否成功

可选

data

object

可选

taskId

string

可选

任务ID，用于后续查询状态

示例值:

veo3:a1b2c3d4-e5f6-7890-abcd-ef1234567890

pollingUrl

string

轮询URL

可选

示例值:

https://asyncdata.net/source/veo3:a1b2c3d4-e5f6-7890-abcd-ef1234567890

status

enum<string>

任务状态

可选

枚举值:

processingcompletedfailed

示例值:

processing

message

string

状态描述

可选

示例值:

任务提交成功，正在处理中

示例

{
    "success": true,
    "data": {
        "taskId": "veo3:a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "pollingUrl": "https://asyncdata.net/source/veo3:a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "status": "processing",
        "message": "任务提交成功，正在处理中"
    }
}

🟠400请求有误

🟠401没有权限

🔴500服务器错误