# HamuBox API

> Public asynchronous image/video, Midjourney / Niji tasks, and NovelAI task/streaming API. Use a HamuBox API Key.

## Documentation

- [鉴权与模型可用性](https://api.hamubox.com/docs/markdown/authentication.md): API Key、分组和模型清单的使用方式。
- [计费与结算](https://api.hamubox.com/docs/markdown/billing.md): 区分按次、按秒和视频 token，正确读取预扣与实际费用。
- [错误处理](https://api.hamubox.com/docs/markdown/errors.md): 区分 HTTP 失败、任务失败、参数错误和查询重试。
- [调用示例](https://api.hamubox.com/docs/markdown/examples.md): curl 请求文件、Python 提交与轮询、断线后恢复。
- [异步图片接口](https://api.hamubox.com/docs/markdown/image.md): 同一异步端点完成文生图和参考图编辑。
- [图片与视频 API](https://api.hamubox.com/docs/markdown/index.md): 使用统一的异步接口接入 HamuBox 图片与视频生成。
- [LLM 接入资料](https://api.hamubox.com/docs/markdown/llm.md): 面向 AI 编程助手的纯文本文档、OpenAPI 和接入约束。
- [Midjourney API 变体与放大](https://api.hamubox.com/docs/markdown/midjourney/actions.md): 读取 MJ 与 Niji 的全部结果，通过 actions、parent_task_id 和 output_index 创建变体、放大与扩图，并处理图转提示词结果。
- [Midjourney 与 Niji API 常见问题](https://api.hamubox.com/docs/markdown/midjourney/faq.md): 解答 MJ API 订阅、四张图片、Fast/Relax 计费、原生参数、客户端兼容、变体放大、视频批量以及 CDN 下载失败问题。
- [Midjourney API 快速开始](https://api.hamubox.com/docs/markdown/midjourney/quickstart.md): 使用 HamuBox API Key 调用 Midjourney 与 Niji：确认模型、估价、提交图片任务、轮询并读取全部结果，不需要自己的 MJ 订阅。
- [Midjourney API 参考图与风格码](https://api.hamubox.com/docs/markdown/midjourney/references.md): 区分 Midjourney 普通图片参考、sref 风格参考、cref 角色参考、Omni Reference 与个性化代码，并按模型选择参数。
- [Midjourney 视频 API 接入](https://api.hamubox.com/docs/markdown/midjourney/video.md): 通过图片首尾帧调用 Midjourney 视频生成，处理 SD/HD、Fast、批量结果与父任务延长，不使用普通 Seedance 视频参数。
- [Nano Banana 2 / 2.1 / Pro](https://api.hamubox.com/docs/markdown/models/banana.md): 香蕉模型的分辨率、比例与参考图编辑，区分 2.1 和 2 / Pro 的参数能力。
- [GPT Image 2](https://api.hamubox.com/docs/markdown/models/gpt-image-2.md): default 分组 GPT Image 2 的尺寸、质量、参考图片和异步示例。
- [Midjourney 与 Niji API 参数参考](https://api.hamubox.com/docs/markdown/models/midjourney.md): HamuBox Midjourney API 与 Niji API 的模型、Fast/Relax、图片参考、变体放大、多结果和视频请求参数，附 JSON 与 curl 示例。
- [Seedance 系列](https://api.hamubox.com/docs/markdown/models/seedance.md): Seedance EP 与 Doubao 的模型 ID、三种模式、参考限制、编辑与延长意图。
- [Seedream 5 Pro](https://api.hamubox.com/docs/markdown/models/seedream.md): Seedream 5 Pro EP 文生图、图片编辑与多参考图计费。
- [Wan 3 EP](https://api.hamubox.com/docs/markdown/models/wan3.md): Wan 3 EP 系列的按秒计费、自由时长、参考限制和请求示例。
- [NovelAI · 客户端接入](https://api.hamubox.com/docs/markdown/novelai/clients.md): 第三方 NovelAI 绘图客户端的通用配置、协议选择、无生成费用检查与兼容性验证范围。
- [NovelAI 常见问题](https://api.hamubox.com/docs/markdown/novelai/faq.md): NovelAI 原生与异步协议、图片元数据、参考素材保存、临时文件、缓存与费用单位说明。
- [NovelAI · 模型与绘图参数](https://api.hamubox.com/docs/markdown/novelai/models.md): NovelAI V5、V4.5、V4、V3 共用的模型能力、角色提示词、图生图、重绘与参考素材参数。
- [NovelAI · 官方协议兼容](https://api.hamubox.com/docs/markdown/novelai/native.md): 第三方绘图客户端的 Base URL、官方路径、同步 ZIP、MessagePack、缓存重传与账户显示兼容说明。
- [NovelAI · OpenAI Images 兼容](https://api.hamubox.com/docs/markdown/novelai/openai-images.md): 使用标准 Images JSON 请求调用 NovelAI 单图生成，保留 NAI 专业参数、原图元数据和任务恢复能力。
- [NovelAI 接入概览](https://api.hamubox.com/docs/markdown/novelai/overview.md): 选择 NovelAI 原生兼容或异步任务接法，配置 Base URL 与本站 API Key，并定位模型、流式和客户端文档。
- [NovelAI · 流式生成与恢复](https://api.hamubox.com/docs/markdown/novelai/streaming.md): 异步任务 SSE 与官方格式 MessagePack 的区别、最终图提前交付、断流恢复及可运行示例。
- [NovelAI · 异步任务接口](https://api.hamubox.com/docs/markdown/novelai/tasks.md): NovelAI 异步任务的费用预估、提交、状态查询、结果格式及断线后的任务恢复。
- [快速开始](https://api.hamubox.com/docs/markdown/quickstart.md): 创建 API Key，提交图片或视频任务，轮询并下载结果。
- [参考素材](https://api.hamubox.com/docs/markdown/references.md): URL、Base64、首尾帧、音视频时长与素材可访问性。
- [任务生命周期](https://api.hamubox.com/docs/markdown/tasks.md): 异步状态、结果字段、轮询、断线恢复与重复提交风险。
- [异步视频接口](https://api.hamubox.com/docs/markdown/video.md): 提交和查询统一视频任务，区分首尾帧与全能参考。

## Machine-readable API

- [OpenAPI](https://api.hamubox.com/docs/openapi.json)
- [Full documentation](https://api.hamubox.com/docs/llms-full.txt)