千支API 文档
文本模型接入指南
文本模型用于聊天、写作、代码、Agent、工具调用等场景。当前站点主要按 OpenAI 兼容格式接入,Claude 模型也可按 Anthropic Messages 兼容格式调用。
OpenAI Base URL
https://api.qianzhiapi.com/v1
推荐文本接口
POST /v1/chat/completions
Claude 兼容接口
POST /v1/messages
在 Cursor、Cline、Roo Code、Dify、OpenAI SDK 等客户端里,Base URL
一般只填 https://api.qianzhiapi.com/v1。如果客户端要求完整接口地址,再填写
https://api.qianzhiapi.com/v1/chat/completions。
1. OpenAI Chat Completions
这是最通用、兼容性最好的文本接口,推荐所有普通聊天和 Agent 客户端优先使用。
curl https://api.qianzhiapi.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的APIKey" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4-mini",
"messages": [
{ "role": "user", "content": "用三句话介绍千支API" }
],
"temperature": 0.7
}'
2. Responses API
当前后端已开放 /v1/responses 路由。支持 Responses API 的客户端可以使用它;如果客户端兼容性不好,就切回 Chat Completions。
curl https://api.qianzhiapi.com/v1/responses \
-H "Authorization: Bearer sk-你的APIKey" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4-mini",
"input": "写一个简短的接口接入检查清单"
}'
3. Anthropic Messages 兼容调用
Claude 系列模型当前同时出现在 OpenAI 与 Anthropic 兼容端点里。使用 Anthropic 风格客户端时,可直接调用
/v1/messages。
curl https://api.qianzhiapi.com/v1/messages \
-H "Authorization: Bearer sk-你的APIKey" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 1024,
"messages": [
{ "role": "user", "content": "给我一个 API 接入测试方案" }
]
}'
4. SDK 示例
Python
from openai import OpenAI
client = OpenAI(
api_key="sk-你的APIKey",
base_url="https://api.qianzhiapi.com/v1",
)
resp = client.chat.completions.create(
model="gpt-5.4-mini",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
Node.js / TypeScript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-你的APIKey",
baseURL: "https://api.qianzhiapi.com/v1",
});
const resp = await client.chat.completions.create({
model: "gpt-5.4-mini",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);
5. 当前文本模型
下表来自当前线上价格接口。文本模型按输入/输出倍率计费,最终扣费还会受到用户分组倍率影响;实际展示和扣费以控制台价格页为准。
GPT / OpenAI / Codex
| 模型 | 输入倍率 | 输出倍率 | 接口 |
|---|---|---|---|
gpt-5.4-mini | 0.375 | 6 | OpenAI |
gpt-5.4-mini-openai-compact | 0.375 | 6 | OpenAI |
gpt-5.6-luna | 0.5 | 6 | OpenAI |
gpt-5.3-codex-spark | 0.875 | 8 | OpenAI |
gpt-5.3-codex-spark-openai-compact | 0.875 | 8 | OpenAI |
codex-auto-review | 0.875 | 8 | OpenAI |
gpt-5.4 | 1.25 | 6 | OpenAI |
gpt-5.4-openai-compact | 1.25 | 6 | OpenAI |
gpt-5.6-terra | 1.25 | 6 | OpenAI |
gpt-5.5 | 2.5 | 6 | OpenAI |
gpt-5.5-openai-compact | 2.5 | 6 | OpenAI |
gpt-5.6-sol | 2.5 | 6 | OpenAI |
Claude
| 模型 | 输入倍率 | 输出倍率 | 接口 |
|---|---|---|---|
claude-haiku-4-5-20251001 | 0.5 | 5 | OpenAI / Anthropic |
claude-sonnet-5 | 1 | 5 | OpenAI / Anthropic |
claude-sonnet-4-6 | 1.5 | 5 | OpenAI / Anthropic |
claude-opus-4-6 | 2.5 | 5 | OpenAI / Anthropic |
claude-opus-4-7 | 2.5 | 5 | OpenAI / Anthropic |
claude-opus-4-8 | 2.5 | 5 | OpenAI / Anthropic |
claude-opus-5 | 2.5 | 5 | OpenAI / Anthropic |
claude-fable-5 | 5 | 5 | OpenAI / Anthropic |
Gemini
| 模型 | 输入倍率 | 输出倍率 | 接口 |
|---|---|---|---|
gemini-2.5-flash-lite | 0.05 | 4 | OpenAI |
gemini-3.1-flash-lite | 0.125 | 6 | OpenAI |
gemini-3.1-flash-lite-preview | 0.125 | 6 | OpenAI |
gemini-2.5-flash | 0.15 | 8.333333 | OpenAI |
gemini-2.5-flash-nothinking | 0.15 | 8.333333 | OpenAI |
gemini-3-flash | 0.25 | 6 | OpenAI |
gemini-2.5-pro | 0.625 | 8 | OpenAI |
gemini-3.5-flash | 0.75 | 6 | OpenAI |
gemini-3.1-pro | 1 | 6 | OpenAI |
gemini-3.1-pro-low | 1 | 6 | OpenAI |
gemini-3.1-pro-high | 1 | 6 | OpenAI |
gemini-3-flash-preview | 37.5 | 4 | OpenAI |
gemini-3.1-pro-preview | 37.5 | 4 | OpenAI |
gemini-3.1-pro-preview-low | 37.5 | 4 | OpenAI |
Grok
| 模型 | 输入倍率 | 输出倍率 | 接口 |
|---|---|---|---|
grok-420-fast | 0.625 | 2 | OpenAI |
grok-4.20-auto | 0.625 | 2 | OpenAI |
grok-4.3-beta | 0.625 | 2 | OpenAI |
grok-4.5-low | 1 | 3 | OpenAI |
grok-4.5-high | 1 | 3 | OpenAI |
6. 常见错误
| 错误 | 原因 | 处理方式 |
|---|---|---|
401 Invalid token |
令牌错误、未传令牌或令牌已禁用。 | 重新复制 API Key,确认请求头是 Authorization: Bearer sk-...。 |
403 permission_error |
令牌分组无权调用该模型。 | 换有权限的模型,或联系管理员调整分组。 |
模型不存在 |
模型名拼写不一致,或该分组没有可用渠道。 | 从价格页复制模型名,注意大小写和符号。 |
余额不足 |
用户余额或令牌额度不足。 | 充值或调整令牌额度。 |