1. v2 接入说明
快跑科技
  • 默认模块
    • 引言
    • 目录
    • 常见问题
    • 从0开始使用Codex
    • API 快速开始指南
    • 快跑后台令牌创建
    • 网站使用
      • 操练场
      • 模型广场(选择模型和分组)
      • 令牌管理
      • 快跑画布使用教程
      • 快跑画布生成视频教程
    • 聊天与生图
      • ChatBox 移动端
      • Chatbox生图设置
      • Cherry Studio生图使用
    • Codex进阶
      • Codex 安装skill 使用图片模型生成图片
      • Codex 使用记忆功能恢复历史对话
    • CCSwitch配置(新手推荐 简单快速)
      • CCSwitch快速配置ChatGPT Codex
      • CCSwitch快速配置Claude
      • CCSwitch快速配置在Claude中使用GPT模型
      • CCSwitch配置DeepSeek在Claude中使用
      • CCSwitch配置Grok在Claude中使用
      • CCSwitch配置Grok在Codex中使用
      • CCSwitch配置DeepSeek在Codex中使用
    • OpenClaw / Hermes配置教程
      • OpenClaw配置ChatGPT教程
      • OpenClaw配置Claude教程
      • OpenClaw安装Skill教程
      • Hermes配置ChatGPT教程
    • WorkBuddy配置教程
      • WorkBuddy配置教程
    • 各种插件/软件使用教程
      • Codex 配置教程
      • Trae配置教程
      • OpenClaw Clawdbot 自定义中转站配置教程
      • N8N 工作流使用中转API 教程
      • opencode 配置教程
      • Gemini CLI 中转站配置使用教程
      • Claude Code 安装使用教程
      • CherryStudio调用cluade MCP
      • Cherry Studio配置教程
      • Cherry Studio配置 banana pro 4K和分辨率教程
      • CherryStudio配置o4推理级别
      • 扣子工作流简单配置从输入到获取url
      • dify添加模型
      • cline 配置教程
      • aider 配置教程
      • Cursor 免费版配置教程
      • Cursor 配置教程
      • lobechat 设置教程
      • ChatBox(推荐使用)
      • 开源gpt_academic
      • nextchat 设置教程
      • zotero gpt 配置方法
      • CLAUDE DEV 配置教程
      • 沉浸式翻译 设置gpt翻译
      • 浏览器插件ChatGPT Sidebar
      • chatgpt-on-wechat 配置教程
      • chatgpt GPT Academic 学术优化配置gpt教程
      • RikkaHub 配置教程
      • coze 工作流使用中转API 教程
      • n8n 工作流获取本地图片生成视频例子
      • OpenClaw 最新版本 自定义中转站配置教程
      • Codex更新后不显示新模型的解决方法
    • 图像API接入文档
      • 1. gpt-image-2 生成图像
      • 2. gpt-image-2-1k 生成图像
      • 3. gpt-image-2-1k 编辑图像
      • 4. Gemini 图像生成
    • 接口文档
      • 聊天(Chat)
        • ChatGpt 接口
          • ChatGPT音频(Audio)
            • GPT-4o-audio
            • 音频转文字 whisper-1
            • 音频转文字 gpt-4o-transcribe
            • 创建语音 gpt-4o-mini-tts
            • 创建翻译 (不支持)
          • ChatGPT聊天(Chat)
            • 聊天完成对象
            • 聊天完成块对象
            • 创建聊天补全 (流式)
            • 创建聊天补全 (非流)
            • 创建聊天识图 (流式)
            • 创建聊天识图 (流式) best64
            • 创建聊天识图 (非流)
            • 创建聊天创作图 (非流)
            • 官方Function calling调用
            • 官方N测试
            • 列出模型
            • 创建聊天函数调用
            • 创建结构化输出
            • 控制推理模型努力程度
            • 创建聊天补全 qwen-mt-turbo
            • 创建聊天补全 deepseek v3.1思考程度 (流式)
            • deepseek-ocr 识别
          • ChatGPT自动补全(Completions)
            • 完成对象
            • 创建完成
          • ChatGPT嵌入(Embeddings)
            • 嵌入对象
            • 创建嵌入
          • Web 搜索
            • web搜索
        • Anthropic Claude 接口
          • 聊天完成对象
          • 聊天完成块对象
          • 原生格式
            • 创建聊天补全 (流式)
            • 创建函数调用 (流式)
            • 创建格式化输出
            • 创建思考聊天
            • PDF支持
            • PDF支持 base64格式
            • 联网搜索
          • chat兼容格式
            • 创建思考聊天
            • 创建聊天补全 (流式)
            • 创建聊天补全 (非流)
            • 创建聊天识图 (流式)
            • 创建聊天识图 (非流)
        • 谷歌Gemini 接口
          • 原生格式
            • 文本生成
            • 文本生成-流
            • 文本生成+思考-流
            • 图片生成
            • 图片生成 gemini-2.5-flash-image
            • 图片生成 gemini-2.5-flash-image 控制宽高比
            • 图片生成 gemini-3-pro-image-preview 控制宽高比 +清晰度
            • 图片编辑
            • 图片理解
            • 格式化输出
            • 函数调用
            • 文档理解
            • URL context [原生格式]
            • 代码执行
            • google search
            • 视频理解
            • URL context
            • 音频理解
            • Embeddings
            • TTS 文本转语音
            • 文本生成 gemini-3-pro-preview:generateContent
            • Imagen 生成图片
            • gemini-tts文本转语音
            • 文本嵌入
          • chat兼容格式
            • gemini图片创作接口 [chat兼容格式]
            • 聊天接口 [chat兼容格式]
            • 聊天接口-思考1 [chat兼容格式]
            • 聊天接口-思考2 [chat兼容格式]
            • 识图接口 [chat兼容格式]
            • 聊天+读取文件接口 [chat兼容格式]
            • 文本嵌入 [chat兼容格式]
      • 聊天(Responses)
        • Responses API与Chat API对比
        • 创建模型响应
        • 创建函数调用
        • 创建模型响应(流式返回)
        • 创建模型响应 (控制思考长度)
        • 创建网络搜索
        • 创建模型响应 gpt-5启用思考
        • 创建函数调用 Copy
      • 生图
        • API接口调用
    • Python配置方式
      • python 使用 语音转文本
      • python 使用文本转语音
      • python 使用Embeddings 向量化
      • python 调用DALL·E
      • python简单调用 openai function-calling demo
      • python 简单langchain 调用openai demo
      • python llama_index 配置
      • Python基础对话
      • Python使用gpt-4o识别图片-本地图片
      • Python使用gpt-4o识别图片
      • Python使用Claude识别图片
      • python 库流式输出
      • gpt realtime模型调用
      • python request 请求 流式输出demo
      • python 使用gpt-image-1 创建编辑图片
      • python openai官方库(使用AutoGPT,langchain等)
      • python 连续对话
    • nodejs 配置方式
      • nodejs 基础对话
    • 帮助中心
      • AI返回字段: 思考相关
      • HTTP状态码及其含义
      • 联系我们
    • 数据模型
      • ImageGenerationRequest
      • AsyncImageGenerationRequest
      • ImageGenerationResponse
      • ImageResult
      • AsyncImageTask
      • GeminiGenerateContentRequest
      • GeminiContent
      • GeminiPart
      • GeminiInlineData
      • GeminiGenerationConfig
      • GeminiImageConfig
      • GeminiGenerateContentResponse
      • GeminiCandidate
      • ErrorObject
      • ErrorResponse
      • GptImage1GenerationRequest
      • GptImage1EditRequest
      • GptImage1EditMultipartRequest
      • GptImage1EditJsonRequest
  • 视频接入文档
    • Seedance视频接入文档
      • 1. 创建视频生成任务
      • 2. 查询视频生成任务
      • 3. 完整演示代码
    • Grok视频接入文档
      • 1. 创建视频生成任务
      • 2. 查询视频生成任务
      • 3. 完整演示代码
  • 图像与视频统一接入文档v2
    • v2 接入说明
      • 0. 接入须知(先看这里)
        GET
      • 1. 视频模型能力表
        GET
      • 2. 图像模型能力表
        GET
      • 3. 错误码
        GET
      • 4. 从 v1 迁移
        GET
    • v2 视频生成
      • 1. 创建视频任务
      • 2. 查询视频任务
      • 3. 下载视频文件
      • 4. 视频完整示例代码
    • v2 图像生成
      • 1. 文生图
      • 2. 图生图 / 多图参考 / 局部重绘
      • 3. 图像完整示例代码
    • 数据模型
      • ImageInputReference
      • CreateVideoRequest
      • CreateVideoMultipartRequest
      • VideoError
      • Video
      • CreateImageRequest
      • EditImageJsonRequest
      • EditImageMultipartRequest
      • ImageData
      • ImageUsage
      • ImagesResponse
      • ErrorObject
      • ErrorResponse
  1. v2 接入说明

