创建令牌
登录控制台，为项目生成独立的 API Key。
API-AISURA / DOCS
用一个接口，开始调用模型。
API-AiSura 提供 OpenAI-compatible 的调用入口。创建自己的访问令牌后，只需替换 Base URL，即可沿用熟悉的 SDK 与调用方式。
设置 Base URL
将客户端的服务地址切换到 API-AiSura。
发起请求
选择可用模型，发送第一条对话请求。
开始使用
创建访问令牌
进入控制台的令牌页创建访问令牌。令牌只会在创建时完整展示一次，请立即保存到安全的服务端环境变量中。
推荐做法
为每个应用、环境或团队创建独立令牌。需要停止某个应用的访问时，只需撤销对应令牌，不会影响其他服务。
开始使用
基础地址
所有 OpenAI-compatible 请求都以以下 Base URL 开始。页面会根据你当前打开的域名自动生成正确地址。
正在获取地址...
请求需要携带 Bearer Token：
Authorization: Bearer YOUR_API_KEYAPI 调用
Chat Completions
使用 /chat/completions 发起对话请求。将 MODEL_ID 替换为模型与价格页显示的可用模型标识。
curl __API_BASE__/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [
{"role": "user", "content": "你好，请用一句话介绍自己。"}
]
}'| 字段 | 类型 | 说明 |
|---|---|---|
model | string | 必填。使用模型页列出的模型 ID。 |
messages | array | 必填。按 OpenAI Chat Completions 格式传递消息。 |
stream | boolean | 可选。设为 true 时，服务以 SSE 流式返回内容。 |
API 调用
查询可用模型
调用模型列表接口，获取当前令牌可使用的模型。实际可用范围会随账号权限与平台配置变化。
curl __API_BASE__/models \
-H "Authorization: Bearer YOUR_API_KEY"API 调用
兼容性说明
平台的主接入方式遵循 OpenAI-compatible 规范。不同模型的能力和参数支持情况不同，请以模型页说明及实际测试结果为准。
Chat Completions适合常规对话与流式输出
OpenAI SDK可通过替换 Base URL 复用
流式响应使用 SSE 逐段接收内容
高级能力函数调用、视觉等取决于模型
账户与用量
模型与价格
模型列表和价格以模型与价格页的当前展示为准。将模型 ID 直接填入请求中的 model 字段即可。
上线前检查
先使用少量请求验证目标模型、上下文长度、流式输出和工具调用是否符合你的应用预期，再将其用于正式流量。
账户与用量
用量与结算
在我的用量中查看自己的请求记录、模型调用和用量明细。控制台展示的数据用于日常核对；请在发布前确认你的应用已正确处理失败请求和重试。
请求模型处理用量记录控制台查看
参考
错误与重试
生产环境请记录响应状态码和请求标识，避免对同一请求进行无上限重试。
| 状态 | 常见原因 | 建议处理 |
|---|---|---|
400 | 请求字段或模型 ID 不正确 | 检查请求体和模型参数。 |
401 | 令牌缺失、无效或已撤销 | 检查服务端保存的 API Key。 |
403 | 令牌权限或可用额度不足 | 在控制台检查令牌配置与账户状态。 |
429 | 请求过于频繁或临时受限 | 采用指数退避后再试。 |
5xx | 服务或模型暂时不可用 | 有限次数重试，并保留失败记录。 |
参考
密钥安全
- 只在服务端或受控的密钥管理系统中保存 API Key。
- 不要把令牌提交到 Git 仓库、前端代码、截图或日志中。
- 每个环境使用不同令牌；怀疑泄露时立即撤销并重新生成。
- 对可能产生费用的请求设置应用侧限流、预算和告警。
准备开始？