智信Token平台
  1. 视频(Videos)
  • 欢迎使用
  • Codex 配置
  • Claude Code 配置
  • 本地错误码说明
  • 模型(Models)
    • 列出模型
      • 原生OpenAI格式
      • 原生Gemini格式
  • 聊天(Chat)
    • 原生OpenAI格式
      • OpenAI聊天格式
      • Responses格式
      • Responses压缩格式
    • 原生Gemini格式
      • Gemini媒体识别
      • Gemini媒体识别
    • 原生Claude格式
      POST
  • 图像(Images)
    • 原生OpenAI格式
      • 生成图像
      • 编辑图像
    • Nano Banana
      • Gemini原生格式
      • Gemini原生格式
    • 通义千问OpenAI格式
      • 生成图像
      • 编辑图像
  • 视频(Videos)
    • 可灵模型参数说明
    • Seedance模型参数说明
    • HappyHorse参数说明
    • Seedance素材库
      • Seedance人像素材用户使用说明
      • 新建素材目录
      • 查询素材目录列表
      • 获取素材目录详情
      • 删除素材目录
      • 上传素材
      • 查询素材列表
      • 获取素材详情
      • 刷新素材状态
      • 删除素材
    • 创建视频生成任务
      POST
    • 获取视频生成任务状态
      GET
    • 视频生成任务回调通知
      POST
  • deepseek常见问题
    • 思考模式开关与思考强度控制
  • qwen系列模型常见问题
    • 上下文缓存
  • kimi系列模型常见问题
    • 模型参数参考
  • 用户
    • 获取个人资料
      GET
  • 日志
    • 获取使用日志
  • 数据模型
    • Schemas
    • Model
    • Usage
    • ModelsResponse
    • ErrorResponse
    • Message
    • MessageContent
    • Tool
    • ToolCall
    • GeminiModelsResponse
    • ChatCompletionResponse
    • ChatCompletionRequest
    • CompletionRequest
    • CompletionResponse
    • ResponseFormat
    • ResponsesRequest
    • ResponsesResponse
    • ClaudeRequest
    • ClaudeMessage
    • ClaudeResponse
    • EmbeddingRequest
    • EmbeddingResponse
    • ImageResponse
    • AudioTranscriptionResponse
    • SpeechRequest
    • RerankRequest
    • RerankResponse
    • VideoRequest
    • ModerationRequest
    • VideoResponse
    • ModerationResponse
    • VideoTaskResponse
    • GeminiRequest
    • VideoTaskMetadata
    • GeminiResponse
    • VideoTaskError
    • OpenAIVideoError
    • UserProfile
    • LogItem
    • Permissions
    • LogListResponse
    • VideoTaskQueryResponse
  1. 视频(Videos)

Seedance模型参数说明

豆包视频 API 调用说明#

基本请求#

本系统使用统一视频生成接口提交豆包 Seedance 视频任务:
提交成功后返回本系统任务 ID。任务为异步生成,可通过任务查询接口获取状态和视频地址:
OpenAI Video 兼容路径也可查询:

基本请求体#

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "一只小猫在窗边打哈欠,清晨阳光,电影感",
  "resolution": "720p",
  "duration": 5,
  "metadata": {
    "ratio": "16:9",
    "generate_audio": true,
    "watermark": false
  }
}

支持模型#

模型说明
doubao-seedance-2-0-260128Seedance 2.0,支持文生视频、图生视频、多模态参考生视频
doubao-seedance-2-0-fast-260128Seedance 2.0 fast,不支持 1080P

支持的通用字段#

字段类型说明
modelstring模型 ID,必填
promptstring文本提示词。适配器会写入 content 的 text 条目
imagestring单张输入图片 URL。适合首帧图生视频
imagesstring[]多张输入图片 URL。适合首尾帧或参考图
resolution / sizestring输出分辨率,支持 480p、720p、1080p
duration / secondsinteger / string视频时长,单位秒。推荐使用 duration
metadataobject方舟视频生成扩展参数,见下文

metadata 支持字段#

