DOCUMENTATION / QUICK START
https://api.nailongapi.cc
奶龙 API 服务根地址。文档站域名仅用于阅读指南，API 请求发送到此地址。
先确认软件使用的协议，再选择当前密钥有权限的模型。“兼容 OpenAI”并不等于同时支持聊天、图片编辑和异步视频。
IMAGE图片生成与编辑 ↗文本生成、参考图片、比例与 4K 参数。VIDEO异步视频接入 ↗提交任务、保存编号、查询与鉴权下载。CATALOG模型能力与价格 ↗按密钥权限导入，核对时长与素材限制。TROUBLESHOOTING从报错定位问题 ↗400 参数冲突、503 渠道与提交超时。
1. 准备地址与密钥
| 配置 | 填写方式 |
|---|---|
| API 服务根地址 | https://api.nailongapi.cc |
| OpenAI 客户端 Base URL | 软件明确要求版本前缀时填写 https://api.nailongapi.cc/v1 |
| API Key | 在账户内创建并确认有效期、额度、分组和模型限制 |
| 自定义请求 | Authorization: Bearer sk-YOUR_NAILONG_API_KEY |
若软件会自动追加 /v1，基础地址只填写服务根。若软件追加 /images/generations，则可能需要包含 /v1。以软件实际发出的完整 URL 为准，避免 /v1/v1 或缺少版本路径。
以下命令使用 Bash 语法；先在自己的服务端环境中设置 NAILONG_API_KEY，不要把真实密钥写入代码、文档或聊天。这里只展示读取目录，不生成内容。
curl --fail-with-body 'https://api.nailongapi.cc/v1/models' \
-H "Authorization: Bearer ${NAILONG_API_KEY}"
从返回的 data[].id 选择精确模型 ID。大小写、空格和后缀都应保留，不用显示名称替代 ID。客户端应从自己的后端调用；本指南网页不收集或测试真实密钥。
2. 选择正确接口
| 目标 | 常见请求路径 | 必须支持的行为 |
|---|---|---|
| 聊天补全 | POST /v1/chat/completions |
messages 与聊天响应解析 |
| Responses | POST /v1/responses |
input 与对应事件/响应解析 |
| 兼容图片生成 | POST /v1/images/generations |
图片字段及 URL/Base64 结果 |
| 兼容图片编辑 | POST /v1/images/edits/ |
multipart 文件上传 |
| 已确认的原生图片协议 | POST /v1beta/models/{model}:generateContent |
多模态 parts 与原生结果解析 |
| 已确认的视频任务协议 | POST /v1/videos |
保存 ID、查询状态、取得结果 |
这些是不同协议的入口，不是任意模型都能使用的路径列表。表中的聊天与 Responses 是软件可能采用的通用协议，本次文档制作未验证奶龙站当前相应模型的调用能力。图片与视频也仅限各页明确说明的已确认契约。先核对当前模型支持的协议，不要通过连续尝试不同收费接口来猜测。
3. 检查软件兼容性
接入前确认软件能配置：完整请求路径、鉴权头、模型 ID、请求字段、返回解析；视频还需要任务 ID、状态和下载流程。仅支持聊天的插件需要额外适配。
模型广场或模型列表中出现某个 ID，不代表当前软件支持它的调用方式。遇到不兼容时，先查看脱敏后的实际请求与响应，按 错误排查 定位。
4. 第一次生成前
- 用当前密钥读取目录，核对模型、分组及限制。
- 在模型详情中确认协议、分辨率、时长、素材数量和当前公开价格。
- 使用有证据支持的最小参数。文档中的
YOUR_IMAGE_MODEL_ID、YOUR_VIDEO_MODEL_ID都是占位符。 - 确认会产生费用后再提交。超时或未收到任务 ID 时，先查任务与用量记录，避免重复扣费。
文档整理自历史实践、源码核查及本地模拟。模拟通过不等于所有型号当前线上可用；动态能力和价格以当前账户及模型资料为准。详见 验证范围。