快速开始

三步发出第一次请求:拿到密钥,设置 Base URL,调用接口。

1. 获取 API 密钥

在控制台登录并创建密钥:https://swato.ai/login。

密钥形如 sk-...。每个密钥都属于一个分组,分组的平台(OpenAI / Anthropic / Google)决定你使用哪套协议面。详见鉴权。

把密钥放进环境变量,后续示例都从这里读取:

export SWATOWAPI_KEY="sk-..."

2. Base URL

按你密钥分组的平台选择对应的 Base URL:

协议面	Base URL	环境变量
OpenAI 兼容	https://swato.ai/v1	OPENAI_BASE_URL
Anthropic 兼容	https://swato.ai	ANTHROPIC_BASE_URL(客户端追加 /v1/messages)
Gemini 兼容	https://swato.ai/v1beta	Gemini SDK / CLI

TIP

国内(汕拓智算)用户使用国内控制台自身的来源作为 Base URL,路径结构完全一致。本文以 https://swato.ai 作为示例来源。

3. 你的第一次请求

下面对 https://swato.ai/v1/chat/completions 发起一次 Chat Completions 调用。鉴权用请求头 Authorization: Bearer $SWATOWAPI_KEY。

curl

curl https://swato.ai/v1/chat/completions \
  -H "Authorization: Bearer $SWATOWAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      { "role": "user", "content": "用一句话介绍汕拓智算。" }
    ]
  }'

Python

# pip install openai
from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["SWATOWAPI_KEY"],
    base_url="https://swato.ai/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.5",  # 仅作示例,确切 ID 见 GET /v1/models
    messages=[
        {"role": "user", "content": "用一句话介绍汕拓智算。"},
    ],
)

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

Node

// npm install openai
import OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "gpt-5.5", // 仅作示例,确切 ID 见 GET /v1/models
  messages: [
    { role: "user", content: "用一句话介绍汕拓智算。" },
  ],
});

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

TIP

上面的 gpt-5.5 仅为示例。确切的 model ID 请调用 GET /v1/models 获取,以服务端返回为准。

Anthropic 风格客户端

如果你用的是 Anthropic SDK,把 ANTHROPIC_BASE_URL 指向 https://swato.ai,客户端会调用 /v1/messages。注意:此时需要使用分组平台为 Anthropic 的密钥。

curl https://swato.ai/v1/messages \
  -H "Authorization: Bearer $SWATOWAPI_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 256,
    "messages": [
      { "role": "user", "content": "用一句话介绍汕拓智算。" }
    ]
  }'

流式输出

在请求体中加入 "stream": true,即可以服务器发送事件(SSE)逐块接收响应。OpenAI 与 Anthropic 协议面均支持:

curl https://swato.ai/v1/chat/completions \
  -H "Authorization: Bearer $SWATOWAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "stream": true,
    "messages": [{ "role": "user", "content": "讲个短笑话。" }]
  }'

下一步

• 鉴权 — 密钥、分组与平台。
• 模型 — 在售模型与如何取确切 ID。
• 路由与回退 — 自动选路与失败回退。
• API 参考 — 全部端点。