Seedance 视频接入说明

最终接口规范，更新于 2026-09-18。此页为 apihz.net 的实际接入说明。模型广场 API 标签内的通用聊天示例不适用于视频模型。

通过请求中的 model 选择具体线路。任务采用异步模式：先提交任务，保存返回的任务 ID，再轮询查询接口。价格及用户优惠以模型广场和实际账单为准。

可用模型

当前只开放两个 Seedance 模型。seedance-video 使用原有独立渠道；seedance-2.5-vid 使用 Unvstar 渠道。两个模型不是同一上游，系统不会自动互相替换。

模型 ID规格与参考素材计费单位
seedance-video720P，10／15／30 秒；仅文字和图片参考按次
seedance-2.5-vid固定 720P，5／10／15／30 秒；最多 9 张图片＋3 个音频，不支持视频参考按次

seedance-2.5-vid 价格：5 秒 ¥6/次；10 秒 ¥9/次；15 秒 ¥10/次；30 秒 ¥11/次。模型开放状态及用户优惠以模型广场和实际账单为准。

1. 推荐接口

操作方法与路径
创建任务POST /api/v3/contents/generations/tasks
查询任务GET /api/v3/contents/generations/tasks/{task_id}
下载结果读取查询结果中的 content.video_url

服务地址为 https://apihz.net，请求头统一使用：

Authorization: Bearer <API_KEY>
Content-Type: application/json

POST /v1/videos、GET /v1/videos/{task_id} 和 GET /v1/videos/{task_id}/content 继续作为旧客户端兼容入口。新接入请使用上表中的方舟格式，避免在同一套客户端中混用两种响应状态。

2. 创建任务

推荐使用 duration；seconds 是兼容字段。两者只能选一个，同时提交时数值必须一致。seedance-video 支持 10／15／30 秒；seedance-2.5-vid 支持 5／10／15／30 秒。两个模型都固定为 720P。

字段要求
model必填，填写上表中的准确模型 ID；系统不会自动选择或替换
content必填，包含一个文字提示词，可按所选模型附加图片或音频
duration推荐，填写所选模型支持的视频秒数
secondsduration 的兼容写法
resolution当前固定填写 720p
ratio例如 16:9、9:16、1:1
generate_audio是否为输出视频生成音频；这不是参考音频输入
watermark是否生成水印
omni_reference_task_type多图参考任务填写 reference

content 支持范围

seedance-video 仅支持文字和图片，最多提交 9 张参考图片，不支持参考音频或参考视频。seedance-2.5-vid 最多支持 9 张参考图片和 3 个参考音频，不支持参考视频。

所有参考素材必须使用公网可直接访问、无需登录的 HTTPS URL。不能使用 HTTP、内网地址、本地文件路径或需要 Cookie／鉴权的地址。图片使用 image_url，音频使用 audio_url。

{
  "type": "text",
  "text": "根据参考图片生成一段连贯的视频"
}

{
  "type": "image_url",
  "image_url": {
    "url": "https://example.com/reference.webp"
  },
  "role": "reference_image"
}

两个模型都不要提交 video_url；使用 seedance-video 时也不要提交 audio_url。不要把 Markdown 链接写进 url；正确值是纯 URL，例如 https://example.com/a.webp，而不是 [图片](https://example.com/a.webp)。

完整请求示例

curl -X POST "https://apihz.net/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5-vid",
    "content": [
      {
        "type": "text",
        "text": "根据参考图片生成一段自然连贯的视频，保持主体外观、场景和运动连续一致"
      },
      {
        "type": "image_url",
        "image_url": {"url": "https://example.com/storyboard.webp"},
        "role": "reference_image"
      },
      {
        "type": "image_url",
        "image_url": {"url": "https://example.com/model.webp"},
        "role": "reference_image"
      },
      {
        "type": "image_url",
        "image_url": {"url": "https://example.com/product.webp"},
        "role": "reference_image"
      }
    ],
    "duration": 30,
    "resolution": "720p",
    "ratio": "9:16",
    "generate_audio": true,
    "watermark": false,
    "omni_reference_task_type": "reference"
  }'

JSON 字符串可以包含正常转义的换行符；服务端收到后会按标准 JSON 解析。图片 URL 中不能包含 [文字](URL) 这类 Markdown 格式。

