Seedance2.0 视频接口接入文档

基础信息

Base URL：

https://api.pinniq.org

所有接口均使用 Bearer Token 鉴权：

除视频内容下载接口外，请求体和响应体均为 JSON。

1. 查询模型

接口

cURL

支持的视频模型

videos-mini
videos-fast
videos-standard

模型列表响应示例：

{
  "object": "list",
  "data": [
    {
      "id": "videos-standard",
      "object": "model",
      "owned_by": "video-api"
    },
    {
      "id": "videos-fast",
      "object": "model",
      "owned_by": "video-api"
    },
    {
      "id": "videos-mini",
      "object": "model",
      "owned_by": "video-api"
    }
  ]
}

2. 创建视频任务

接口

Content-Type

请求字段

字段	类型	必填	说明
`model`	string	是	`videos-mini`、`videos-fast`、`videos-standard`
`prompt`	string	是	视频生成提示词
`duration`	integer	否	视频时长，4～15 秒
`ratio`	string	否	`16:9`、`9:16`、`1:1`，默认 `16:9`
`resolution`	string	是	视频分辨率，不同模型支持范围不同
`referenceImages`	string[]	否	参考图片 URL，最多9张，仅支持公开 HTTP/HTTPS 地址
`referenceVideos`	string[]	否	参考视频 URL，最多3个，总时长不超过15秒
`referenceAudios`	string[]	否	参考音频 URL，最多3个，总时长不超过15秒

分辨率支持范围

模型	支持的分辨率
`videos-mini`	`480p`、`720p`
`videos-fast`	`480p`、`720p`
`videos-standard`	`480p`、`720p`、`1080p`、`4k`

暂不支持的字段

{
  "first_image": "https://example.com/first.jpg",
  "last_image": "https://example.com/last.jpg"
}

传入不支持的首尾帧字段时，接口可能返回参数不支持错误。

纯文本生成示例

图片和音频参考示例

创建成功响应

FriModel 会返回平台生成的公开任务 ID。客户端不会收到上游任务 ID。

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "videos-mini",
  "status": "queued",
  "progress": 20,
  "created_at": 1783802860,
  "seconds": "5"
}

请保存响应中的 task_id，后续使用该 ID 查询状态和下载视频。

3. 查询视频任务

接口

其中 {task_id} 必须使用创建接口返回的 FriModel 平台任务 ID，例如：

task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

cURL

任务状态

状态	说明
`queued`	任务已进入队列
`in_progress`	视频正在生成
`completed`	视频生成完成
`failed`	视频生成失败
`unknown`	尚未取得有效任务状态

建议每隔5～10秒查询一次。

生成中响应

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "videos-mini",
  "status": "in_progress",
  "progress": 47,
  "created_at": 1783802860,
  "seconds": "5"
}

完成响应

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "videos-mini",
  "status": "completed",
  "progress": 100,
  "created_at": 1783802860,
  "completed_at": 1783802989,
  "seconds": "5",
  "url": "https://api.pinniq.org/v1/videos/task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/content",
  "video_url": "https://api.pinniq.org/v1/videos/task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/content",
  "metadata": {
    "url": "https://api.pinniq.org/v1/videos/task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/content"
  }
}

响应中的视频地址均为 FriModel 平台代理地址，不会返回上游视频 URL。

4. 下载视频内容

接口

cURL

分段下载

视频内容接口支持 HTTP Range 请求：

响应说明

任务完成后，接口通常返回：

使用 Range 请求时通常返回：

注意事项：

任务必须处于 completed 状态。

下载接口需要携带 API Key。

客户端只会访问 api.pinniq.org。

上游跳转地址和真实存储地址不会返回给客户端。

支持视频播放、完整下载及断点续传。

5. 失败响应

