3 分钟接入 ofox.ai：Python / Node.js / cURL 快速指南

3 分钟接入 ofox.ai：Python / Node.js / cURL 快速指南

ofox.ai 完全兼容 OpenAI API 格式。如果你用过 OpenAI 的 SDK，接入 ofox.ai 只需要改两个参数：base_url 和 api_key。

本文覆盖 Python、Node.js、cURL 三种方式，以及 Cursor、Claude Code 等 AI 编程工具的配置方法。

准备工作

  1. 访问 ofox.ai 注册账号
  2. 在控制台创建 API Key
  3. 新账号赠送免费额度，可以直接开始测试

拿到 API Key 后，下面选择你的开发语言。

Python

安装 OpenAI Python SDK：

pip install openai

发起第一次调用：

from openai import OpenAI

client = OpenAI(
    api_key="your-ofox-api-key",
    base_url="https://api.ofox.ai/v1"
)

response = client.chat.completions.create(
    model="anthropic/claude-sonnet-4.5",
    messages=[
        {"role": "system", "content": "你是一个有帮助的助手。"},
        {"role": "user", "content": "用一句话解释什么是 API 网关"}
    ]
)

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

流式输出（SSE）

对于需要实时显示响应的场景，使用 stream=True：

stream = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[{"role": "user", "content": "写一首关于编程的短诗"}],
    stream=True
)

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

多模型切换

同一个 client 实例，只改 model 参数：

models = ["anthropic/claude-sonnet-4.5", "openai/gpt-4o", "deepseek/deepseek-v3.2"]

for model in models:
    resp = client.chat.completions.create(
        model=model,
        messages=[{"role": "user", "content": "1+1=?"}]
    )
    print(f"{model}: {resp.choices[0].message.content}")

Node.js

安装 OpenAI Node.js SDK：

npm install openai

发起调用：

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'your-ofox-api-key',
  baseURL: 'https://api.ofox.ai/v1',
});

const response = await client.chat.completions.create({
  model: 'anthropic/claude-sonnet-4.5',
  messages: [
    { role: 'system', content: '你是一个有帮助的助手。' },
    { role: 'user', content: '用一句话解释什么是 API 网关' },
  ],
});

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

流式输出

const stream = await client.chat.completions.create({
  model: 'openai/gpt-4o',
  messages: [{ role: 'user', content: '写一首关于编程的短诗' }],
  stream: true,
});

for await (const chunk of stream) {
  const content = chunk.choices[0]?.delta?.content;
  if (content) process.stdout.write(content);
}

cURL

不依赖任何 SDK，直接用 HTTP 请求：

curl https://api.ofox.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-ofox-api-key" \
  -d '{
    "model": "anthropic/claude-sonnet-4.5",
    "messages": [
      {"role": "user", "content": "用一句话解释什么是 API 网关"}
    ]
  }'

任何支持 HTTP 请求的语言或工具都可以用同样的方式调用。

在 AI 编程工具中使用

Cursor

打开 Settings → Models → OpenAI API Key：

  • API Key: 填入你的 ofox.ai key
  • Base URL: https://api.ofox.ai/v1
  • Model: 选择你想用的模型，如 anthropic/claude-sonnet-4.5、openai/gpt-4o

配置完成后，在 Cursor 的对话窗口里可以自由切换所有已接入的模型。

Claude Code

在 Claude Code 的设置中配置自定义 API endpoint：

API Provider: OpenAI Compatible
Base URL: https://api.ofox.ai/v1
API Key: your-ofox-api-key

Cherry Studio / 其他工具

所有支持 OpenAI 兼容 API 的工具都可以用同样的方式配置。只需要填入 ofox.ai 的 base_url 和 api_key。

在 LangChain / Dify 中使用

LangChain

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="anthropic/claude-sonnet-4.5",
    api_key="your-ofox-api-key",
    base_url="https://api.ofox.ai/v1"
)

response = llm.invoke("用一句话解释 RAG")
print(response.content)

Dify

在 Dify 的模型供应商设置中选择「OpenAI-API-compatible」，填入：

  • API Key: 你的 ofox.ai key
  • API Base: https://api.ofox.ai/v1
  • Model Name: 填入具体模型名称

常见问题

返回 401 Unauthorized

检查 API Key 是否正确。确保请求头的格式是 Authorization: Bearer sk-xxx。

返回 429 Too Many Requests

并发请求过多。ofox.ai 会自动做负载均衡和重试，但如果持续遇到 429，可以适当降低并发数或联系客服提升额度。

模型名称怎么填

在 ofox.ai 控制台 查看完整的可用模型列表和对应名称。常用模型名称：

模型model 参数值
Claude Sonnet 4.5anthropic/claude-sonnet-4.5
Claude Opus 4.6anthropic/claude-opus-4.6
GPT-4oopenai/gpt-4o
GPT-4o miniopenai/gpt-4o-mini
DeepSeek V3deepseek/deepseek-v3.2
Gemini 2.5 Progoogle/gemini-2.5-pro

下一步

相关阅读

← All posts