文本与对话

按请求协议选择 Chat、Responses、Claude Messages 或 Gemini 原生接口,并复制最小请求。

Chat Completions

官方文档: OpenAI Chat Completions API

请求路径为 POST /v1/chat/completions,必填字段是 modelmessages

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":"你好"}]
  }'

常用参数包括 temperaturetop_p max_tokensmax_completion_tokens streamtoolstool_choice response_format。流式请求将 stream 设置为 true,并使用支持 SSE 的客户端读取响应。

Responses

官方文档: OpenAI Responses API

请求路径为 POST /v1/responses,必填字段是 modelinput。Responses 与 Chat Completions 的请求体不通用,不要发送 messages 字段。

cURL
curl "https://ikun.love/v1/responses" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "input": "解释一下 API 网关",
    "instructions": "用中文简短回答"
  }'

常用参数包括 instructionsmax_output_tokensstreamtoolstool_choice reasoningprevious_response_id。请先确认模型列表中的端点类型包含 Responses。

Responses Compact:请求路径为 POST /v1/responses/compact,仅对模型列表中明确支持该端点的 OpenAI/Codex 模型使用。

Claude Messages

官方文档: Anthropic Messages API

请求路径为 POST /v1/messages,必填字段是 modelmax_tokensmessages。鉴权使用 x-api-key,并提供 anthropic-version: 2023-06-01

cURL
curl "https://ikun.love/v1/messages" \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-claude-model-id",
    "max_tokens": 512,
    "messages": [{"role":"user","content":"你好"}]
  }'
Claude Code 环境变量
ANTHROPIC_BASE_URL=https://ikun.love
ANTHROPIC_AUTH_TOKEN=sk-your-api-key

Claude Code 使用服务根地址,不要把 /v1 拼到 ANTHROPIC_BASE_URL 后面;All Token API 的 Claude Code 配置使用 ANTHROPIC_AUTH_TOKEN,对应 Bearer Token。

Gemini 原生对话

官方文档: Gemini Generate Content

请求路径为 POST /v1beta/models/{model}:generateContent,必填字段是 contents。使用 x-goog-api-key 鉴权,不能把 OpenAI 的 messages 请求体直接发送到 Gemini 路径。

cURL
curl "https://ikun.love/v1beta/models/your-gemini-model-id:generateContent" \
  -H "x-goog-api-key: sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role":"user","parts":[{"text":"你好"}]}]
  }'

流式调用将动作改为 streamGenerateContent,通常添加 ?alt=sse

传统 Completions

官方文档: OpenAI Completions API

请求路径为 POST /v1/completions,必填字段是 modelprompt。新模型优先使用 Chat 或 Responses。

cURL
curl "https://ikun.love/v1/completions" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-model-id","prompt":"Once upon a time","max_tokens":64}'

继续查看 多模态接口 兼容性与限制