Skip to content

Seedance 2.5 ​

通过 Fhddos 调用国内 Doubao 与海外 BytePlus Dreamina Seedance 2.5。

Seedance 2.5 同时提供国内 Doubao 和海外 BytePlus Dreamina 版本。两者共用 Fhddos 的任务接口和请求结构,但模型名、价格与联网搜索能力不同。

1. 模型与价格 ​

区域Fhddos 稳定模型名官方版本 ID无视频输入含视频输入
国内doubao-seedance-2-5doubao-seedance-2-5-260628¥70/M tokens¥42/M tokens
海外dreamina-seedance-2-5dreamina-seedance-2-5-260628$10.70/M tokens$6.40/M tokens

建议在请求中使用稳定模型名。平台也接受对应的官方版本 ID,并自动映射到稳定模型;查询和列表响应仍回显稳定模型名。

video 档表示 content[] 中包含 video_url,否则使用 novideo 档。480p 与 720p 单价相同;只对成功生成的视频结算,实际视频用量以查询响应中的 usage.completion_tokens 为准。

国内模型还支持纯文本任务使用 tools: [{"type":"web_search"}]。联网搜索按响应中的 usage.tool_usage.web_search 实际次数独立结算;海外模型不支持该工具,具体客户价格以 Fhddos 控制台为准。

2. 接口 ​

bash
export BASE_URL="https://aiapi.fhddos.com"
export TOKEN="oh-xxxxxxxxxxxxxxxx"
功能路径
创建任务POST /volcark/api/v3/contents/generations/tasks
查询任务GET /volcark/api/v3/contents/generations/tasks/{task_id}
查询任务列表GET /volcark/api/v3/contents/generations/tasks
取消或删除任务DELETE /volcark/api/v3/contents/generations/tasks/{task_id}

所有请求使用 Fhddos API Token:

http
Authorization: Bearer <TOKEN>
Content-Type: application/json

3. 创建任务 ​

国内文生视频示例:

bash
curl -X POST "$BASE_URL/volcark/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5",
    "content": [
      {
        "type": "text",
        "text": "一段 5 秒的电影感产品短片,柔和自然光,镜头缓慢向前推进。"
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true,
    "output_format": "mp4",
    "watermark": false
  }'

海外调用只需把 model 改为 dreamina-seedance-2-5;接口地址仍使用 Fhddos 的 BASE_URL。

创建成功返回任务 ID:

json
{
  "id": "cgt-202608130001-example",
  "model": "doubao-seedance-2-5"
}

多模态参考 ​

content[] 支持以下输入:

类型role数量上限
image_urlreference_image、first_frame、last_frame30
video_urlreference_video10
audio_urlreference_audio10

图片、视频和音频合计最多 50 个。Fhddos 托管素材可使用 asset://;素材需先完成上传和处理,再提交生成任务。

json
{
  "model": "doubao-seedance-2-5",
  "content": [
    {
      "type": "text",
      "text": "保持参考视频的镜头运动,使用参考图片的产品外观和参考音频的节奏。"
    },
    {
      "type": "video_url",
      "role": "reference_video",
      "video_url": {"url": "asset://video-asset-id"}
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {"url": "asset://image-asset-id"}
    },
    {
      "type": "audio_url",
      "role": "reference_audio",
      "audio_url": {"url": "asset://audio-asset-id"}
    }
  ],
  "resolution": "720p",
  "ratio": "adaptive",
  "duration": -1
}

首帧/尾帧任务必须使用 ratio=adaptive,last_frame 必须与 first_frame 同时出现,且首尾帧不能和 reference_* 素材混用。

国内联网搜索 ​

联网搜索只支持国内 doubao-seedance-2-5,且 content[] 必须只有文本:

json
{
  "model": "doubao-seedance-2-5",
  "content": [
    {
      "type": "text",
      "text": "结合近期公开信息生成一段科技新闻风格短片。"
    }
  ],
  "resolution": "720p",
  "duration": 5,
  "tools": [
    {"type": "web_search"}
  ]
}

4. 参数边界 ​

字段Seedance 2.5 约束
resolution仅 480p、720p,不支持 1080p 或 4k
duration4-30 的整数,或 -1 由模型选择
ratioadaptive、21:9、16:9、4:3、1:1、3:4、9:16
output_formatmp4、mov
generate_audio布尔值;默认生成同步音频
return_last_frame布尔值;成功响应可返回尾帧 URL
priority0-9
execution_expires_after3600-259200 秒
service_tier仅支持 default
draft仅支持 false

seed、frames、frames_per_second、frame_rate、fps、camera_fixed 不适用于 Seedance 2.5,传入时会在请求模型服务前返回 HTTP 400。

5. 查询结果 ​

bash
curl "$BASE_URL/volcark/api/v3/contents/generations/tasks/cgt-202608130001-example" \
  -H "Authorization: Bearer $TOKEN"

任务状态包括 queued、running、succeeded、failed 和 expired。成功任务会返回 content.video_url、实际规格与 usage:

json
{
  "id": "cgt-202608130001-example",
  "model": "doubao-seedance-2-5",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/generated-video.mp4"
  },
  "usage": {
    "completion_tokens": 108000
  }
}

成功视频 URL 通常有效 24 小时,且存在下载次数限制,请及时转存;失败任务应读取响应中的结构化 error。

6. OpenAI 风格接口 ​

Seedance 2.5 也可通过 POST /v1/videos 创建任务:

bash
curl -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5",
    "prompt": "一艘纸船漂浮在清晨的水面上",
    "seconds": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": true
  }'

OpenAI 风格接口适合基础文生视频和参考素材调用。需要 content[].role、output_format、tools.web_search 等完整原生能力时,请使用 /volcark/api/v3/contents/generations/tasks。

Fhddos AI 用户文档