3. 创建响应

创建成功只代表任务已受理。务必保存响应中的 id，不要把请求 ID 与任务 ID 混用。

{
  "id": "task_xxxxxxxxx",
  "model": "seedance-2.5-vid",
  "status": "queued"
}

4. 查询任务

curl "https://apihz.net/api/v3/contents/generations/tasks/task_xxxxxxxxx" \
  -H "Authorization: Bearer $API_KEY"
状态含义
queued已受理或排队中
running正在生成；上游的 Processing 会同步为此状态
succeeded生成完成
failed生成失败，读取错误信息

建议每 8 至 10 秒查询一次。任务处于 queued 或 running 时不要再次提交同一任务。

{
  "id": "task_xxxxxxxxx",
  "model": "seedance-2.5-vid",
  "status": "succeeded",
  "content": {
    "video_url": "https://apihz.net/media-records/video/0123456789abcdef0123456789abcdef?expires=1790000000&signature=..."
  }
}

content.video_url 是本站生成的签名下载链接。任务成功后可直接在浏览器打开，或发送一次不带 API Key 的 GET 下载视频，无需再次查询任务状态。链接在视频文件保留期内有效，expires 为到期时间；到期后返回 410。任务接口保持返回 JSON，不会把体积较大的视频二进制或 Base64 直接嵌入响应。

5. 参数和计费限制

6. 错误处理

HTTP 状态处理建议
400检查时长、分辨率、素材类型、URL 和 JSON 字段
401／403检查 API Key、账号权限和模型授权
409任务尚未完成，稍后继续查询
429降低提交或查询频率
502／503先使用已有任务 ID 查询后台状态；不要立即重复提交，以免产生重复任务或扣费

如果错误中出现数据库连接异常、Worker exception 或上游服务终止连接，应先在生成记录中核对任务是否已经受理，再决定是否重试。

7. 旧版 /v1/videos 兼容

POST https://apihz.net/v1/videos
GET  https://apihz.net/v1/videos/{task_id}
GET  https://apihz.net/v1/videos/{task_id}/content

旧版接口状态通常使用 queued、in_progress、completed、failed。新开发统一使用方舟接口及 queued/running/succeeded/failed 状态。

GPT Image 2.5 图片接入

验证情况：gpt-image-2.5 已实测返回图片；Flare、Sunburst 已配置但尚未完成生成验证。

图片渠道独立于上方视频渠道。使用本站图片令牌，支持 gpt-image-2.5、gpt-image-2.5-flare、gpt-image-2.5-sunburst。

生成图片

curl https://apihz.net/v1/images/generations \
  -H "Authorization: Bearer $NEW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2.5","prompt":"白色背景上的蓝色陶瓷杯，柔和棚拍光线，无文字","size":"1024x1024","n":1}'

返回 data 数组，图片可能位于 data[0].url 或 data[0].b64_json。URL需在失效前下载；Base64需解码后保存。生成耗时较长，建议客户端超时至少180秒。超时后先核对后台记录，避免重复扣费。

网页现提供文生图和图片编辑入口，支持多张参考图及可选 PNG 遮罩。按张价格及账号优惠仍以本站当前配置为准。

价格及用户优惠以模型广场和实际账单为准。

尺寸与质量

网页支持标准尺寸 1024×1024、1536×1024、1024×1536；2K 尺寸 2048×2048、2048×1152、1152×2048，以及自定义宽高。宽高须为 16 的倍数，比例 1:3 至 3:1，最大边长 3840，总像素 655360 至 8294400。超过 2560×1440 像素数属于实验分辨率，具体组合以模型实际响应为准。

quality 可选 auto、low、medium、high、xhigh、max。默认 auto；建议先使用 medium/high 验证效果，高档位并不保证每次生成成功。实测 Sunburst 的 high 档文生图与单图编辑均成功返回图片；多图与遮罩已验证网页提交格式，尚未逐项验证实际生成效果。

Sunburst 请求示例

POST https://apihz.net/v1/images/generations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{"model":"gpt-image-2.5-sunburst","prompt":"白色背景上的蓝色陶瓷杯，柔和棚拍光线","size":"2048x2048","quality":"high","n":1,"response_format":"b64_json"}

编辑已有图片

