文本 API 教程

FoxAPI 完全兼容 OpenAI Chat Completions API 格式，所有支持 OpenAI 的工具都可以直接使用。

接口地址

POST https://foxapi.chat/v1/chat/completions

Claude 模型用户注意

使用 Claude 模型（如 claude-sonnet-4）时，base URL 不能加 /v1 后缀：

• ✅ 正确：https://foxapi.chat
• ❌ 错误：https://foxapi.chat/v1

前置条件

1. 拥有一个 FoxAPI Key（获取教程）
2. 确认你要使用的模型（模型列表）

基本用法

curl

curl https://foxapi.chat/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.6-flash",
    "messages": [
      {"role": "system", "content": "你是一个有帮助的助手"},
      {"role": "user", "content": "用一句话介绍量子计算"}
    ]
  }'

Python（openai 库）

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的Key",
    base_url="https://foxapi.chat/v1"
)

response = client.chat.completions.create(
    model="qwen3.6-flash",
    messages=[
        {"role": "system", "content": "你是一个有帮助的助手"},
        {"role": "user", "content": "用一句话介绍量子计算"}
    ]
)

print(response.choices[0].message.content)

Node.js / TypeScript

import OpenAI from "openai";

const openai = new OpenAI({
    apiKey: "sk-你的Key",
    baseURL: "https://foxapi.chat/v1",
});

const completion = await openai.chat.completions.create({
    messages: [{ role: "user", "content": "用一句话介绍量子计算" }],
    model: "qwen3.6-flash",
});

console.log(completion.choices[0].message.content);

流式输出

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的Key",
    base_url="https://foxapi.chat/v1"
)

stream = client.chat.completions.create(
    model="qwen3.6-flash",
    messages=[{"role": "user", "content": "讲一个故事"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

可用模型

国产模型

模型	简介	输入/M	输出/M	折扣
qwen3.7-max	千问旗舰，智能体首选	¥9.60	¥28.80	8折
qwen3.7-plus	千问高性价比，多模态	¥1.60	¥6.40	8折
qwen3.6-max-preview	千问3.6最强，编程顶尖	¥7.65	¥45.90	8.5折
qwen3.6-plus	千问3.6视觉增强	¥1.70	¥10.20	8.5折
qwen3.6-flash	千问3.6快速推理	¥1.02	¥6.12	8.5折
qwen-max	千问2.5超大规模	¥1.56	¥6.24	6.5折
GLM-5	智谱旗舰744B	¥3.30	¥12.10	5.5折
GLM-5.1	智谱最新，持续工作8小时	¥4.40	¥15.40	5.5折
GLM-5.2	智谱开源SOTA	¥4.40	¥15.40	5.5折
Kimi-K2.6	Kimi最强Agent	¥3.58	¥14.85	5.5折
DeepSeek-R1-0528	深度求索推理模型	¥2.20	¥8.80	5.5折
deepseek-v4-flash	DeepSeek V4快速	¥1.00	¥2.00	原价
deepseek-v4-pro	DeepSeek V4高级	¥3.00	¥6.00	原价
MiniMax-M3	1M超长上下文	¥2.10	¥8.40	原价

海外模型（Azure官方Key）

模型	简介	输入/M	输出/M	折扣
gpt-5.4	OpenAI最新旗舰	¥12.58	¥75.48	7.4折
gpt-5.2	OpenAI高性能	¥8.81	¥70.45	7.4折
gpt-chat-latest	OpenAI对话最新	¥25.16	¥150.96	7.4折
grok-4.3	xAI旗舰	¥15.10	¥75.48	7.4折

响应格式

{
    "id": "chatcmpl-xxx",
    "object": "chat.completion",
    "created": 1781526640,
    "model": "qwen3.6-flash",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "量子计算是一种利用量子力学原理进行计算的技术..."
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 12,
        "completion_tokens": 2058,
        "total_tokens": 2070
    }
}

常见问题

Q: 模型名怎么填？

直接填模型全名，如 qwen3.7-max、gpt-5.4。不需要加前缀。

Q: 支持 function calling 吗？

支持。FoxAPI 完全兼容 OpenAI 的 function calling 格式。

Q: 支持 vision（图片理解）吗？

支持。使用支持视觉的模型（如 qwen3.7-plus），在 messages 中传入图片 URL 即可。