metadata 会被合并到方舟请求体中,可用于传入官方接口参数。
字段类型说明
contentobject[]完整覆盖或补充官方 content 数组,支持 text、image_url、video_url、audio_url、draft_task
service_tierstring服务等级,default / flex。Seedance 2.0 系列不支持修改
execution_expires_afterinteger任务超时阈值,单位秒
generate_audioboolean是否生成同步音频。Seedance 2.0 系列、Seedance 1.5 pro 支持
draftboolean是否开启样片模式。仅 Seedance 1.5 pro 支持
resolutionstring分辨率。也可放顶层,顶层优先用于统一计费参数识别
ratiostring宽高比,例如 16:9、9:16、adaptive
durationinteger视频时长。也可放顶层
framesinteger帧数。与 duration 二选一,具体支持以官方模型为准
seedinteger随机种子
camera_fixedboolean是否固定摄像头
watermarkboolean是否添加 AI 生成水印

content 写法#

适配器默认会根据 prompt、image、images 构造 content:
prompt 会转换为 {"type":"text","text":"..."}。
images 会转换为多个 {"type":"image_url","image_url":{"url":"..."}}。
如果需要传 role、视频、音频、样片任务 ID,请使用 metadata.content。

文本#

{
  "type": "text",
  "text": "一只小猫对着镜头打哈欠"
}

图片#

{
  "type": "image_url",
  "role": "first_frame",
  "image_url": {
    "url": "https://example.com/first.png"
  }
}
常见 role:
场景role
首帧图first_frame,也可不填
尾帧图last_frame
Seedance 2.0 参考图reference_image

视频#

仅 Seedance 2.0 系列支持视频输入。
{
  "type": "video_url",
  "role": "reference_video",
  "video_url": {
    "url": "https://example.com/reference.mp4"
  }
}

音频#

仅 Seedance 2.0 系列支持音频输入,且不可单独输入音频,至少需要 1 个参考图片或参考视频。
{
  "type": "audio_url",
  "role": "reference_audio",
  "audio_url": {
    "url": "https://example.com/reference.mp3"
  }
}

样片任务#

仅 Seedance 1.5 pro 支持。
{
  "type": "draft_task",
  "draft_task": {
    "id": "cgt-xxxx"
  }
}

常见调用示例#

1. 文生视频#

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠",
  "resolution": "720p",
  "duration": 5,
  "metadata": {
    "ratio": "16:9",
    "generate_audio": true
  }
}

2. 首帧图生视频#

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动,可以听到风声",
  "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png",
  "resolution": "720p",
  "duration": 5,
  "metadata": {
    "ratio": "9:16",
    "generate_audio": true
  }
}

3. 首尾帧图生视频#

需要为两张图片显式设置 role。
{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "从第一张图自然过渡到第二张图,镜头平滑移动",
  "resolution": "720p",
  "duration": 5,
  "metadata": {
    "content": [
      {
        "type": "image_url",
        "role": "first_frame",
        "image_url": {
          "url": "https://example.com/first.png"
        }
      },
      {
        "type": "image_url",
        "role": "last_frame",
        "image_url": {
          "url": "https://example.com/last.png"
        }
      },
      {
        "type": "text",
        "text": "从第一张图自然过渡到第二张图,镜头平滑移动"
      }
    ],
    "generate_audio": false
  }
}

4. 多模态参考生视频#

Seedance 2.0 系列支持参考图片、参考视频、参考音频组合。
{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "全程使用视频1的第一视角构图,全程使用音频1作为背景音乐。第一人称视角果茶宣传广告,seedance牌「苹苹安安」苹果果茶限定款;首帧为图片1,你的手摘下一颗带晨露的阿克苏红苹果,轻脆的苹果碰撞声;2-4 秒:快速切镜,你的手将苹果块投入雪克杯,加入冰块与茶底,用力摇晃,冰块碰撞声与摇晃声卡点轻快鼓点,背景音:「鲜切现摇」;4-6 秒:第一人称成品特写,分层果茶倒入透明杯,你的手轻挤奶盖在顶部铺展,在杯身贴上粉红包标,镜头拉近看奶盖与果茶的分层纹理;6-8 秒:第一人称手持举杯,你将图片2中的果茶举到镜头前(模拟递到观众面前的视角),杯身标签清晰可见,背景音「来一口鲜爽」,尾帧定格为图片2。背景声音统一为女生音色。",
  "resolution": "1080p",
  "duration": 15,
  "metadata": {
    "content": [
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg"
            },
            "role": "reference_image"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
            },
            "role": "reference_image"
        },
        {
          "type": "video_url",
          "video_url": {
              "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"
          },
          "role": "reference_video"
        },
        {
          "type": "audio_url",
          "audio_url": {
              "url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
          },
          "role": "reference_audio"
        }
    ],
    "generate_audio":true,
    "watermark": false
  }
}

