Chat Completions API
POST /v1/chat/completions 参考，涵盖消息格式、模型选择、流式响应、用量统计和错误处理。
创建对话补全。此端点兼容 OpenAI，并支持流式响应、工具调用和 JSON 模式。
端点
POST https://api.leaper.one/v1/chat/completions参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型 ID。内置模型："auto"、"gpt-5-nano"、"gpt-5.4"、"gpt-5.4-mini"、"gpt-5.5"、"claude-fable-5"、"claude-opus-4-{6,7,8}"、"claude-sonnet-{5,4-6}"、"claude-haiku-4-5"、"deepseek-v4-flash"、"deepseek-v4-pro"。也可以使用 "openrouter/{provider}/{model}" 调用 OpenRouter 的 350 多个模型 |
| messages | array | 是 | 消息对象数组，每项包含 "role"（system/user/assistant）和 "content" |
| stream | boolean | 否 | 为 true 时通过 SSE 返回增量消息。默认：false |
| temperature | number | 否 | 0-2 之间的采样温度。默认：0.7 |
| top_p | number | 否 | 核采样参数。默认：1 |
| max_tokens | integer | 否 | 最多生成的 token 数 |
| stop | string | array | 否 | 最多 4 个停止序列 |
| tools | array | 否 | 模型可以调用的工具定义列表 |
| tool_choice | string | object | 否 | "none"、"auto"，或指定某个函数 |
| response_format | object | 否 | JSON 模式使用 { "type": "json_object" } |
请求
curl -X POST https://api.leaper.one/v1/chat/completions \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "auto",
"messages": [
{ "role": "system", "content": "You are a helpful assistant." },
{ "role": "user", "content": "What is LEAPERone?" }
],
"temperature": 0.7,
"max_tokens": 256
}'响应
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1700000000,
"model": "gpt-5-nano",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "LEAPERone is a unified AI API gateway that gives you access to multiple AI models through a single API key."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 25,
"completion_tokens": 22,
"total_tokens": 47
}
}注意事项
"auto"默认路由到gpt-5-nano。stream为true时，接口通过 Server-Sent Events（SSE）返回增量内容，并以[DONE]消息结束。- 按最终解析出的模型和实际 token 用量计费。
- OpenRouter 模型：使用
"openrouter/{provider}/{model}"（例如"openrouter/anthropic/claude-sonnet-4.6"）调用 350 多个模型。价格透传自 OpenRouter。详情参阅 Chat Completions 指南。