MetaSai API · 大模型接口文档

Quickstart · 01

三步接入，立即可用

无需修改任何业务代码，将原本的 OpenAI base_url 替换即可。兼容所有官方 SDK。

// 01

注册并获取密钥

登录控制台创建 API Key，建议同时创建生产 / 测试两套密钥以便轮换。

// 02

替换 base_url

将 https://api.openai.com/v1 替换为 https://openai.metasai.cn/v1，其它参数保持不变。

// 03

发起请求

使用任何 OpenAI / Anthropic 官方 SDK 直接调用，业务代码零侵入。

GPT · 02

调用 GPT 系列模型

完整兼容 OpenAI Chat Completions 接口，支持 GPT-4o、GPT-4 Turbo、GPT-3.5 Turbo 等模型。

Python

Node.js

cURL

# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="sk-ms-xxxxxxxxxxxxxxxx",
    base_url="https://openai.metasai.cn/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "你是一名资深架构师"},
        {"role": "user",   "content": "如何设计一个高并发短链服务？"},
    ],
    temperature=0.7,
    max_tokens=1024,
)

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

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

const client = new OpenAI({
  apiKey: "sk-ms-xxxxxxxxxxxxxxxx",
  baseURL: "https://openai.metasai.cn/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [
    { role: "system", content: "你是一名资深架构师" },
    { role: "user",   content: "如何设计一个高并发短链服务？" },
  ],
  temperature: 0.7,
  max_tokens: 1024,
});

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

# 命令行调用
curl https://openai.metasai.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-ms-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      { "role": "system", "content": "你是一名资深架构师" },
      { "role": "user",   "content": "如何设计一个高并发短链服务？" }
    ],
    "temperature": 0.7,
    "max_tokens": 1024
  }'

请求参数

model

string

必填。模型 ID，例如 gpt-4o、gpt-4-turbo、gpt-3.5-turbo。

messages

array

必填。对话历史，按时间顺序排列。每一项包含 role 和 content。

temperature

number

采样温度，范围 0 ~ 2。越高越发散，越低越确定。建议 0.7。

max_tokens

integer

生成的最大 token 数。包含输入输出的总长度受模型上下文窗口限制。

stream

boolean

是否使用流式输出，置为 true 时按 SSE 协议逐块返回。

top_p

number

核采样阈值，范围 0 ~ 1。建议与 temperature 二选一调整。

Claude · 03

调用 Claude 系列模型

通过 OpenAI 兼容协议调用 Claude 3.5 / 3.7 / Sonnet / Haiku / Opus，无需使用 anthropic-sdk。

Python

Node.js

cURL

# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="sk-ms-xxxxxxxxxxxxxxxx",
    base_url="https://openai.metasai.cn/v1",
)

resp = client.chat.completions.create(
    model="claude-3-5-sonnet-20241022",
    messages=[
        {"role": "user", "content": "用一段话比较 GPT-4o 与 Claude 3.5 的差异"},
    ],
    max_tokens=2048,
)

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

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

const client = new OpenAI({
  apiKey: "sk-ms-xxxxxxxxxxxxxxxx",
  baseURL: "https://openai.metasai.cn/v1",
});

const resp = await client.chat.completions.create({
  model: "claude-3-5-sonnet-20241022",
  messages: [
    { role: "user", content: "用一段话比较 GPT-4o 与 Claude 3.5 的差异" },
  ],
  max_tokens: 2048,
});

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

curl https://openai.metasai.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-ms-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "messages": [
      { "role": "user",
        "content": "用一段话比较 GPT-4o 与 Claude 3.5 的差异" }
    ],
    "max_tokens": 2048
  }'

提示

MetaSai 同时透传 /v1/messages 原生 Anthropic 协议，适合需要使用 tools、vision、system 拆分等高级能力的场景。请求头请使用 x-api-key 而非 Authorization。

Streaming · 04

流式输出，边生成边返回

将 stream 置为 true 即按 Server-Sent Events 协议逐块返回，首 token 延迟可低至 200ms。

Python

Node.js

cURL

stream = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "写一首关于星空的现代诗"}],
    stream=True,
)

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

const stream = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "写一首关于星空的现代诗" }],
  stream: true,
});

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

curl https://openai.metasai.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-ms-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -N --no-buffer \
  -d '{
    "model": "gpt-4o",
    "stream": true,
    "messages": [
      { "role": "user",
        "content": "写一首关于星空的现代诗" }
    ]
  }'

# 输出形如：data: {"choices":[{"delta":{"content":"星"}}]}
#        data: {"choices":[{"delta":{"content":"空"}}]}
#        data: [DONE]

Auth · 05

鉴权方式

所有请求必须在请求头携带 API Key，泄露后请立即在控制台禁用并轮换。

# 标准 Bearer Token 方式（推荐）
Authorization: Bearer sk-ms-xxxxxxxxxxxxxxxx

# Anthropic 原生协议（透传 /v1/messages 时使用）
x-api-key: sk-ms-xxxxxxxxxxxxxxxx
anthropic-version: 2023-06-01