OpenAI 兼容 API

青柠AI 网关兼容 OpenAI Chat Completions 调用方式。多数项目只需要替换 base_url 或 baseURL，就可以把请求路由到 Claude、OpenAI、Gemini、DeepSeek 等模型，而不必重写现有业务代码。

迁移方式

Base URL

curl 示例

curl https://deepseek.callaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer csk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {
        "role": "user",
        "content": "用三句话介绍 青柠AI"
      }
    ]
  }'

Python SDK

from openai import OpenAI

client = OpenAI(
    api_key="csk-your-api-key",
    base_url="https://claude.callaiapi.com/v1",
)

response = client.chat.completions.create(
    model="claude-sonnet-4-20250514",
    messages=[{"role": "user", "content": "Hello"}],
)

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

Node.js SDK

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "csk-your-api-key",
  baseURL: "https://openai.callaiapi.com/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "Hello" }],
});

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

LangChain

在 LangChain 中使用 OpenAI-compatible provider，把 base URL 改成 青柠AI 网关地址即可。

import { ChatOpenAI } from "@langchain/openai";

const model = new ChatOpenAI({
  apiKey: "csk-your-api-key",
  configuration: {
    baseURL: "https://openai.callaiapi.com/v1",
  },
  model: "gpt-4o",
});

Vercel AI SDK

如果你使用 Vercel AI SDK，可以通过 OpenAI-compatible provider 指向 青柠AI 网关。

import { createOpenAI } from "@ai-sdk/openai";
import { generateText } from "ai";

const openai = createOpenAI({
  apiKey: "csk-your-api-key",
  baseURL: "https://openai.callaiapi.com/v1",
});

const result = await generateText({
  model: openai("gpt-4o"),
  prompt: "生成一个客服欢迎语",
});

console.log(result.text);

环境变量

建议把 API Key 和 Base URL 放进环境变量，避免写死在代码中。

CALLSTACK_API_KEY="csk-your-api-key"
CALLSTACK_BASE_URL="https://openai.callaiapi.com/v1"
CALLSTACK_MODEL="gpt-4o"

迁移检查清单

常见错误

401 或鉴权失败

检查 Authorization 请求头是否是 Bearer csk-your-api-key，并确认 API Key 没有被删除或复制错。

模型不存在

确认模型 ID 是否属于当前 Base URL。例如 DeepSeek 模型应使用 https://deepseek.callaiapi.com/v1，Claude 模型应使用 https://claude.callaiapi.com/v1。

本地可以，线上失败

优先检查线上环境变量是否完整，尤其是 API Key、Base URL 和模型 ID。其次检查服务器网络、代理和请求超时设置。

下一步

1. 创建 API Key。
2. 选择一个 模型 和对应 Base URL。
3. 用上面的 curl 示例跑通第一次请求。
4. 把现有项目里的 OpenAI 配置替换成 青柠AI 配置。
5. 到控制台查看用量和余额。

相关页面

• AI API 快速开始
• LangChain 接入 青柠AI
• Vercel AI SDK 接入 青柠AI
• 创建 API Key
• 模型目录