Text to Video

POSThttps://api.tokenbyte.ai/api/v1/video/generation

使用 TokenByte 统一视频任务接口调用 Kling 的Text to Video能力。模型名称请从模型市场复制，不要根据厂商官网名称自行推测。

Header 参数

参数	必填	说明
`Authorization`	是	`Bearer <TOKENBYTE_API_KEY>`
`Content-Type`	是	`application/json`

Body 参数

参数	类型	必填	说明
`model`	string	是	Kling 模型的完整 ID
`_action`	string	视模型	当前模式使用 `t2v`
`prompt`	string	视模式	生成或编辑提示词
`image`	string/object/array	否	参考图 URL、Base64 或厂商结构化图片对象
`headtailImages`	object	首尾帧模式	首帧与尾帧图片
`characterImages`	array	参考模式	主体或风格参考图片
`duration`	integer	否	视频时长，枚举取决于模型
`resolution`	string	否	输出尺寸或分辨率
`seed`	integer	否	模型支持时控制随机种子

模式说明

可灵通过动作类型与素材数组组合文生、图生和 Omni 能力。

仅传入模型明确支持的字段；不支持的参数可能被忽略或返回参数错误。

请求示例

curl https://api.tokenbyte.ai/api/v1/video/generation \
  -H "Authorization: Bearer $TOKENBYTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "_action": "t2v",
  "model": "<model-id>",
  "prompt": "描述主体、动作、场景和镜头",
  "duration": 5,
  "resolution": "720p"
}'

响应

{
  "code": 0,
  "data": {
    "task_id": "video_xxx",
    "task_status": "pending",
    "urls": []
  },
  "message": "success",
  "request_id": "req_xxx"
}

若响应直接包含 urls，可立即读取结果；若返回 task_id，请调用查询视频任务直到进入成功或失败终态。