Doubao Native Video Generation

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

Header 参数

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

Body 参数

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

模式说明

输入通常使用扁平字段或 content 内容数组，具体支持项取决于所选模型。

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

请求示例

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，请调用查询视频任务直到进入成功或失败终态。