接入文档
即通AI 完整兼容 OpenAI 接口协议。如果你已经在用 OpenAI SDK，通常只需要改一个 base_url。
快速开始
接入即通AI 一共三步：注册拿到密钥 → 替换接口地址 → 发起调用。整个过程通常不超过五分钟。
https://api.0311.cc/v1；密钥格式：sk- 开头；协议：与 OpenAI REST API 一致。第 1 步 · 获取 API 密钥
登录控制台，在「API 密钥」页面点击新建，为密钥起一个名字（建议按用途区分，例如 prod-app），保存后复制完整密钥。
- 密钥只在创建时完整显示一次，请立即妥善保存。
- 不要把它写进前端代码或公开仓库；如怀疑泄露，可在同页面立即删除并重新生成。
- 可以为不同项目创建不同密钥，方便分别统计用量，也能单独停用某一把。
第 2 步 · 发出第一个请求
把下面的 sk-你的密钥 换成真实密钥即可：
curl https://api.0311.cc/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-你的密钥" \ -d '{ "model": "qwen3.8-max-0902", "messages": [{"role": "user", "content": "你好"}] }'
返回结果的结构与 OpenAI 完全一致：
{
"id": "chatcmpl-...",
"object": "chat.completion",
"choices": [
{ "index": 0, "message": { "role": "assistant", "content": "你好！有什么可以帮你？" } }
],
"usage": { "prompt_tokens": 9, "completion_tokens": 12, "total_tokens": 21 }
}usage 里的 token 数就是本次扣费依据，也可在控制台「用量」中核对。
认证方式
所有接口都通过请求头携带密钥认证：
Authorization: Bearer sk-你的密钥
也兼容部分客户端使用的 x-api-key 头。密钥缺失或无效会返回 401。
接口地址与端点
基础地址（Base URL）：
https://api.0311.cc/v1
| 端点 | 方法 | 用途 |
|---|---|---|
| /v1/chat/completions | POST | 对话补全，支持流式 |
| /v1/images/generations | POST | 图片生成 |
| /v1/models | GET | 列出当前可用的模型 |
模型名以控制台「模型」页中的名称为准，也可直接调 /v1/models 获取。
常用请求参数
| 参数 | 类型 | 说明 |
|---|---|---|
| model | string | 必填。模型名称。 |
| messages | array | 必填。对话消息列表，每项含 role 与 content。 |
| stream | boolean | 是否流式返回，默认 false。 |
| temperature | number | 采样温度，常用 0–2，默认 1。 |
| max_tokens | integer | 限制本次生成的最大 token 数。 |
| top_p | number | 核采样，与 temperature 二选一调节即可。 |
流式输出
把 stream 设为 true，服务端会以 SSE 逐块推送，适合聊天类界面边生成边显示：
from openai import OpenAI client = OpenAI(api_key="sk-你的密钥", base_url="https://api.0311.cc/v1") stream = client.chat.completions.create( model="glm-5.2", messages=[{"role": "user", "content": "写一首关于秋天的短诗"}], stream=True, ) for chunk in stream: if chunk.choices and chunk.choices[0].delta.content: print(chunk.choices[0].delta.content, end="")
支持的客户端
任何允许自定义 OpenAI 接口地址的客户端都可以接入，在设置里把 API 地址填成 https://api.0311.cc/v1、密钥填自己的即可。常见的如：
- Cherry Studio、Lobe Chat、DeepChat、AionUI 等桌面 / 网页聊天客户端
- 各类代码编辑器与 CLI 工具（把 base_url 指向本站）
- 自研应用：直接使用 OpenAI 官方 SDK，替换 base_url 与 api_key
控制台「API 信息」页会针对部分客户端生成一键导入配置，可直接复制使用。
错误码
错误响应为 JSON，error.message 会说明具体原因。常见情况：
| 状态码 | 含义 | 处理建议 |
|---|---|---|
| 400 | 请求格式或参数有误 | 检查请求体是否为合法 JSON、必填字段是否缺失 |
| 401 | 密钥无效或未携带 | 确认 Authorization: Bearer sk-... 是否正确、密钥是否已删除 |
| 403 | 无权限调用该模型，或余额不足 | 确认模型是否开放给当前分组；到控制台查看剩余余额 |
| 429 | 请求过于频繁 | 降低并发或加入退避重试 |
| 5xx | 上游或服务端异常 | 稍后重试；持续出现请提交工单并附上请求时间 |
常见问题
调用时提示余额不足怎么办？
到控制台「充值」页充值后即可继续使用。余额不足时接口会明确返回错误，不会静默失败。
模型名写错会怎样？
会返回模型不存在或无权访问的错误。建议先在「模型广场」页面确认准确名称，或调用 /v1/models 获取列表。
费用是怎么扣的？
按实际产生的输入与输出 token 数计费，见 价格方案。每次调用的消耗明细可在控制台「用量」中逐条查看。
支持哪些编程语言？
协议与 OpenAI 一致，因此任何有 OpenAI SDK 或能发 HTTP 请求的语言都可以使用，不必依赖特定 SDK。