阅读顺序
新接入项目建议按这个顺序阅读：- 在控制台创建或选择 API Key。
- 调用模型列表，确认当前 Key 可用的模型 ID。
- 选择接口类型：文本、图片、视频、音频或文件。
- 先跑通一个最小请求，再加入流式输出、工具调用、参考图、任务轮询等能力。
- 在用量页核对请求记录和费用。
基础信息
生产环境地址：x-api-key。Gemini 原生接口还接受 x-goog-api-key 或 ?key=。除非客户端有特殊要求，统一使用 Bearer。
结果处理
不同类型接口的返回形态不同：- 文本结果通常在
choices[0].message.content或 Responses 的输出数组中。 - 图片结果可能是 URL，也可能是 base64。
- 视频和音乐通常是任务模式，先返回任务 ID，再查询状态和结果。
- 文件类接口需要区分上传、查看、下载和删除。
面向 AI 工具
文档站支持这些 AI 工具读取方式：- Copy as Markdown：把页面转换为适合 LLM 阅读的 Markdown。
skill.md：让 agent 快速理解 Kaien API 的能力、接口边界和接入顺序。- MCP 文档服务：说明当前自托管静态部署下的 MCP 接入边界。