LLM 接入资料

直接提供这些地址

每个章节还有原始 Markdown，路径为 /docs/markdown/{章节}.md，例如 Seedance Markdown。这些文件由当前文档源自动导出，不是另一套手动维护内容。

NovelAI 有独立目录。按接入方式提供概览、通用参数、原生协议、异步任务、流式与恢复及客户端配置。同一操作只选择一种提交方式，不同时调用原生和异步端点。

Midjourney / Niji 按需求读取快速开始、完整参数、参考图与风格、变体与放大、视频与常见问题。字段约束集中在完整参数页，其它章节解释使用流程，不是另一套接口。公开参数契约不等于所有操作都已配置可用价格。

给编程助手的要求

请接入 HamuBox 的异步图片 / 视频 API。
先阅读 https://api.hamubox.com/docs/llms-full.txt
再对照 https://api.hamubox.com/docs/openapi.json

Base URL: https://api.hamubox.com
使用用户配置的本站 API Key，放在 Authorization: Bearer 中。
视频 POST /v1/video/generations，GET /v1/video/generations/{task_id}。
图片 POST /v1/image/generations，GET /v1/image/generations/{task_id}。
NovelAI 单独 POST /v1/novelai/tasks（202），GET /v1/novelai/tasks/{task_id}。
提交后立即保存 id 和媒体类型，每隔 5 秒查询。
completed / failed 表示生成结束，HTTP 200 不代表任务成功。
视频和图片都遍历 outputs[].url；视频 metadata.url 只是第一条兼容结果，不代表全部输出。
Midjourney 图片 n:1 表示一组，视频 n 表示条数。不要把全部图片结果重新逐张乘价。
Midjourney describe 读取 descriptions[]，允许没有图片输出的成功任务。
MJ 后续操作仅使用响应 actions 中的 operation、output_index 和本站 parent_task_id，不能用上游 ID 或界面排序后的下标。
MJ 如返回保存状态，图片读取 result_transfer_status，视频读取 metadata.result_transfer_status。
需要本站转存 URL 时可继续查询至 stored；设置等待期限，保存 failed 不等于生成 failed，也不能因此再次 POST。
NovelAI 图片读取 result.images[].url，氛围编码读取 result.encoded_vibe。
NovelAI 原生流式 /v1/novelai/ai/generate-image-stream 是长度帧 MessagePack，不是 SSE 或 ZIP。
已有官方协议客户端将 Base URL 设为 https://api.hamubox.com/v1/novelai，再追加 /ai/generate-image、/ai/augment-image、/ai/upscale（ZIP），以及 /ai/encode-vibe（二进制）。
拼接原生路径时必须保留 /v1/novelai 前缀；账户查询同样为 /v1/novelai/user/data 等，返回本站虚拟显示单位，不是上游真实余额。
需要 SSE 时，提交 NovelAI 任务 stream:true 后 GET /v1/novelai/tasks/{task_id}/events。
流式 image/final 事件可先于存储和结算送达，完成状态仍以任务查询为准。
刷新页面后按已保存的 ID 恢复查询，不重复 POST。
除对应章节明确说明外，不要自行假定支持 webhook、取消、批量端点或 Idempotency-Key。
参数以对应分组的公开模型章节为准，不照搬供应商 SDK 的字段。
Key 不写入源码和日志，下载第三方结果时不携带本站 Authorization。

范围与边界

本版 OpenAPI 覆盖常用公开模型的异步图片、视频、NovelAI 任务和原生绘图接口，以及模型清单。NovelAI 登录、支付、故事、文本与语音不在兼容范围内。BYOK、工作流、后台管理、账户调度、内部成本及模型级价格覆盖均不属于本次公开接入合同。

OpenAPI 用于字段结构与示例，跨字段的媒体约束仍需结合模型章节。例如参考视频真实时长、图像透明通道、任务意图等不能仅凭 JSON Schema 完成校验。