图片与视频 API
使用一个 API Key，通过「提交任务 → 查询状态 → 下载结果」接入图片和视频生成。无需为文生图、图片编辑、首尾帧或参考生成切换 API 地址。
服务地址：https://api.hamubox.com
从哪里开始
章节：从哪里开始使用网页创作、学习参考素材或专业模型，请进入创作学堂。本页以下内容面向 API 接入。
| 目标 | 文档 |
|---|---|
| 发起第一个任务 | 快速开始 |
| 生成视频、首尾帧、图片 / 视频 / 音频参考 | 视频接口 |
| 生成图片、使用参考图编辑 | 图片接口 |
| NovelAI 专业绘图与生成过程 | NovelAI 接入概览 · 客户端接入 · 流式协议 |
| Midjourney / Niji 生图、多结果与后续操作 | MJ 快速开始 · 参数参考 · 常见问题 |
| 交给 AI 编程助手接入 | LLM 接入资料 |
| 查询费用与错误 | 计费与结算 · 错误处理 |
本版覆盖模型
章节：本版覆盖模型| 系列 | 公开模型 ID | 接入说明 |
|---|---|---|
| Seedance 2.0 / Fast / Mini / 2.5 | dreamina-seedance-…-ep、doubao-seedance-… | Seedance |
| Wan 3 | wan3.0-video-ep | Wan 3 |
| Seedream 5 Pro | dola-seedream-5-0-pro-ep | Seedream |
| GPT Image 2 | gpt-image-2 | GPT Image 2 |
| Nano Banana 2 / Pro | nano-banana-2、nano-banana-pro | Nano Banana |
| Midjourney / Niji / MJ 视频 | midjourney-v…、niji-v…、midjourney-video | 生成、变体、放大与视频延长 |
| NovelAI V5 / V4.5 / V4 / V3 | nai-diffusion-… | 模型与绘图参数 |
图片模型章节以 default 分组的接口能力为准。同名模型在其他分组的参数可能不同，请不要混用其他服务的请求示例。使用当前 Key 调用 GET /v1/models 确认模型可用；价格见模型广场。
NovelAI 使用独立的 /v1/novelai/tasks 和流式入口，不通过下面的通用图片接口提交。
四个核心接口
章节：四个核心接口| 方法 | 路径 | 用途 |
|---|---|---|
| POST | /v1/video/generations | 创建视频任务 |
| GET | /v1/video/generations/{task_id} | 查询视频状态、错误和结果 |
| POST | /v1/image/generations | 创建图片任务，包括图片编辑 |
| GET | /v1/image/generations/{task_id} | 查询图片状态、错误和结果 |
可下载资料
章节：可下载资料- OpenAPI JSON：包含本版公开的异步接口与 NovelAI 流式入口，不包含后台管理接口。
- llms.txt：章节索引。
- llms-full.txt：完整纯文本 Markdown 文档，可直接提供给 LLM。
- 调用示例：Python 完整提交与轮询，以及 curl 请求。
本文档不涉及 BYOK 与 RunningHub 工作流接入；这些能力后续单独补充。