发起第一个请求

本文带你从零发起第一次调用。开始前请确认：

1. 已创建 API 密钥并保存了完整密钥。
2. 已拿到 Base URL：登录控制台，在「快速接入」弹窗中选择协议后复制。下文示例用 https://<your-base-url> 代替，请替换成你自己的地址。

平台支持三种原生协议，任选其一即可——三者的计费与额度完全一致。

OpenAI 兼容协议（默认推荐）

与 OpenAI SDK 完全兼容，把 base_url 指向平台即可复用现有代码。

cURL

curl https://<your-base-url>/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Python（openai SDK）

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://<your-base-url>",
)

completion = client.chat.completions.create(
    model="your-model",
    messages=[{"role": "user", "content": "Hello"}],
)
print(completion.choices[0].message.content)

Node.js（openai SDK）

import OpenAI from "openai"

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://<your-base-url>",
})

const completion = await client.chat.completions.create({
  model: "your-model",
  messages: [{ role: "user", content: "Hello" }],
})
console.log(completion.choices[0].message.content)

Anthropic 协议

与 Anthropic Messages API 同构，鉴权头为 x-api-key，需携带 anthropic-version：

curl https://<your-base-url>/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Gemini 协议

与 Google GenAI 接口同构，模型 ID 直接写进路径，鉴权头为 x-goog-api-key：

curl "https://<your-base-url>/v1beta/models/your-model:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Hello"}]}]
  }'

检查结果

请求成功会返回模型生成的回复（OpenAI 协议在 choices[0].message.content）。随后你可以：

• 到控制台「用量」页核对本次消耗与余额变化；
• 在「模型广场」把 your-model 换成真实模型 ID（支持文本、图像、音频、视频、文件等模态）。

首次调用常见报错

生产环境建议：密钥放环境变量（如 OPENAI_API_KEY），不要硬编码；用官方 SDK 而非手写 HTTP 调用，协议兼容性由 SDK 兜底。