查询任务#

返回的 status 会映射为本系统任务状态:
方舟状态本系统状态说明
queued / pendingQUEUED排队中
running / processingIN_PROGRESS运行中
succeededSUCCESS成功
failed / expired / cancelled / canceledFAILURE失败或过期
成功后可从返回数据中获取视频地址:
{
  "code": "success",
  "data": {
    "task_id": "task_xxx",
    "status": "SUCCESS",
    "result_url": "https://..."
  }
}
OpenAI Video 兼容查询会返回 metadata.url。

计费说明#

系统对豆包视频采用异步任务计费:
1.
提交任务时按请求参数预扣。
2.
查询到任务成功后,按上游返回的 usage.completion_tokens 重新计算实际费用。
3.
实际费用高于预扣时补扣;低于预扣时退回差额。
4.
任务失败、过期或取消时,按现有失败任务逻辑退回预扣额度。
预扣参数主要包括:
参数说明
duration / seconds时长倍率。Seedance 基础时长为 5 秒
resolution / size分辨率倍率
是否包含 video_url视频输入倍率。Seedance 2.0 系列有视频输入和无视频输入价格不同

当前内置预扣规则#

Seedance 2.0 系列的预扣价格:先用基础段价折算 estimated_tokens,再乘分辨率 token 单价倍率、视频输入倍率、时长倍率和分组倍率。也就是说,下表中的基础段价不是最终 token 单价,只用于提交阶段估算预扣量。
预扣公式:
基础额度 × estimated_tokens × resolution × video_input × duration × 分组倍率
其中:
estimated_tokens:基础段价 / 无视频输入 token 单价。
resolution:当前分辨率无视频输入 token 单价 / 480P 无视频输入 token 单价;倍率为 1 时不写入。
video_input:当前分辨率有视频输入 token 单价 / 当前分辨率无视频输入 token 单价;仅请求中包含 video_url 时写入。
duration:请求时长 / 5;基础 5 秒时不写入。
非 Seedance 2.0 token 结算模型保留固定段价倍率预扣。
基础段价,单位为基础时长 5 秒:
模型480P720P1080P
doubao-seedance-1-5-pro-2512150.801.733.89
doubao-seedance-2-0-2601282.314.9712.39
doubao-seedance-2-0-fast-2601281.864.00不支持
doubao-seedance-1-0-pro-2505282.314.9712.39
doubao-seedance-1-0-lite-t2v2.314.9712.39
doubao-seedance-1-0-lite-i2v2.314.9712.39

Seedance 2.0 实际 token 结算价#

完成后以查询接口返回的 usage.completion_tokens 为准。
若 completion_tokens 缺失,则使用 usage.total_tokens 兜底;视频生成模型输入 token 为 0,因此通常二者一致。
模型输入类型480P720P1080P
doubao-seedance-2-0-260128无视频输入464651
doubao-seedance-2-0-260128有视频输入282831
doubao-seedance-2-0-fast-260128无视频输入3737不支持
doubao-seedance-2-0-fast-260128有视频输入2222不支持

分辨率说明#

支持常见写法:
输入归一化
480p / 480P480P
720p / 720P720P
1080p / 1080P1080P
默认分辨率:
模型默认分辨率
Seedance 2.0 系列720p
注意:doubao-seedance-2-0-fast-260128 不支持 1080p。如果请求模型不支持的分辨率,上游可能返回参数错误,本系统不会自动降级计费。

注意事项#

metadata.content 会透传并参与构造上游 content,适合需要 role、视频、音频、样片任务等高级输入的场景。
如果同时传顶层 prompt 和 metadata.content 中的 text,适配器会保留 metadata.content 中的非 text 内容,并追加顶层 prompt 作为 text。
图片支持 URL、Base64、素材 ID;视频和音频要求以官方文档为准。
Seedance 2.0 系列的音频输入不可单独使用,必须至少包含 1 个参考图片或参考视频。
生成视频 URL 有有效期,请在查询成功后及时转存。
修改于 2026-07-27 00:40:27
上一页
可灵模型参数说明
下一页
HappyHorse参数说明
Built with