跳转到内容
HamuBox API

异步视频接口

提交

章节：提交

下方通用参数表针对 Seedance 和 Wan。Midjourney 视频使用同一端点，但以 images 传首尾帧，不支持任意 duration，请使用其专属请求格式。

POST /v1/video/generations
Authorization: Bearer sk-your-api-key
Content-Type: application/json
字段类型说明
modelstring，必填公开模型 ID，见模型章节
promptstring，必填非空提示词
modestring文生视频、first_last_frame 或 multi_ref，见下表
durationinteger输出秒数，建议明确传值；允许范围随模型变化
resolutionstring如 720p、1080p；建议明确传值
aspect_ratiostring如 16:9、adaptive；模型支持范围不同
audioboolean是否生成声音；不等于参考音频输入
first_frame_urlstring首帧图片；首尾帧模式使用
last_frame_urlstring尾帧图片；支持仅尾帧的模型可单独提供
image_urlsstring[]全能参考图片
reference_video_urlsstring[]全能参考视频
reference_audio_urlsstring[]全能参考音频
metadataobject模型明确要求的补充参数，如参考时长

watermark、seed、prompt_extend 不属于所有视频模型共有能力，请只按模型章节使用。不要直接复制供应商的 content、input、parameters 嵌套格式代替本站字段。

模式选择

章节：模式选择
目标推荐写法
文生视频Seedance 省略 mode 和所有参考；Wan 3 用 mode: "text"
首帧 / 尾帧 / 首尾帧mode: "first_last_frame"，传对应显式帧字段
多素材参考mode: "multi_ref"，使用图片 / 视频 / 音频数组
Seedance 2.5 单视频编辑multi_ref + 唯一视频 + duration: -1 + aspect_ratio: "adaptive"

不建议依赖服务端从单张图片推测模式。首尾帧和全能参考是不同用途，即便都只有一张图片也应明确区分。

wan-text.json
{
  "model": "wan3.0-video-ep",
  "prompt": "A paper boat drifting across a quiet lake, cinematic lighting.",
  "mode": "text",
  "duration": 7,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "audio": true,
  "prompt_extend": false
}

提交响应

章节：提交响应
{
  "id": "task_example",
  "object": "video",
  "model": "wan3.0-video-ep",
  "status": "queued",
  "progress": 0,
  "created_at": 1788627335
}

有些兼容响应会同时给出 task_id。优先使用 id，缺少时再取 task_id；不要把任何供应商 ID 当作本站查询 ID。

查询

章节：查询
GET /v1/video/generations/{task_id}
Authorization: Bearer sk-your-api-key

成功时优先遍历 outputs[].url；metadata.url 兼容提供第一条视频，旧任务也可能只有该字段。失败时读取 error。完整字段与恢复逻辑见任务生命周期。费用通常位于 usage，部分视频响应也兼容顶层费用字段；新客户端优先使用 usage。

模型参数

章节：模型参数