视频生成

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

curl -X POST https://gogogotoken.ai/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "prompt": "镜头缓缓推进，人物自然微笑",
    "images": ["https://assets.example.com/first-frame.jpg"],
    "seconds": "5",
    "metadata": { "resolution": "720p" }
  }'

curl -X POST https://gogogotoken.ai/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "prompt": "产品在展示台上缓慢旋转，背景简洁",
    "seconds": "5",
    "metadata": {
      "resolution": "720p",
      "content": [
        {
          "type": "image_url",
          "image_url": { "url": "asset://asset_xxx" },
          "role": "first_frame"
        }
      ]
    }
  }'

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

POST

video

generations

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

curl -X POST https://gogogotoken.ai/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "prompt": "镜头缓缓推进，人物自然微笑",
    "images": ["https://assets.example.com/first-frame.jpg"],
    "seconds": "5",
    "metadata": { "resolution": "720p" }
  }'

curl -X POST https://gogogotoken.ai/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "prompt": "产品在展示台上缓慢旋转，背景简洁",
    "seconds": "5",
    "metadata": {
      "resolution": "720p",
      "content": [
        {
          "type": "image_url",
          "image_url": { "url": "asset://asset_xxx" },
          "role": "first_frame"
        }
      ]
    }
  }'

{
  "id": "task_1234567890",
  "task_id": "task_1234567890",
  "status": "queued",
  "model": "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": "seedance-2-0-fast",
    "prompt": "一只橘猫在阳光下伸懒腰，镜头缓慢推进",
    "seconds": "5",
    "metadata": { "resolution": "480p" }
  }'

curl -X POST https://gogogotoken.ai/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "prompt": "镜头缓缓推进，人物自然微笑",
    "images": ["https://assets.example.com/first-frame.jpg"],
    "seconds": "5",
    "metadata": { "resolution": "720p" }
  }'

curl -X POST https://gogogotoken.ai/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "prompt": "产品在展示台上缓慢旋转，背景简洁",
    "seconds": "5",
    "metadata": {
      "resolution": "720p",
      "content": [
        {
          "type": "image_url",
          "image_url": { "url": "asset://asset_xxx" },
          "role": "first_frame"
        }
      ]
    }
  }'

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

模型	说明
`seedance-2-0-fast`	更快更省，最高 720p
`seedance-2-0`	画质更好，支持 1080p / 4K

图生视频两种方式

方式 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 相同。

任务回调（可选，依赖渠道支持）

提交时传入顶层 callback_url，任务状态变化（完成 / 失败）时上游平台会向该地址发起 HTTP POST 回调，免去轮询：

提交时指定回调地址

curl -X POST https://gogogotoken.ai/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0-fast",
    "prompt": "一只橘猫在阳光下伸懒腰",
    "seconds": "5",
    "callback_url": "https://your-server.com/webhooks/seedance"
  }'

回调能力并非每个渠道都有（取决于任务实际路由的上游渠道）。不支持的渠道会忽略该字段——任务正常提交，但不会收到回调。具体适配的渠道请咨询客服；无论是否配置回调，都建议保留任务查询作为兜底。

callback_url 必须是公网可访问的地址（由上游平台直接调用）。
回调体为该任务的最新状态与结果，字段结构与任务查询响应一致（含 status、视频 URL、usage）。
计费在提交时预扣、完成时结算，与是否配置回调无关。

参数说明

string

required

视频模型 ID：seedance-2-0 或 seedance-2-0-fast。

string

required

视频描述文本。

string

时长（秒），常用 "5"。

string[]

图生视频时的参考图片 URL 列表（公网 HTTPS）。

string

分辨率：480p、720p、1080p、4k（仅标准版）。fast 模型最高 720p。也可通过 size 传相同枚举值。

string

与 metadata.resolution 等价的官方枚举；不支持像素串。

string

画幅比例，如 9:16、16:9。

array

高级图生/参考内容，可指定 first_frame 与 asset:// 引用。

string

可选。任务完成 / 失败时上游平台向该公网地址 POST 回调任务结果，可替代轮询。并非每个渠道都支持（不支持的渠道会忽略该字段），具体适配的渠道请咨询客服，详见任务回调。

下一步

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

开始使用

基础

账户与计费

AI 工具配置

AI 应用平台配置

大模型接口

Seedream 图像

Seedance 视频

Seedance 素材

更新日志

推荐模型

图生视频两种方式

OpenAI 兼容格式（可选）

任务回调（可选，依赖渠道支持）

参数说明

下一步

​推荐模型

​图生视频两种方式

​OpenAI 兼容格式（可选）

​任务回调（可选，依赖渠道支持）

​参数说明

​下一步

推荐模型

图生视频两种方式

OpenAI 兼容格式（可选）

任务回调（可选，依赖渠道支持）

参数说明

下一步