APIPro
网站首页
网站首页
  1. 视频
  • (必读)使用说明
  • FAQ
  • 获取模型列表
    • Models(获取模型列表)
      GET
  • OpenAI 接口 (兼容各大原厂模型)
    • OpenAI SDK使用指南
    • Responses API 接口使用指南
    • 对话
      • 聊天(chat)
      • 流式返回(chat)
      • 思考模式(chat)
      • 结构化输出(chat)
      • 工具调用(chat)
      • MCP调用(chat)
      • web search(chat)
      • 聊天(responses)
      • 流式返回(responses)
      • 思考模式(responses)
      • web search(responses)
    • 图像
      • 必读: 生图模型相关说明
      • 文生图(chat)
      • 图生图(chat)
      • 分析图片(chat)
      • 文生图(images)
      • 图生图(images)
    • 视频
      • 视频URL:https://api.apipro.ai
      • seedance官转资源接口文档
      • 提交视频任务 (veo)
        POST
      • 提交视频任务 (seedance官转)
        POST
      • 提交视频任务 (seedance封装)
        POST
      • 提交视频任务 (可灵)
        POST
      • 提交视频任务 (万相)
        POST
      • 提交视频任务 (grok)
        POST
      • 查询视频状态
        GET
    • 语音
      • 语音回复(chat)
      • 语音识别(audio)
      • 语音合成(audio)
    • 文本向量处理
      • 文本重排序
      • 文本向量化
    • 音乐(suno接口)
      • 生成歌词lyrics接口
      • 生成音乐suno接口
      • 上传音乐接口
      • 歌曲拼接接口
      • 查询歌词/音乐任务
  • Anthropic 接口
    • Anthropic SDK使用指南
    • 聊天
      POST
    • 聊天(prompt cache)
      POST
    • 流式返回
      POST
    • 聊天(思考)
      POST
    • 工具调用(function call)
      POST
    • 分析图片
      POST
  • Gemini 接口
    • Gemini SDK使用指南
    • 聊天
    • 流式返回
    • 联网搜索
    • 文生图
    • 图生图(传file)
    • 图生图(传url)
    • 分析图片(传base64)
    • 分析图片(传url)
    • 音乐生成
  • Midjourney 接口
    • 接口使用示例 (局部重绘)
    • 任务查询接口
    • 获取种子(Seed)
    • 文生图(Imagine)
    • 图片融合(Blend)
    • 图生文(Describe)
    • 换脸(FaceSwap)
    • 上传(upload)
    • 任务批量查询接口
    • 按钮点击(Action)
    • 窗口执行(Modal)
    • 刷新链接(Refresh)
    • 编辑图片(Edit)
  • 第三方接入
    • OpenClaw接入APIPro
  • 平台接口
    • 余额查询接口
    • 日志查询接口
    • 费用汇总接口
    • 费用明细接口
  • 数据模型
    • 示例数据模型
      • Pet
      • Category
      • Tag
  1. 视频

seedance官转资源接口文档

Volcengine Seedance 视频生成任务与素材库#

接口说明#

视频任务路径与请求 / 响应形态对齐火山方舟 Seedance 任务 API。
Base URL:
https://api.apipro.ai
视频任务路径相对该 Base URL 与火山原厂一致;素材库使用下方的固定入口:
方法路径说明
POST/v1/video/generations创建视频生成任务
GET/v1/video/generations/{video_task_id}查询任务
POST/volcark/?Action={Action}&Version=2024-01-01素材组、素材和真人认证
说明:
使用平台创建的 API Key 鉴权。
创建成功返回的id是后续查询时使用的任务 ID。
视频参数(比如resolution,duration...)需要通过payload中的metadata结构体传递。

请求头#

Header必填示例值说明
Authorization是Bearer sk-xxxxx平台 API Key
Content-TypePOST 必填application/json请求体必须是 JSON object

创建任务#

完整 URL 示例(Base URL + 路径):
https://api.apipro.ai/v1/video/generations

请求参数#

字段类型必填说明
modelstring是模型名,例如doubao-seedance-2.0
promptstring是提示词
metadatajson是视频参数,如:content, resolution, ratio, duration
说明:

创建请求示例:文生视频#

{
        "prompt": "使用视频1的第一视角构图,生成一个卡通的动画片,最后以图片1作为结尾",
        "model": "doubao-seedance-2.0",      
        "metadata": {
            "resolution": "480p",
            "ratio": "9:16",
            "duration": 6,
            "seed": 11,
            "camera_fixed": False,
            "watermark": False,
            "content": [
                {
                    "type": "video_url",
                    "video_url": {"url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"},
                    "role": "reference_video"              
                },
                {
                    "type": "image_url",
                    "image_url": {"url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg"},
                    "role": "reference_image",               
                }
            ]            
        }       
    }

创建成功响应#

HTTP 状态码:200
{
  "id": "tsk\_1234567890abcdef"
}
字段说明:
字段类型说明
idstring任务 ID。后续查询、取消 / 删除和 draft 引用都使用该 ID

查询任务#

普通成功响应#

{
  "id": "tsk\_1234567890abcdef",
  "model": "doubao-seedance-2.0",
  "status": "succeeded",
  "content": \[
    {
      "type": "video",
      "video\_url": "https://example.com/video.mp4"
    }
  ],
  "usage": {
    "completion\_tokens": 42,
    "total\_tokens": 42
  }
}
响应规则:
顶层id为创建任务时返回的任务 ID。
顶层model为业务方请求的 平台 模型名。

