登录 免费开始
文档目录

快速开始

更新于 2026-08-27

第一次调用只需要三样东西：一个账号、一把 API Key、一条 curl 命令，全程约 3 分钟。

第一步：注册并创建 Key

  1. 注册账号（邮箱验证码，免费）；
  2. 进入 控制台 → API Key，点击「创建 Key」；
  3. 完整 Key（sk- 开头）只在创建成功时展示一次，请立即复制保存。

妥善保管你的 Key

Key 等同于账户余额的使用权，请勿提交到代码仓库或公开粘贴。怀疑泄露时，在控制台禁用该 Key 并重建即可，余额不受影响。创建时还可以为 Key 设置额度上限与模型白名单来进一步控制风险。

第二步：选择协议与 Base URL

同一把 Key 在两种协议下通用：

协议Base URL适用 SDK / 客户端
OpenAI 兼容https://api.ai526.com/v1（带 /v1）openai 官方 SDK、绝大多数第三方客户端
Anthropic 兼容https://api.ai526.com（不带 /v1）anthropic 官方 SDK、Claude 系工具

鉴权两种写法等价，任选其一：

Authorization: Bearer sk-你的Key
x-api-key: sk-你的Key

第三步：发出第一条请求

模型 ID 以模型广场在架列表为准，下面以对话模型为例：

curl https://api.ai526.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "messages": [{"role": "user", "content": "用一句话介绍 API 网关"}]
  }'

返回 JSON 中 choices[0].message.content 即模型回复。每个响应都带 x-request-id 头，联系我们排障时请附上它。

SDK 示例

OpenAI SDK（Python）

from openai import OpenAI

client = OpenAI(base_url="https://api.ai526.com/v1", api_key="sk-你的Key")
r = client.chat.completions.create(
    model="claude-opus-5",
    messages=[{"role": "user", "content": "你好"}],
)
print(r.choices[0].message.content)

OpenAI SDK（Node.js）

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ai526.com/v1", apiKey: "sk-你的Key" });
const r = await client.chat.completions.create({
  model: "claude-opus-5",
  messages: [{ role: "user", content: "你好" }],
});
console.log(r.choices[0].message.content);

Anthropic SDK（Python）

import anthropic

client = anthropic.Anthropic(base_url="https://api.ai526.com", api_key="sk-你的Key")
msg = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)

注意两个 SDK 的 base_url 差异：OpenAI SDK 填 https://api.ai526.com/v1，Anthropic SDK 填 https://api.ai526.com（SDK 自行拼接 /v1/messages）。

流式输出

请求体加 "stream": true 即可，SSE 逐字返回：

r = client.chat.completions.create(
    model="claude-opus-5",
    messages=[{"role": "user", "content": "写一首关于大海的短诗"}],
    stream=True,
)
for chunk in r:
    print(chunk.choices[0].delta.content or "", end="")

先在 Playground 试一试

控制台的 Playground 可以直接选模型对话，实时显示本次消耗，适合调参与验证 Key 是否可用。

下一步