千支API 千支API 文档

文本模型接入指南

文本模型用于聊天、写作、代码、Agent、工具调用等场景。当前站点主要按 OpenAI 兼容格式接入,Claude 模型也可按 Anthropic Messages 兼容格式调用。

OpenAI Base URL https://api.qianzhiapi.com/v1
推荐文本接口 POST /v1/chat/completions
Claude 兼容接口 POST /v1/messages
Base URL 不要写成完整接口路径

在 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-mini0.3756OpenAI
gpt-5.4-mini-openai-compact0.3756OpenAI
gpt-5.6-luna0.56OpenAI
gpt-5.3-codex-spark0.8758OpenAI
gpt-5.3-codex-spark-openai-compact0.8758OpenAI
codex-auto-review0.8758OpenAI
gpt-5.41.256OpenAI
gpt-5.4-openai-compact1.256OpenAI
gpt-5.6-terra1.256OpenAI
gpt-5.52.56OpenAI
gpt-5.5-openai-compact2.56OpenAI
gpt-5.6-sol2.56OpenAI

Claude

模型 输入倍率 输出倍率 接口
claude-haiku-4-5-202510010.55OpenAI / Anthropic
claude-sonnet-515OpenAI / Anthropic
claude-sonnet-4-61.55OpenAI / Anthropic
claude-opus-4-62.55OpenAI / Anthropic
claude-opus-4-72.55OpenAI / Anthropic
claude-opus-4-82.55OpenAI / Anthropic
claude-opus-52.55OpenAI / Anthropic
claude-fable-555OpenAI / Anthropic

Gemini

模型 输入倍率 输出倍率 接口
gemini-2.5-flash-lite0.054OpenAI
gemini-3.1-flash-lite0.1256OpenAI
gemini-3.1-flash-lite-preview0.1256OpenAI
gemini-2.5-flash0.158.333333OpenAI
gemini-2.5-flash-nothinking0.158.333333OpenAI
gemini-3-flash0.256OpenAI
gemini-2.5-pro0.6258OpenAI
gemini-3.5-flash0.756OpenAI
gemini-3.1-pro16OpenAI
gemini-3.1-pro-low16OpenAI
gemini-3.1-pro-high16OpenAI
gemini-3-flash-preview37.54OpenAI
gemini-3.1-pro-preview37.54OpenAI
gemini-3.1-pro-preview-low37.54OpenAI

Grok

模型 输入倍率 输出倍率 接口
grok-420-fast0.6252OpenAI
grok-4.20-auto0.6252OpenAI
grok-4.3-beta0.6252OpenAI
grok-4.5-low13OpenAI
grok-4.5-high13OpenAI

6. 常见错误

错误 原因 处理方式
401 Invalid token 令牌错误、未传令牌或令牌已禁用。 重新复制 API Key,确认请求头是 Authorization: Bearer sk-...
403 permission_error 令牌分组无权调用该模型。 换有权限的模型,或联系管理员调整分组。
模型不存在 模型名拼写不一致,或该分组没有可用渠道。 从价格页复制模型名,注意大小写和符号。
余额不足 用户余额或令牌额度不足。 充值或调整令牌额度。