注册账号

点击右上角「登录 / 注册」进入 /signin，用邮箱完成注册。新账号默认有免费额度，无需绑定信用卡即可开始调用。

创建 API Key

登录后在控制台找到「API Keys」，点击创建。Key 只会完整显示一次，请立即复制并妥善保存。建议为不同项目创建独立 Key，方便分别统计用量、单独吊销。

发起第一个请求

DrAI 的接口与 OpenAI 完全兼容，base_url 为 https://ai.dr-ai.top/v1。以下是 Python 示例：

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的Key",
    base_url="https://ai.dr-ai.top/v1"
)

resp = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[
        {"role": "system", "content": "你是一个友好的中文助手。"},
        {"role": "user", "content": "用一句话介绍 DrAI"}
    ],
    stream=False
)
print(resp.choices[0].message.content)

也可以先用 curl 验证连通性：

curl https://ai.dr-ai.top/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的Key" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [{"role": "user", "content": "你好"}]
  }'

流式输出（推荐）

对交互式应用，建议开启流式以降低首字延迟：

stream = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[{"role": "user", "content": "写一首关于代码的诗"}],
    stream=True
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

查看模型列表

调用 GET https://ai.dr-ai.top/v1/models 可以获取当前可用的全部模型 ID。不同套餐可见的模型范围不同，升级套餐即可解锁更多模型与更高额度。

常见错误排查

401 Unauthorized：API Key 错误或已失效，检查是否多了空格、换行。404 model not found：模型 ID 拼写错误，或当前套餐不含该模型，先查 /v1/models。429 Too Many Requests：触发速率限制，指数退避重试或升级套餐。超时：网络波动时重试，或改用流式输出。