快速开始
本指南将帮助你在 1 分钟内 完成玄州API 的接入，开始使用大模型。
前置条件
- 一个已注册的 玄州API 账号
- 账户余额大于 0
- 至少创建了一个 API Key
如果还没有账号，请先查看 注册与充值 指南。
第一步：获取 API Key
登录 控制台，进入「密钥管理」页面，点击「添加令牌」创建你的 API Key。
详细步骤请参考 创建 API Key。
第二步：发送第一个请求
将以下示例中的 sk-xxxxxxxx 替换为你的 API Key，然后运行：
bash
curl https://xuanzhouapi.top/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx" \
-d '{
"model": "gpt-5.5",
"messages": [
{"role": "system", "content": "你是一个有帮助的助手"},
{"role": "user", "content": "介绍一下你自己"}
]
}'成功响应示例：
json
{
"id": "chatcmpl-xxx",
"object": "chat.completion",
"created": 1712345678,
"model": "gpt-5.5",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "你好！我是 GPT-5.5，一个由 OpenAI 训练的大语言模型..."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 20,
"completion_tokens": 25,
"total_tokens": 45
}
}第三步：集成到你的应用
使用官方 SDK（Python）
python
from openai import OpenAI
client = OpenAI(
base_url="https://xuanzhouapi.top/v1",
api_key="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
)
response = client.chat.completions.create(
model="gpt-5.5",
messages=[
{"role": "user", "content": "用 Python 写一个快速排序"}
]
)
print(response.choices[0].message.content)使用官方 SDK（Node.js）
javascript
import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://xuanzhouapi.top/v1',
apiKey: 'sk-xxxxxxxxxxxxxxxxxxxxxxxx'
});
const response = await client.chat.completions.create({
model: 'claude-sonnet-4-6',
messages: [
{ role: 'user', content: '解释什么是闭包' }
]
});
console.log(response.choices[0].message.content);支持的模型
玄州API 支持 20+ 主流模型，通过同一个 API Key 即可访问：
| 厂商 | 模型 |
|---|---|
| OpenAI | gpt-5.5, gpt-5.5-s, gpt-5.4, gpt-5.4-s, gpt-image-2 |
| Anthropic | claude-opus-4-7, claude-opus-4-7-s, claude-opus-4-6, claude-sonnet-4-6 |
| DeepSeek | deepseek-v4-pro, deepseek-v4-flash |
| gemini-3.5-flash | |
| 字节豆包 | doubao-seed-2.0-pro, doubao-seed-2.0-lite, doubao-seed-2.0-code |
| 智谱 | glm-5.1 |
| 月之暗面 | kimi-k2.6, K2.6-code-preview |
| 面壁 | mimo-v2.5 |
完整价格和模型详情请查看 模型价格 页面。
下一步
查看以下教程，了解如何在常用客户端中使用玄州API：