1. 视频模型能力表

GET
/docs/v2/video-models
本条目只用于在 Apifox 中展示说明,不对应线上接口,无需请求。
下表列出 v2 视频接口支持的模型和能力,实际可用模型以控制台「模型广场」为准。表中没有列出的字段,对应模型不支持,传了会返回 400。

1. 支持的生成方式#

模型文生视频首帧 input_reference尾帧 last_frame参考图 reference_images参考视频 reference_videos参考音频 reference_audiosgenerate_audiowatermarkseed
doubao-seedance-2.0-480p / doubao-seedance-2.0-720p / doubao-seedance-2.0-1080p✅✅✅✅ 最多 9 张✅ 最多 3 个✅ 最多 3 个✅ 默认 true✅ 默认 false✅
doubao-seedance-2.0-fast-480p / doubao-seedance-2.0-fast-720p✅✅✅✅ 最多 9 张✅ 最多 3 个✅ 最多 3 个✅ 默认 true✅ 默认 false✅
doubao-seedance-2.0-mini-480p / doubao-seedance-2.0-mini-720p✅✅✅❌❌❌❌❌❌
doubao-seedance-2.0-480p-特价 / doubao-seedance-2.0-720p-特价 / doubao-seedance-2.0-1080p-特价✅❌❌✅ 最多 9 张✅ 最多 3 个✅ 最多 3 个❌❌❌
组合规则:
首帧 / 首尾帧 与 参考素材(参考图、参考视频、参考音频)不能在同一个请求里混用;last_frame 必须和 input_reference 一起传;参考音频必须和参考图或参考视频一起使用。
特价线路的参考素材只接受公网链接(上传的文件与 data URL 会先由平台转存成链接)。
表外的视频模型暂不支持 v2 接口(返回 unsupported_model),请继续使用 v1 接口,目前包括:不带清晰度后缀的 doubao-seedance-2.0-mini、doubao-seedance-2.0-特价,以及 doubao-seedance-2.5 系列。
视频生视频(编辑视频、延长视频、参考动作或运镜)统一用 reference_videos,在提示词里说明要怎么用,例如「把视频1里的人物换成图片1里的人物」「接着视频1继续往后拍」。

