1. 准备信息
- 在 API Key 页面创建一枚密钥。
- 从对应协议的模型列表接口复制模型 ID。
- 按客户端要求填写 Base URL。
API Key 只放在服务端配置、受信任的本地客户端或环境变量中，不要提交到代码仓库、网页前端或公开日志。
| 客户端 | Base URL |
|---|---|
| OpenAI SDK、Cursor 等兼容客户端 | https://ikun.love/v1 |
| Claude Code、Gemini CLI | https://ikun.love |
| 直接发送 HTTP 请求 | https://ikun.love |
2. 获取模型 ID
OpenAI 兼容接口和 Claude 使用 /v1/models；Gemini 原生接口使用 /v1beta/models。不要把 Gemini 的 x-goog-api-key 请求发到 /v1/models。
OpenAI / Claude
curl "https://ikun.love/v1/models" \
-H "Authorization: Bearer sk-your-api-key"Gemini 原生接口
curl "https://ikun.love/v1beta/models" \
-H "x-goog-api-key: sk-your-api-key"OpenAI 兼容格式复制响应中的 data[].id，例如：
JSON
{
"id": "your-model-id",
"object": "model"
}- Gemini 格式复制响应中的
models[].name，调用时使用其中的模型 ID。 - OpenAI 格式还会返回
supported_endpoint_types，接口报能力不匹配时先检查该字段。
模型 ID 必须完全一致。不同 API Key 返回的模型可能不同。
3. 选择接口
本站只补充地址、鉴权和最小请求。字段含义、完整参数和响应结构请以官方文档为准。
| 用途 | 本站接口 | 官方文档 |
|---|---|---|
| 普通聊天 | POST /v1/chat/completions | OpenAI Chat Completions |
| 推理、工具调用、Codex | POST /v1/responses | OpenAI Responses |
| Claude 协议 | POST /v1/messages | Anthropic Messages |
| Gemini 原生协议 | POST /v1beta/models/{model}:generateContent | Gemini Generate Content |
| 图片 | POST /v1/images/generations | OpenAI Images |
| 音频（暂无模型） | POST /v1/audio/speech | OpenAI Audio |
| 视频（暂无模型） | POST /v1/videos | OpenAI Videos |
4. 第一次请求
cURL
curl "https://ikun.love/v1/chat/completions" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "your-model-id",
"messages": [{"role": "user", "content": "你好"}]
}'Python OpenAI SDK
from openai import OpenAI
client = OpenAI(
api_key="sk-your-api-key",
base_url="https://ikun.love/v1",
)
response = client.chat.completions.create(
model="your-model-id",
messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)认证头
| 协议 | 请求头 |
|---|---|
| OpenAI 兼容接口 | Authorization: Bearer sk-your-api-key |
| Anthropic | x-api-key: sk-your-api-key、anthropic-version: 2023-06-01 |
| Gemini | x-goog-api-key: sk-your-api-key |