调用示例

可下载的请求 JSON

把示例中的 https://example.com/... 换成自己的可访问素材 URL。

任务	JSON
Seedance 文生视频	seedance-text.json
Seedance 首尾帧	seedance-frames.json
Seedance 仅尾帧	seedance-tail.json
Seedance 全能参考	seedance-reference.json
Seedance 2.5 视频编辑	seedance-edit.json
Wan 3 文生视频	wan-text.json
Wan 3 首尾帧	wan-frames.json
Wan 3 参考生成	wan-reference.json
Seedream 生成 / 编辑	生成 · 编辑
GPT Image 2 生成 / 编辑 / 自定义	生成 · 编辑 · 自定义
Nano Banana 生成 / 编辑 / 自定义	生成 · 编辑 · 自定义
MJ 生成 / 风格与角色参考 / 编辑	生成 · 参考 · 编辑
MJ 变体 / 放大 / 图转提示词	变体 · 放大 · 图转提示词
MJ 视频生成 / 延长	生成 · 延长
NovelAI 异步文生图 / 图生图 / 局部重绘	文生图 · 图生图 · 局部重绘
NovelAI 异步 Director / 放大 / 氛围编码	Director · 放大 · 氛围编码
NovelAI 原生文生图 / 图生图 / 局部重绘	文生图 · 图生图 · 局部重绘
NovelAI 原生 Director / 放大 / 氛围编码	Director · 放大 · 氛围编码
NovelAI 原生流式	请求 JSON · MessagePack 客户端

用 curl 提交文件

curl --fail-with-body 'https://api.hamubox.com/v1/video/generations' \
  -H "Authorization: Bearer $HAMUBOX_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @seedance-text.json

图片换成 /v1/image/generations 与对应 JSON 文件。Windows PowerShell 请使用 curl.exe，避免旧版 PowerShell 的同名别名。

NovelAI 异步任务使用 /v1/novelai/tasks；原生接口按操作选择 /v1/novelai/ai/... 路径，原生流式还需要专用解析器。两套示例的外层格式不同，不能互换。

Python 完整客户端

下载 client.py。Python 3.10+，仅使用标准库，支持提交、查询、GET 退避与任务恢复，不会自动重发 POST。

export HAMUBOX_API_KEY='sk-your-api-key'
python client.py image banana-generate.json
python client.py video seedance-text.json
python client.py novelai novelai-generate.json
python client.py image midjourney-image-generate.json
python client.py video midjourney-video-generate.json

程序提交成功后立即输出任务 ID，并保存不含 Key 的 task_….json。等待超时或下次运行时：

python client.py video --task-id task_your_existing_id --max-wait 1800

--max-wait 是客户端本次最长等待秒数，不改变服务器任务状态。把示例集成到业务时，建议用数据库保存任务 ID、媒体类型和终态，而不是仅依赖本地文件。

下载结果

成功后，视频优先遍历 outputs[].url，没有时兼容 metadata.url；图片遍历 outputs[].url。MJ 图转提示词读取 descriptions[]，无需下载图片。NovelAI 取 result.images[].url（氛围编码取 result.encoded_vibe）。下载不要携带本站 Authorization：

curl --fail --location --output result.mp4 '替换为完整视频结果URL'

签名 URL 必须保留查询参数。客户端展示时使用真实媒体尺寸，避免把所有结果硬编码为正方形或 16:9。