Skip to main content
POST
/
v1
/
video
/
generations
curl -X POST https://gogogotoken.ai/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast",
    "prompt": "一只橘猫在阳光下伸懒腰，镜头缓慢推进",
    "seconds": "5",
    "metadata": { "resolution": "480p" }
  }'

{
  "id": "task_1234567890",
  "task_id": "task_1234567890",
  "status": "queued",
  "model": "doubao-seedance-2-0-fast"
}
视频生成是异步任务。提交后立即返回 task_id，再通过 任务查询 轮询结果。
Base URL 固定为 https://gogogotoken.ai。所有请求需携带 Authorization: Bearer YOUR_API_KEY。
curl -X POST https://gogogotoken.ai/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast",
    "prompt": "一只橘猫在阳光下伸懒腰，镜头缓慢推进",
    "seconds": "5",
    "metadata": { "resolution": "480p" }
  }'

{
  "id": "task_1234567890",
  "task_id": "task_1234567890",
  "status": "queued",
  "model": "doubao-seedance-2-0-fast"
}

​
推荐模型

模型说明
doubao-seedance-2-0-fast更快更省，最高 720p
doubao-seedance-2-0画质更好，支持 1080p
按实际生成量计费，提交时预扣，完成后按真实用量结算。

​
图生视频两种方式

方式 1 · 公网 HTTPS 图片 在请求体中传入 images 数组，或使用 metadata.content[] 指定首帧。 方式 2 · 已上传素材 先通过 素材管理 登记图片，得到 asset://asset_xxx，在 metadata.content 中引用。
asset:// 图生要求素材与推理接入点在同一 BytePlus 项目。若报 asset not found，可先用公网 HTTPS 图片链接代替。

​
OpenAI 兼容格式（可选）

操作方法路径
提交POST/v1/videos
查询GET/v1/videos/{task_id}
下载GET/v1/videos/{task_id}/content
参数与 /v1/video/generations 相同。

​
参数说明

​
model
string
required
视频模型 ID：doubao-seedance-2-0 或 doubao-seedance-2-0-fast。
​
prompt
string
required
视频描述文本。
​
seconds
string
时长（秒），常用 "5"。
​
images
string[]
图生视频时的参考图片 URL 列表（公网 HTTPS）。
​
metadata.resolution
string
分辨率：480p、720p、1080p。fast 模型请勿使用 1080p。
​
metadata.ratio
string
画幅比例，如 9:16、16:9。
​
metadata.content
array
高级图生/参考内容，可指定 first_frame 与 asset:// 引用。

​
下一步

提交成功后，使用返回的 task_id 调用 任务查询与轮询。建议每 5–8 秒轮询一次，通常 30–120 秒出片。