ToAPIs
home

快速结论

  • 通过 model 可选 fast/quality 两个 1.0 Pro 版本，覆盖速度优先与质量优先需求。
  • 统一入口 POST /v1/videos/generations，支持首帧、尾帧与参考图控制（按版本限制）。
  • 支持异步任务流程，提交后返回任务 ID，再通过任务状态接口轮询结果。

关键参数

  • model | string | 必填 | doubao-seedance-1-0-pro-fast | doubao-seedance-1-0-pro-fast | doubao-seedance-1-0-pro-quality | 视频生成模型名称；fast 速度优先，quality 质量优先。
  • prompt | string | 必填 | - | - | 视频内容描述，建议明确场景、动作与风格。
  • duration | integer | 可选 | 5 | 2-12 | 视频时长（秒）。
  • aspect_ratio | string | 可选 | 16:9 | 16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 21:9 | 视频宽高比。
  • resolution | string | 可选 | 720p | 480p | 720p | 1080p | 视频分辨率；使用 reference 图时存在 1080p 限制。
  • image_urls | string[] | 可选 | - | - | 首帧图像 URL 数组；仅支持 URL，不支持 base64；与 image_with_roles 互斥。
  • image_with_roles | array | 可选 | - | - | 带角色图像数组（first_frame/last_frame/reference）；每种角色仅支持一张。
  • metadata.seed | integer | 可选 | - | -1 ~ 2^32-1 | 种子值，用于控制生成随机性。

常见错误

  • 400 invalid_request_error: 触发=model、prompt 或时长/比例等参数缺失或格式不合法。; 修复=按文档校验必填字段与取值范围，重点检查 duration、aspect_ratio、resolution。; 重试=修正参数后重试。
  • 401 authentication_error: 触发=Authorization 缺失、格式错误或 API Key 无效。; 修复=确认 Bearer Token 与 API Key 权限。; 重试=修复鉴权后重试。
  • 429 rate_limit_exceeded: 触发=请求频率、并发或当前额度命中上游限流策略。; 修复=先做指数退避重试，并检查当前请求节奏、并发设置和额度使用情况。; 重试=建议 1s/2s/4s + 抖动；连续触发时再收紧提交节奏。

doubao-seedream-4-0

doubao-seedream-4-0 是字节跳动豆包视频生成系列中的 1.0 Pro Fast 版本，面向低延迟与高可控的视频生成场景。本页基于 ToAPIs 官方文档整理参数边界与接入路径，便于从效果验证迁移到生产调用。

模型類型：
價格： 5.7 積分 /request
1

描述你的圖片

參考圖

描述你想生成的圖片。53 / 1200

進階選項

範例參數
2

你的生成結果

圖片結果會顯示在這裡

登入後可直接提交生成任務。

查看 API 文件取得 API Key

生成需要一些時間，請稍等您可以離開此頁面，[ 任務日誌 ] 可直接檢查生成的內容

請求預覽

{
  "model": "doubao-seedream-4-0",
  "prompt": "使用 doubao-seedream-4-0 生成一张高质感产品广告图，主体清晰，光线自然，适合社媒投放。",
  "size": "1:1",
  "n": 4,
  "metadata": {
    "resolution": "2K",
    "orientation": "square",
    "optimize_prompt_options": {
      "mode": "standard"
    },
    "watermark": false
  }
}

生成案例

探索 doubao-seedream-4-0 的生成效果

使用同款模型生成
doubao-seedream-4-0 guide example 1

doubao-seedream-4-0 #1

doubao-seedream-4-0 guide example 2

doubao-seedream-4-0 #2

doubao-seedream-4-0 guide example 3

doubao-seedream-4-0 #3

透明計價

doubao-seedream-4-0 pricing

Image usage is billed according to the current request and resolution rules. Final billing follows the current account quote.

儲值積分
5.7 積分 /request

為什麼選擇 ToAPIs

Why call doubao-seedream-4-0 through ToAPIs?

Keep image generation, API keys, billing, and usage management in one workflow.

双版本策略：速度与质量分层

同一接口可选择 doubao-seedance-1-0-pro-fast 或 quality，便于按业务时延目标切换。

首帧/尾帧/参考图精细控制

通过 image_urls 或 image_with_roles 控制视频起止画面与风格参考，提升镜头可控性。

标准化异步任务交付

返回 generation.task 对象并提供状态流转，适合接入队列与批处理工作流。

Connect in three steps

Create a key, send an image request, and review the generated result.

  1. 1

    Step 1

    准备 API Key，并在请求头设置 Authorization: Bearer <YOUR_API_KEY>。

  2. 2

    Step 2

    向 /v1/videos/generations 发送 POST，请求体传 model、prompt、duration、aspect_ratio、resolution。

  3. 3

    Step 3

    如需图像控制，选择 image_urls 或 image_with_roles（二选一）。

When to use doubao-seedream-4-0

Use case 1

需要在较短时延内完成短视频生成并快速迭代提示词。

Use case 2

需要通过首帧/尾帧或参考图增强镜头连续性与风格一致性。

Use case 3

需要标准化异步任务状态管理来接入服务端生产流程。

常見問題

doubao-seedream-4-0 FAQ

fast 和 quality 怎么选？

fast 适合快速预览与高频迭代；quality 适合对细节质量和画面稳定性要求更高的生产场景。

为什么我设置 1080p 失败？

使用 reference 角色图时不支持 1080p，请改为 720p 或调整图像控制方式。

首尾帧都能在 fast 里用吗？

不能。last_frame 仅 quality 版本支持，fast 版本不支持首尾帧同时使用。

图像视频模型报错：invalid apitype: -1

这类错误通常说明接口走错了。图像和视频模型一般不走 chat 接口，而是按对应文档发起 HTTP 任务请求，并通过任务状态接口轮询结果。排查时建议先看用户的实际请求代码、请求地址和请求体。

用户进行生成图片/视频的任务时出现任务失败，但是扣款

先让用户提供任务日志或截图，重点看是否出现了输入或输出 token 统计。如果有这类 token 记录，大概率是用户把图片/视频模型走成了 chat 接口；这不是正确用法。图片和视频模型通常是异步任务接口，需要通过 HTTP 请求先提交任务，再拿到任务 ID 轮询状态，详细以对应文档为准。

doubao-seedream-4-0 API

Start building with doubao-seedream-4-0

Test an image request here, then continue in the dashboard or API documentation.

Start for freeView API Docs

Try doubao-seedream-4-0 with one ToAPIs key.

Use one account and API surface for image generation workflows.

Sign up to get free credits