SDK 与 cURL

OpenAI、Anthropic 官方 SDK 与 cURL 调用示例。

Python

使用官方 openai SDK，只需替换 base_url 与 api_key。全部模型都可以通过 Chat Completions 调用，网关会自动转换为对应厂商的原生协议。

from openai import OpenAI

client = OpenAI(
    base_url="https://api.compassapi.ai/v1",
    api_key="sk-你的密钥",
)

resp = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(resp.choices[0].message.content)

Node.js

同样使用官方 openai 包。请把密钥放在服务端环境变量中，不要打包进前端代码。

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.compassapi.ai/v1",
  apiKey: process.env.COMPASS_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "gpt-6.1-terra",
  messages: [{ role: "user", content: "用一句话介绍你自己" }],
});
console.log(resp.choices[0].message.content);

Anthropic SDK

Claude 模型支持原生 Messages 协议，可直接使用 anthropic SDK；缓存写入与读取按官方规则分别计费。

import anthropic

client = anthropic.Anthropic(
    base_url="https://api.compassapi.ai",
    api_key="sk-你的密钥",
)

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)

cURL

用 cURL 快速验证密钥是否可用。返回 401 说明密钥无效，返回 403 说明模型或 IP 不在该密钥的白名单内。

curl https://api.compassapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-5-5",
    "messages": [{"role": "user", "content": "ping"}]
  }'