使用文档

快速开始

欢迎使用 晓渡 AI。本文档将帮助您在 5 分钟内完成从注册到第一次成功调用 API 的全流程。

第一步：注册账号

访问 注册页面，使用邮箱即可创建账户。注册成功后系统自动赠送 ¥1.00 体验额度，无需绑定支付方式。

新用户首次注册可填写邀请码额外获得 ¥0.5 加赠。

第二步：充值（可选）

体验额度用完后，前往 充值页面 进行充值。支持支付宝、微信、USDT、Stripe 等多种支付方式。

• 最低充值金额：¥10
• 充值 ¥100 加赠 ¥10，¥300 加赠 ¥40，¥1000 加赠 ¥200
• 余额永不过期

第三步：第一次对话

访问 聊天工作台，左上角下拉框选择心仪的模型，在底部输入框开始提问。

获取 API Key

登录后前往 开发者后台 → 我的密钥，点击 "创建新密钥" 生成 API Key。建议为不同项目创建独立 Key 便于管理。

API Key 格式：sk-xduai-XXXXXXXXXXXXXXXXXXXX
Base URL：     https://api.xduai.com/v1

API Key 只在创建时显示一次，请立即妥善保存。如遗失需重新创建。

接口端点

晓渡 API 完全兼容 OpenAI 协议规范。所有标准 OpenAI 客户端无需修改即可使用。

对话补全

POST https://api.xduai.com/v1/chat/completions

Headers:
  Authorization: Bearer sk-xduai-xxxxx
  Content-Type:  application/json

Body:
{
  "model": "claude-sonnet-4-5",
  "messages": [
    {"role": "user", "content": "你好"}
  ],
  "stream": true
}

支持的模型

当前支持 12+ 模型，可通过 GET /v1/models 查询完整列表。常用模型 ID：

• gpt-5 · gpt-4o · gpt-4o-mini
• claude-opus-4-7 · claude-sonnet-4-5 · claude-haiku-4-5
• gemini-2.5-pro · gemini-2.5-flash
• deepseek-chat · deepseek-reasoner
• doubao-pro-256k · qwen3-max · glm-4.6 · kimi-k2

SDK 与示例

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-xduai-xxxxx",
    base_url="https://api.xduai.com/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[{"role": "user", "content": "你好"}],
    stream=True
)

for chunk in response:
    print(chunk.choices[0].delta.content or "", end="")

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-xduai-xxxxx",
  baseURL: "https://api.xduai.com/v1"
});

const response = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "你好" }]
});

客户端配置 · Cherry Studio

Cherry Studio 是国人开发的多模型聊天客户端，强烈推荐。

1. 下载并安装 Cherry Studio
2. 设置 → 模型服务 → 添加
3. API URL：https://api.xduai.com/v1
4. API Key：填入你的 sk-xduai-xxxxx
5. 添加模型：自定义模型名（如 claude-sonnet-4-5）

团队管理

企业版支持创建团队，最多 50 个成员。联系销售 开通团队版。

私有部署

对数据合规有特殊要求的客户可选择私有部署方案。联系商务 获取报价。

文档持续完善中。有问题？联系我们