智信Token平台
    • 欢迎使用
    • 豆包模型参数说明
    • 模型(Models)
      • 列出模型
        • 原生OpenAI格式
        • 原生Gemini格式
    • 聊天(Chat)
      • 原生OpenAI格式
        • ChatCompletions格式
        • Responses格式
      • 原生Gemini格式
        • Gemini文本聊天
        • Gemini媒体识别
      • 原生Claude格式
        POST
    • 图像(Images)
      • 原生OpenAI格式
        • 生成图像
        • 编辑图像
      • 通义千问格式
        • 生成图像
        • 编辑图像
      • Nano Banana
        • Gemini原生格式
        • OpenAI聊天格式
    • 视频(Videos)
      • 可灵模型参数说明
      • Sora格式
        • 创建视频
        • 获取视频任务状态
        • 获取视频内容
      • 可灵格式
        • Kling 文生视频
        • 获取 Kling 文生视频任务状态
        • Kling 图生视频
        • 获取 Kling 图生视频任务状态
      • 即梦格式
        • 即梦视频生成
      • 创建视频生成任务
        POST
      • 获取视频生成任务状态
        GET
    • 嵌入(Embeddings)
      • 原生OpenAI格式
        POST
      • 原生Gemini格式
        POST
    • 补全(Completions)
      • 原生OpenAI格式
        POST
    • 音频(Audio)
      • 原生OpenAI格式
        • 音频转录
        • 音频翻译
        • 文本转语音
      • 原生Gemini格式
        POST
    • 实时语音(Realtime)
      • 原生OpenAI格式
        GET
    • 重排序(Rerank)
      • 文档重排序
    • 审查(Moderations)
      • 原生OpenAI格式
    • 未实现(Unimplemented)
      • 微调(Fine-tuning)
        • 列出微调任务 (未实现)
        • 创建微调任务 (未实现)
        • 获取微调任务详情 (未实现)
        • 取消微调任务 (未实现)
        • 获取微调任务事件 (未实现)
      • 文件(Files)
        • 列出文件 (未实现)
        • 上传文件 (未实现)
        • 获取文件信息 (未实现)
        • 删除文件 (未实现)
        • 获取文件内容 (未实现)
    • 数据模型
      • 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
        • VideoTaskError
        • GeminiResponse
        • OpenAIVideoError

    豆包模型参数说明

    豆包视频 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
    callback_urlstring任务状态变化回调地址
    return_last_frameboolean是否在查询结果中返回尾帧图片
    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://example.com/first.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",
      "resolution": "1080p",
      "duration": 5,
      "metadata": {
        "content": [
          {
            "type": "image_url",
            "role": "reference_image",
            "image_url": {
              "url": "https://example.com/reference.png"
            }
          },
          {
            "type": "video_url",
            "role": "reference_video",
            "video_url": {
              "url": "https://example.com/reference.mp4"
            }
          },
          {
            "type": "text",
            "text": "参考素材中的主体动作,生成同风格视频"
          }
        ],
        "generate_audio": true
      }
    }

    查询任务#

    返回的 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-05-21 09:16:44
    上一页
    欢迎使用
    下一页
    原生OpenAI格式
    Built with