Appearance
视频(OpenAI)
通过 OpenAI 风格 /v1/videos 接口调用火山方舟 Doubao Seedance 视频模型,统一使用 video_ 前缀任务 ID。
本页介绍如何在 Fhddos 中,使用 OpenAI 风格的视频接口 /v1/videos 调用火山方舟 Doubao Seedance 视频模型,并与官方 Sora/Veo 接口保持一致的体验:
- 统一的请求体:
model/prompt/seconds/size/input_reference; - 统一的任务 ID:响应中的
id均为video_形式; - 统一的查询方式:
GET /v1/videos/{id}。
本页覆盖的是 Doubao Seedance 1.x 兼容用法。
如果你要接入 Seedance 2.5,请改看 Seedance 2.5;国内 Doubao Seedance 2.0 和海外 BytePlus Dreamina Seedance 2.0 分别见 Doubao Seedance 2.0 与 BytePlus Dreamina Seedance 2.0。 Seedance 2.0 的 4K 能力、10-bit / H.265 输出、fast 分辨率限制和国内/海外价格均以两篇 2.0 原生任务文档为准,不从本页的 Seedance 1.x 约束推断。
对比关系:
- 原生 Ark 接口:
POST /volcark/api/v3/contents/generations/tasks(见doubao/video文档)- OpenAI 风格接口(本页):
POST /v1/videos
1. 前置条件
bash
export BASE_URL="https://aiapi.fhddos.com/v1"
export TOKEN="oh-xxxxxxxxxxxxxxxx"HTTP 头部:
http
Authorization: Bearer <TOKEN>
Content-Type: application/json账号需要开通以下 Doubao Seedance 模型:
doubao-seedance-1-5-prodoubao-seedance-1-0-prodoubao-seedance-1-0-pro-fastdoubao-seedance-1-0-lite-t2vdoubao-seedance-1-0-lite-i2v
2. OpenAI 风格接口概览
在 OpenAI 风格模式下,你只需要关注统一的 /v1/videos 接口:
- 创建任务:
POST /v1/videos - 查询任务:
GET /v1/videos/{id} - 下载内容:
GET /v1/videos/{id}/content
VolcArk 字段兼容
- Doubao Seedance 模型在
/v1/videos下支持 Ark 官方字段:duration、ratio、resolution、watermark、generate_audio、camera_fixed;duration会作为seconds的别名处理; Seedance 参数约束(2026-02-11)- 支持模型:
doubao-seedance-1-5-pro、doubao-seedance-1-0-pro、doubao-seedance-1-0-pro-fast;seconds:1-5-pro支持4-12,1-0-pro / 1-0-pro-fast支持2-12;input_reference:1-5-pro / 1-0-pro最多 2 张;1-0-pro-fast最多 1 张;generate_audio:仅1-5-pro支持;resolution:1-5-pro仅支持480p/720p;1-0-pro / 1-0-pro-fast支持480p/720p/1080p。
input_reference 兼容写法
- 数组:
["https://.../first.png","https://.../last.png"]- 单字符串:
"https://.../only.png"- 字符串化数组:
"[\"https://.../first.png\",\"https://.../last.png\"]"
3. 文生视频示例(T2V)
以 doubao-seedance-1-0-pro-fast 为例:
bash
curl -X POST "https://aiapi.fhddos.com/v1/videos" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedance-1-0-pro-fast",
"prompt": "夜晚城市街道上的车辆灯光流动",
"seconds": 8,
"size": "1280x720"
}'典型成功返回:
json
{
"id": "video_01KB1Y6FT0QMDKS0Y1YYYSS4D0",
"object": "video",
"status": "queued",
"model": "doubao-seedance-1-0-pro-fast",
"seconds": 8,
"size": "1280x720"
}说明:
id:平台生成的全局任务 ID,始终以video_开头;- 在
/panel/task页面中你会看到同一个值(列名为「任务ID」)。
- 在
model:保留对外暴露的 API 模型名(例如doubao-seedance-1-0-pro-fast)。
4. 图生视频示例(I2V)
图生视频模型通过 input_reference 传入参考图 URL(兼容 input_image / input_images):
bash
curl -X POST "https://aiapi.fhddos.com/v1/videos" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedance-1-0-lite-i2v",
"prompt": "一幅油画风格的海边日落场景",
"seconds": 6,
"size": "720x1280",
"input_reference": [
"https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_first_frame.png"
]
}'WARNING
对于 I2V 模型(如 doubao-seedance-1-0-lite-i2v),若未提供任何图片引用,平台会返回错误:
image to video models require image in content
5. 查询任务状态
创建任务后,可通过 id 查询最新状态:
bash
export VIDEO_ID="video_01KB1Y6FT0QMDKS0Y1YYYSS4D0"
curl "https://aiapi.fhddos.com/v1/videos/$VIDEO_ID" \
-H "Authorization: Bearer $TOKEN"典型返回:
json
{
"id": "video_01KB1Y6FT0QMDKS0Y1YYYSS4D0",
"object": "video",
"status": "completed",
"model": "doubao-seedance-1-0-pro-fast",
"seconds": 8,
"size": "1280x720",
"video_url": "https://aiapi.fhddos.com/video/01KB1Y6FT0QMDKS0Y1YYYSS4D0.mp4"
}说明:
status:queued/in_progress/completed/failed等;video_url:- 为平台代理后的 URL,不会暴露源站域名;
- 同一 URL 会出现在
/panel/task弹窗中的「平台最终响应」里。 - 若完成结果中缺失
video_url,平台会自动回退请求提取视频地址(仅在已完成态触发)。
6. 下载视频内容
下载内容与 Sora/Veo 对齐,使用 /v1/videos/{id}/content:
bash
curl -L "https://aiapi.fhddos.com/v1/videos/$VIDEO_ID/content" \
-H "Authorization: Bearer $TOKEN" \
-o doubao-seedance-demo.mp47. 与原生 VolcArk 接口的对比
| 维度 | 原生 VolcArk 接口 | OpenAI 风格接口 /v1/videos |
|---|---|---|
| 创建路径 | /volcark/api/v3/contents/generations/tasks | /v1/videos |
| 请求体 | model + content[{type,text/image_url,...}] | model + prompt + seconds + size + input_reference |
| 任务 ID | Ark 的 id / task_id(不带前缀) | 平台全局 ID:video_ |
| 查询路径 | /volcark/api/v3/contents/generations/tasks/{task_id} | /v1/videos/{id} |
| 控制台任务列表 | PlatformTaskID(原生:裸 ULID;现在:带 video_ 前缀) | 同一值,展示为 video_ |
推荐使用:
- 如希望与 OpenAI Sora/Veo 风格统一,优先使用本页的
/v1/videos接口; - 如需完全对齐火山方舟官方文档(原生字段),可使用
doubao/video文档中的 VolcArk 原生接口。