状态值#

status说明
creating创建中
submitted已提交
pending排队中(兼容状态)
queued排队中
running生成中
processing处理中
succeeded已完成
success已完成(兼容状态)
failed失败
failure失败(兼容状态)
cancelled已取消
expired已过期
其他字符串原值透传,不参与状态迁移

素材库#

素材库用于管理可供 Seedance 使用的图像、视频和音频素材。所有素材库 Action 均使用同一个入口:
完整 URL 示例:
https://api.apipro.ai/volcark/?Action=CreateAssetGroup&Version=2024-01-01

支持的 Action#

类别Action说明
素材组CreateAssetGroup创建素材组
素材组ListAssetGroups分页查询素材组
素材组GetAssetGroup查询素材组
素材组UpdateAssetGroup更新素材组名称或描述
素材组DeleteAssetGroup删除素材组及其素材
素材CreateAsset向素材组上传图像、视频或音频素材
素材ListAssets分页查询素材
素材GetAsset查询素材及其预处理状态
素材UpdateAsset更新素材名称
素材DeleteAsset删除素材
真人认证CreateVisualValidateSession创建真人认证 H5 会话
真人认证GetVisualValidateResult获取认证产生的素材组 ID 或当前认证结果
各 Action 的请求参数、响应字段、上传格式和限制见火山引擎素材库 API 文档。

素材上传并用于 Seedance#

推荐按以下顺序调用:
CreateAssetGroup -> CreateAsset -> GetAsset (轮询至 Active) -> 创建 Seedance 任务
创建素材组示例:
{
  "Name": "virtual-host",
  "Description": "虚拟主持人素材",
  "GroupType": "AIGC"
}
创建图像素材示例。GroupId使用CreateAssetGroup返回的素材组 ID,URL必须是可公开访问的素材 URL:
{
  "GroupId": "<asset\_group\_id>",
  "URL": "https://example.com/virtual-host.png",
  "AssetType": "Image",
  "Name": "正面全身照"
}
CreateAsset成功只表示素材已提交预处理。调用GetAsset,确认Result.Status为Active后,才能在视频创建请求的content中引用它;Processing应继续轮询,Failed时读取Result.Error排障。
{
  "model": "doubao-seedance-2.0",
  "content": \[
    {
      "type": "text",
      "text": "图片 1 中的虚拟主持人面向镜头介绍产品。"
    },
    {
      "type": "image\_url",
      "role": "reference\_image",
      "image\_url": {
        "url": "asset://<asset\_id>"
      }
    }
  ],
  "duration": 5,
  "ratio": "16:9"
}
业务方在视频请求中使用asset://<素材 ID>。文本提示词按同类型素材在content中的顺序引用,例如“图片 1”“视频 1”或“音频 1”,不要直接写素材 ID。

真人认证#

CreateVisualValidateSession的CallbackURL是业务方接收认证结果的 URL,可空。
GetVisualValidateResult以BytedToken查询认证结果。认证完成时,响应Result.GroupId为素材组 ID;认证尚未完成、失败或过期时,Result.Error.Code分别为NotReady、Failed或Expired。

错误码#

错误响应结构见错误响应格式与错误码。

常见错误#

HTTPerror.typeerror.code场景
400invalid\_request\_errorinvalid\_request\_bodyJSON 非法、缺少model,或缺少合法content
400invalid\_request\_errorcallback\_url\_invalidcallback\_urlURL 语法非法、缺 scheme/host 或含 userinfo
400invalid\_request\_errorcallback\_url\_too\_longcallback\_url超过长度限制
400invalid\_request\_errorcallback\_url\_scheme\_forbiddencallback\_urlscheme 不被允许
400invalid\_request\_errorcallback\_url\_private\_ipcallback\_url裸 IP 命中私网 / 回环 / 链路本地地址
503service\_unavailablemodel\_route\_unavailable提交前标准选路没有可执行openai\_videos/unary渠道,或 route binding 无法提供可用候选;响应可能包含既有reason\_codes
500internal\_errorinternal\_error提交前 selector 内部错误或已验证路由快照不合法
404not\_foundtask\_not\_foundtask 不存在或不属于当前调用方
409upstream\_errorupstream\_error当前任务状态不允许取消 / 删除
502proxy\_errorupstream\_body\_malformed生成服务响应格式异常,或任务状态无法识别
4xx/5xxupstream\_errorupstream\_error生成服务返回错误;响应头X-平台-Error-Source: upstream

素材库错误码#

HTTPerror.code场景
400invalid\_assets\_action缺少或不支持的Action
403capability\_disabled当前应用未开通素材库能力
403assets\_channel\_disabled素材库能力未启用
403assets\_visual\_validate\_disabled当前应用未开通真人认证能力
404asset\_group\_not\_found素材组不存在或不可访问
404asset\_not\_found素材不存在或不可访问
503assets\_route\_unavailable素材库服务暂不可用
4xx/5xxupstream\_error素材库服务返回错误

#

修改于 2026-11-16 09:04:03
上一页
视频URL:https://api.apipro.ai
下一页
提交视频任务 (veo)
Built with