开发者资料

把指南交给开发 Agent

如果你希望 AI 开发助手把奶龙 API 接入画布、网站或其他软件，可以提供下方的接入说明包。它整理了协议选择、能力与价格合并、比例和分辨率、异步任务恢复、素材和错误处理。

这些资料不是官方通用 SDK，也不保证任意软件开箱即用。文档不包含固定实时模型名单或报价，接入方应核对当前地址、Key 权限和目标型号。

使用方式

1. 把说明包交给负责目标软件的开发 Agent，要求它先读取 nailong-api-integration/SKILL.md。
2. 说明软件、目标功能、服务地址和需要接入的模型类型。真实 Key 通过客户服务端环境变量配置，不粘到提示词里。
3. 先核对协议、参数及错误分支，再用本地 mock 演练。
4. 真实生成前由客户确认模型、参数和费用范围；本地测试成功不自动授权收费调用。

验证范围

原始 v3 Skill 的验证报告记录：34项本地模拟测试通过，覆盖模型目录、参数传递、任务恢复、临时错误、鉴权下载和脱敏。这是已保存的历史验证结果，本次文档制作没有重跑或冒充真实生成验收。

本次新增文档会另行核查页面、链接、代码示例、下载包、桌面及移动端展示，并在交付中说明实际结果。

已有证据

• 历史源码、测试和保存的接入验收材料。
• 独立参考客户端与隔离 mock 对指定场景的处理行为。
• 已定位的协议路径、路由、尺寸冲突和任务错误案例。

尚不能据此证明

• 当前所有模型、所有客户软件、所有分组的真实生成可用性。
• 所有比例、4K、时长和多参考组合都受支持。
• 当前公网、TLS、CDN、素材租期和真实扣费结算的完整可靠性。
• 每一份历史对话均读取完整：原资料记录过部分检索中断。

开发者附件说明

附件中的 Python 工具是参考实现。mock 服务只用于隔离本地验证，不具备完整生产 TLS、租户隔离、签名服务或网络访问防护，不能直接公网暴露。参考客户端也不能代替生产任务平台的事务、并发控制和持久化设计。

本次下载包为面向客户的整理副本，不覆盖原始 Skill。只保留公开协议与开发资料，不包含真实密钥、客户媒体、原始对话、内部配置或服务器部署信息。