向 POST https://apihz.net/v1/images/edits 提交 multipart/form-data，携带同一本站令牌。字段包括 model、prompt、size、quality、n；单张图片使用 image，多张图片使用重复的 image[] 文件字段，遮罩使用 mask（PNG，与对应原图尺寸一致）。网页文件总大小限制 40 MB。浏览器提交时不要手动设置 multipart 的 Content-Type，需自动生成 boundary。

成功结果按 data 数组中的 b64_json 或 url 读取，与文生图一致。网页还提供扩展参数 JSON；接口会保留请求体字段，具体参数是否被接受由模型服务决定。

接口范围与验证边界

本站当前配置三个模型名：gpt-image-2.5、gpt-image-2.5-flare、gpt-image-2.5-sunburst。带日期快照未出现在当前渠道模型列表，暂不开放。图片生成请使用 Images 接口，不要把图片模型填写到 Chat Completions；Batch 不支持。Responses 图片工具依赖支持工具的主模型，目前本站尚未完成该路径的生成与按张计费验证，暂不提供可用示例。

Claude 文字与代码接口

Base URL：https://apihz.net/v1；使用本站令牌页面创建的 API Key。调用时请填写下方准确的模型 ID。

模型 ID：claude-fable-5、claude-opus-5。各模型开放状态以本站控制台为准。

curl https://apihz.net/v1/chat/completions \
  -H "Authorization: Bearer $NEW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-5","messages":[{"role":"user","content":"你好"}],"max_tokens":128}'

本站价格与开放状态以控制台为准。此接口采用 OpenAI Chat Completions 格式；尚未验证 Anthropic 原生 Messages、工具调用或长上下文。

实际价格与用户分组优惠以模型广场及账单为准。

返回模型广场

Grok 文字接口

grok-4.5 与 grok-4.6 已完成文本调用验证。流式、工具调用及多模态尚未验证。

Base URL：https://apihz.net/v1；使用本站 API Key。实际模型 ID：grok-4.5、grok-4.6。

curl https://apihz.net/v1/chat/completions \
  -H "Authorization: Bearer $NEW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-4.6","messages":[{"role":"user","content":"你好"}],"max_tokens":128}'

实际价格与用户分组优惠以模型广场及账单为准。

Gemini 接入

2026-09-12 已验证：gemini-3.7-flash 正常返回 OK；gemini-3.1-pro-preview 调用成功，但响应可能在 message.content 正文中包含分析文字。其余模型未逐一测试。gemini-3.1-pro、gemini-3.1-pro-preview-low、gemini-3.5-flash 当前均未配置价格，暂不可经本站调用。

Base URL：https://apihz.net/v1，使用本站 API Key，接口 POST /v1/chat/completions。模型 ID：gemini-3.1-flash-lite、gemini-3.1-flash-lite-preview、gemini-3.1-pro、gemini-3.1-pro-preview、gemini-3.1-pro-preview-low、gemini-3.5-flash、gemini-3.6-flash、gemini-3.6-flash-tiered、gemini-3.7-flash、gemini-3.8-flash

{"model":"gemini-3.7-flash","messages":[{"role":"user","content":"你好"}],"max_tokens":128}

gemini-3.1-pro、gemini-3.1-pro-preview-low、gemini-3.5-flash 暂未开放调用。Tiered 当前按本站列出的基础价格计费，长上下文使用条件尚未验证。实际计费以本站控制台为准。原生 Google 接口、多模态、工具调用尚未验证。

实际价格与用户分组优惠以模型广场及账单为准。

国内模型接入

已验证：glm-5.2、deepseek-v4-flash-0731 经本站文本调用均返回 OK。其他已开放模型尚未逐一实测。

Base URL：https://apihz.net/v1，使用本站 API Key；接口 POST /v1/chat/completions。

{"model":"glm-5.2","messages":[{"role":"user","content":"你好"}],"max_tokens":128}

暂未开放：deepseek-v4-flash、deepseek-v4-pro、deepseek-v4.1-flash、glm-5.3-flash、kimi-k2.7-code-highspeed。实际开放状态及费用以本站控制台为准。多模态及工具调用尚未验证。

实际价格与用户分组优惠以模型广场及账单为准。

DeepSeek 全天使用固定价格，不区分时段。