漫小白 API 接入文档
从创建令牌，到获取第一张图片，再到可靠地接入生产应用。本手册面向本站实际开放的接口，生图是主要内容，也包含语言模型与视频接口。
SD / Seedance 章节于 2026-10-14 更新，含两个型号、参考素材和完整 Python 视频客户端；其他接口核对日期为 2026-09-16。接口契约与当前部署实现核对；生图能力参考 2026-09-10 已完成的真实调用记录。模型、分组和价格会变化，请同时查看模型广场和模型状态。
第一次接入
- 快速上手：创建 Key，检查模型权限，提交并查询一次图片任务。
- 模型与规格：选择模型、尺寸和分组，了解 GPT 与 Gemini 的差异。
- 完整代码：Python、Node.js 的提交、轮询、下载与断点续查示例。
所有页面可直接在线阅读。顶部可复制本页或全部 Markdown，也可下载完整手册。代码框只负责复制，不会在浏览器中调用收费接口。
接口地图
| 任务 | 推荐入口 | 阅读章节 |
|---|---|---|
| 查询令牌可用模型 | GET /v1/models |
鉴权与地址 |
| 文生图 | POST /v1/images/generations/async |
文生图 |
| 图生图 | POST /v1/images/edits/async |
图生图 |
| 查询图片任务 | GET /v1/images/tasks/{task_id} |
异步任务 |
| Gemini 原生生图 | POST /v1beta/models/{model}:generateContent |
Gemini 原生接口 |
| 语言模型 | POST /v1/chat/completions、POST /v1/responses |
文本接口 |
| 视频任务 | POST /v1/videos、GET /v1/videos/{task_id} |
视频接口 |
| Seedance 视频 | POST /v1/videos、查询及内容下载 |
SD / Seedance 接入 |
| 公开价格 | GET /api/pricing |
分组与计费 |
在开始前知道这几件事
- API Key 在服务端使用。本站不提供供第三方网页直接调用的完整跨域支持。
- 生图建议每次
n=1。创建任务成功不等于生成完成；完成后还需检查图片结果。 - 拿到任务 ID 后只重试查询。提交超时或断线时不要自动重发 POST，当前没有可依赖的幂等去重保证。
- 生成结果是临时资源，完成后及时下载到自己的存储。
gpt-image-2-az当前有 JSON 异步兼容问题，使用该模型前先阅读限制与兼容。
需要排查问题
先看错误处理，再携带模型名、分组、请求时间、任务 ID、request_id 和脱敏错误信息提交反馈。不要提供完整 API Key。