2. 时长、清晰度、宽高比#

模型seconds(默认值)resolution(默认值)aspect_ratio 可选值
标准版、fast 版、特价线路4–15 的整数(5)由模型名固定:480p / 720p / 1080p16:9、9:16、1:1、4:3、3:4、21:9、adaptive
mini 版4–11 的整数(5)由模型名固定:480p / 720p16:9、9:16、1:1、4:3、3:4、21:9、adaptive、keep_ratio
aspect_ratio 默认值:有首帧或参考图、参考视频时为 adaptive(按素材自动选最接近的比例),否则为 16:9。
模型名带 -480p / -720p / -1080p 的,清晰度已由模型名固定,resolution 可以不传;传了与模型名不一致的值(或 size 换算出的档位不一致)会返回 400。

3. size(宽x高)与清晰度、宽高比的对应#

按下表换算,表外的尺寸按最接近的宽高比和档位处理(档位必须与模型名一致):
resolution16:94:31:13:49:1621:9
480p864x496752x560640x640560x752496x864992x432
720p1280x7201112x834960x960834x1112720x12801470x630
1080p1920x10801664x12481440x14401248x16641080x19202206x946

4. 参考素材要求#

素材数量单个大小时长其他要求
首帧、尾帧、参考图参考图最多 9 张≤ 30MB—jpg / png / webp;宽高比 0.4–2.5
参考视频最多 3 个≤ 50MB单个 2–15 秒,合计 ≤ 15 秒mp4 / mov,H.264 / H.265,24–60 FPS;宽和高均在 300–6000 像素之间,宽高比 0.4–2.5;总像素在 640×640 到 2206×946 之间
参考音频最多 3 个≤ 15MB单个 2–15 秒,合计 ≤ 15 秒必须和参考图或参考视频一起使用
提示词里可以按传入顺序引用素材:图片1、图片2……,视频1……,音频1……。
平台只校验素材类型(图片 / 视频 / 音频)和大小;格式、时长、分辨率、宽高比等要求由模型服务校验,不符合时创建任务返回 upstream_rejected,或任务失败(generation_failed),原因见 message。
参考视频、参考音频建议直接传公网链接;上传文件或 data URL 时由平台临时转存,转存不可用时返回 invalid_media,请改用公网链接。
素材中含有真实人脸时,可能被内容安全策略拦截导致任务失败。

请求参数

无

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/docs/v2/video-models'

返回响应

🟢200
application/json
文档说明,无需请求
Bodyapplication/json

示例
{}
修改于 2026-09-30 13:54:50
上一页
0. 接入须知(先看这里)
下一页
2. 图像模型能力表
Built with