当任务生成失败时，查询接口会返回：

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "videos-mini",
  "status": "failed",
  "progress": 100,
  "created_at": 1783802860,
  "completed_at": 1783802989,
  "seconds": "5",
  "error": {
    "message": "视频生成失败，请调整提示词或素材后重试。",
    "code": "task_failed"
  }
}

失败任务不会返回视频下载地址。

常见错误码

错误码	说明
`invalid_request`	请求参数不正确
`invalid_seconds`	视频时长不符合要求
`invalid_resolution`	当前模型不支持指定分辨率
`unsupported_operation`	当前模型不支持此操作
`unsupported_material`	素材格式不支持
`material_policy_violation`	图片或素材未通过审核
`content_policy_violation`	提示词或生成内容未通过审核
`material_limit_exceeded`	素材大小、数量或时长超限
`upload_failed`	素材上传失败
`download_failed`	素材或结果下载失败
`generation_failed`	视频生成失败
`generation_timeout`	视频生成超时
`upstream_network_error`	视频服务暂时不可用
`task_failed`	视频任务执行失败
`server_error`	平台内部错误

6. 素材要求

图片

必须是公网可访问的 HTTP/HTTPS URL。

最多9张。

单个文件建议不超过20MB。

建议使用 JPG、PNG 或 WEBP。

避免使用需要登录、带防盗链或即将过期的签名地址。

视频

必须是公网可访问的 HTTP/HTTPS URL。

最多3个。

总时长不超过15秒。

总大小建议不超过200MB。

音频

必须是公网可访问的 HTTP/HTTPS URL。

最多3个。

总时长不超过15秒。

总大小建议不超过50MB。

推荐使用 MP3 或 WAV。

不建议使用 OGG，部分素材组合可能返回媒体类型错误。

7. 完整调用流程

调用 POST /v1/videos 创建视频任务。

保存响应中的 task_id。

每隔5～10秒调用 GET /v1/videos/{task_id}。

当 status 为 completed 时，读取 video_url 或 metadata.url。

携带 API Key 请求 /v1/videos/{task_id}/content 下载视频。

当 status 为 failed 时，读取 error.code 和 error.message。

Seedance 2.0 视频接入指南

Seedance2.0 视频接口接入文档

基础信息

1. 查询模型

接口

cURL

支持的视频模型

2. 创建视频任务

接口

Content-Type

请求字段

分辨率支持范围

暂不支持的字段

纯文本生成示例

图片和音频参考示例

创建成功响应

3. 查询视频任务

接口

cURL

任务状态

生成中响应

完成响应

4. 下载视频内容

接口

cURL

分段下载

响应说明

5. 失败响应

常见错误码

6. 素材要求

图片

视频

音频

7. 完整调用流程

8. 最小接入示例

Seedance 2.0 视频接入指南

Seedance2.0 视频接口接入文档#

基础信息#

1. 查询模型#

接口#

cURL#

支持的视频模型#

2. 创建视频任务#

接口#

Content-Type#

请求字段#

分辨率支持范围#

暂不支持的字段#

纯文本生成示例#

图片和音频参考示例#

创建成功响应#

3. 查询视频任务#

接口#

cURL#

任务状态#

生成中响应#

完成响应#

4. 下载视频内容#

接口#

cURL#

分段下载#

响应说明#

5. 失败响应#

常见错误码#

6. 素材要求#

图片#

视频#

音频#

7. 完整调用流程#

8. 最小接入示例#

Seedance2.0 视频接口接入文档

基础信息

1. 查询模型

接口

cURL

支持的视频模型

2. 创建视频任务

接口

Content-Type

请求字段

分辨率支持范围

暂不支持的字段

纯文本生成示例

图片和音频参考示例

创建成功响应

3. 查询视频任务

接口

cURL

任务状态

生成中响应

完成响应

4. 下载视频内容

接口

cURL

分段下载

响应说明

5. 失败响应

常见错误码

6. 素材要求

图片

视频

音频

7. 完整调用流程

8. 最小接入示例