快速开始：密钥与模型
完成模型发现与第一条文本请求。
1. 创建 API 密钥
打开 AIMirrorX 控制台，登录并在令牌/API 密钥管理页面创建令牌。按需要配置分组、模型权限、额度和有效期；界面名称以当前控制台为准。
密钥属于机密，保存在服务器环境变量中，不要写入前端代码、Git 仓库或公开截图。丢失或泄露时在控制台撤销并重新创建。文档示例只使用占位值。
export AIMIRRORX_API_KEY='YOUR_API_KEY'2. 查询可用模型
curl https://api.aimirrorx.com/v1/models \
-H "Authorization: Bearer $AIMIRRORX_API_KEY"从响应 data[].id 中选择当前令牌可见且支持目标协议的模型，将下面的 MODEL_ID_FROM_V1_MODELS 替换为其真实 ID。不要假定文档中出现的上游模型名称已经开放。
3. 发送 Chat Completions 请求
curl https://api.aimirrorx.com/v1/chat/completions \
-H "Authorization: Bearer $AIMIRRORX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"MODEL_ID_FROM_V1_MODELS","messages":[{"role":"user","content":"你好"}]}'支持流式的模型可添加 "stream": true，并用 curl -N 读取 SSE。流式连接中断不代表上游一定未执行；在自动重试前核对用量与请求日志，避免重复计费。
4. 使用 SDK
OpenAI 兼容 SDK 的 base_url 通常应设为 https://api.aimirrorx.com/v1，SDK 自己拼接 /chat/completions。不要填完整接口地址或重复添加 /v1。具体 SDK 若自行添加 /v1，则使用根地址。
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["AIMIRRORX_API_KEY"],
base_url="https://api.aimirrorx.com/v1")
response = client.chat.completions.create(
model="MODEL_ID_FROM_V1_MODELS",
messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)常见问题
401：检查密钥、鉴权头与有效期。不要把控制台登录凭据当作 API 密钥。403或无可用渠道：检查令牌的分组、模型权限与渠道支持。404：检查是否重复拼接/v1，或误用了文档站域名。429：遵循服务端限流信息，使用有上限的退避重试。5xx或超时：记录时间、模型、接口、响应中的请求 ID（如有）及脱敏错误，联系控制台提供的支持入口；不要附真实密钥。