七牛云 AI API 接入
记录如何接入七牛云提供的 AI API，包括接入点、兼容接口和基础调用关注点。
#tech / ai
#type / howto
#status / growing
[!info] related notes
- 所属 MOC: AI MOC
- 相关主题: claude-ai, openai-codex
七牛云 AI API 接入
一句话定义
这篇笔记关注的是如何把七牛云提供的 AI 接口接进项目，而不是讨论模型原理。
接入前要准备什么
- 创建个人 API Key
- 确认主接入点或备接入点
- 确认你要调用的是 OpenAI 兼容接口还是 Anthropic 兼容接口
常见接入点
- 主接入点：
https://openai.qiniu.com/v1 - 备接入点：
https://api.qnaigc.com/v1
支持接口
| 接口名 | 说明 |
|---|---|
/v1/chat/completions | 对话推理接口，兼容 OpenAI 格式，支持图片和文件识别能力 |
/v1/models | 获取可用模型列表和参数 |
/v1/messages | 兼容 Anthropic API 格式 |
接入时最该关注什么
- 先确认接口协议兼容哪类 SDK
- 确认模型名、鉴权方式和搜索等附加能力的参数格式
- 用 Apifox 或最小脚本先验证可用性，再接入正式项目
最短记忆方式
先确认兼容协议和接入点，再验证鉴权、模型名和请求格式。