1. Seedance 系列
Onemini NewAPI
  • 视频生成模型
    • Seedance 系列
      • 创建 Seedance 视频生成任务
        POST
      • 查询 Seedance 视频任务
        GET
      • 下载 Seedance 生成视频
        GET
    • Seedance 系列（兼容接口）
      • 创建 Seedance 视频任务（兼容接口）
      • 查询 Seedance 视频任务（兼容格式）
  • 模型与鉴权
    • 查询可用模型
      GET
  • 文本聊天模型
    • OpenAI 兼容
      • 创建聊天补全
    • Gemini 原生
      • Gemini 原生流式内容生成
    • OpenAI Responses
      • 创建 Responses 响应
  • 图片生成模型
    • Gemini 原生（文本与图片）
      • Gemini 原生内容生成
    • OpenAI gpt-image系列
    • 统一 JSON 路由
    • Seedream
      • Seedream 图片生成与编辑
    • OpenAI gpt-image-2
      • gpt-image-2 图片生成
      • 编辑 OpenAI 图片
  • 数据模型
    • SeedanceVideoRequest
    • ModelListResponse
    • SeedanceMetadata
    • ModelObject
    • SeedanceContentItem
    • ChatCompletionRequest
    • MediaUrl
    • ChatMessage
    • VideoTask
    • ChatContentPart
    • VideoTaskError
    • ChatCompletionResponse
    • LegacyTaskResponse
    • ChatCompletionChoice
    • ApiError
    • TokenUsage
    • ResponsesCreateRequest
    • ResponsesInputItem
    • ResponsesInputContentPart
    • ResponsesReasoning
    • ResponsesCreateResponse
    • ResponsesOutputItem
    • ResponsesOutputContent
    • ResponsesUsage
    • GeminiGenerateContentRequest
    • GeminiContent
    • GeminiPart
    • GeminiInlineData
    • GeminiGenerationConfig
    • GeminiGenerateContentResponse
    • GeminiUsageMetadata
    • ImageGenerationRequest
    • ImageEditRequest
    • ImageGenerationResponse
    • ImageGenerationStreamEvent
    • ImageData
    • OneminiApiError
  1. Seedance 系列

创建 Seedance 视频生成任务

POST
/v1/videos
创建异步视频生成任务。

鉴权要求#

所有请求都必须携带 Authorization: Bearer <ONEMINI_API_KEY>。公开示例中的变量名只是占位符，不包含真实 API Key。

调用流程与防重复提交#

1.
使用本接口提交任务。
2.
创建成功后立即保存响应中的 id，该值也是 task_id。
3.
每隔约 10 秒调用 GET /v1/videos/{task_id}。
4.
当 status=completed 时，从 metadata.url 获取视频地址，或调用 /v1/videos/{task_id}/content 下载。
5.
当 status=failed 时读取 error.code 和 error.message。

图生视频素材角色#

单张首帧可使用顶层 images；多张主体、产品或场景参考图使用 metadata.content，并将每一项的 role 设置为 reference_image。
Base64 图片必须提供完整 Data URI，例如 data:image/jpeg;base64,<BASE64_DATA>，不能只传裸 Base64。
reference_image 不得与 first_frame 或 last_frame 混用；需要多张参考图时应全部使用 reference_image。
metadata.content 中的图片必须同时填写 type=image_url、image_url.url 和 role=reference_image。

已验证成功案例#

已验证 doubao-seedance-2-0-fast-260128 可以使用 3 张 Base64 reference_image 创建 15 秒、720p、9:16、带音频且无水印的视频。实测任务约 227 秒完成，结果视频为 H.264、720 × 1280、15.104 秒，并包含双声道 AAC 音轨。该结果只说明这一组参数已经成功运行，不代表所有模型都支持相同组合。完整无密钥请求见“已验证：三张参考图产品视频”示例。

按 token 计费#

任务成功后按实际 completion_tokens 计费：
基础费用（CNY） = completion_tokens / 1,000,000 × 对应基础单价
最终费用（CNY） = completion_tokens / 1,000,000 × 对应基础单价 × 实际分组倍率
seconds 只指定生成时长，不直接代表最终金额。例如分组倍率是 1.2，Seedance 2.0 生成 720p 视频、不含参考视频，实际产生 100,000 completion_tokens：100,000 / 1,000,000 × 46.00 × 1.2 = 5.52 CNY。顶层 images、first_frame、last_frame 和 reference_image 都属于图片输入，不等于 reference_video，计费时使用“不含参考视频”档位。统一查询和兼容查询中的 usage 都可能缺失或为 null；这不代表用量为 0，也不代表没有计费，此时以账户消费日志为准。

Seedance 2.0 基础价格#

输出分辨率不含参考视频（CNY / 1M tokens）含参考视频（CNY / 1M tokens）
480p / 720p46.0028.00
1080p51.0031.00
4K26.0016.00

Seedance 2.0 Fast 基础价格#

输入类型基础单价（CNY / 1M tokens）
不含参考视频37.00
含参考视频22.00
Fast 当前仅按是否含参考视频区分基础价格，不按分辨率设置独立价格。使用一张或多张图片作为 reference_image 时仍属于“不含参考视频”。

Seedance 1.5 Pro 基础价格#

计费项基础单价（CNY / 1M tokens）
生成视频 completion_tokens16.00
1.5 Pro 当前使用固定生成 token 基础单价，分辨率不单独计价。图片参考不属于参考视频，按“不含参考视频”档位计费。
具体计费请折算请求时实际生效的分组倍率。

文生视频 cURL#

请求参数

Body 参数application/json必填

示例
{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "一只金色柯基在樱花树下奔跑，花瓣随风飘落，电影感慢镜头",
    "seconds": "5",
    "metadata": {
        "resolution": "720p",
        "ratio": "16:9",
        "generate_audio": false,
        "watermark": false
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location '/v1/videos' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "一只金色柯基在樱花树下奔跑，花瓣随风飘落，电影感慢镜头",
    "seconds": "5",
    "metadata": {
        "resolution": "720p",
        "ratio": "16:9",
        "generate_audio": false,
        "watermark": false
    }
}'

返回响应

🟢200成功
application/json
任务创建成功。保存 id，后续查询必须使用该公开任务 ID。
Bodyapplication/json

示例
{
    "id": "task_01k2example",
    "task_id": "task_01k2example",
    "object": "video",
    "model": "doubao-seedance-2-0-260128",
    "status": "queued",
    "progress": 0,
    "created_at": 1786400000
}
🟠400请求有误
🟠401没有权限
🟠429
🔴500服务器错误
修改于 2026-08-11 10:04:01
下一页
查询 Seedance 视频任务
Built with