API

API 文档

一个密钥、一个兼容 OpenAI 的接口，即可访问目录中的全部模型。这里说明如何接入、各接口返回什么、用量如何计量，以及错误码的含义。

01

快速开始

  1. 在控制台「API 密钥」中创建密钥。密钥只在创建时显示一次，请妥善保存。
  2. 在客户端中设置基础 URL 和认证请求头。
  3. 向需要的接口发送请求，用量会自动从余额中扣除。
bash
curl https://llmall.store/v1/chat/completions \
  -H "Authorization: Bearer sk-llmall-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{ "role": "user", "content": "你好" }]
  }'
02

地址与认证

基础 URL：https://llmall.store/v1，与 OpenAI SDK 兼容，替换 base_url 即可。

密钥通过 Authorization 请求头以 Bearer 方式传递。密钥可随时暂停或吊销，吊销立即在网关生效。

03

接口

接口用途状态
POST /chat/completions对话，兼容 OpenAI 格式，支持流式返回可用
POST /messages对话，Anthropic Messages API 格式可用
GET /models当前密钥按策略可用的模型列表可用
POST /embeddings文本向量模型配置了供应商时可用
POST /images/generations图像生成模型配置了供应商时可用
POST /audio/speech, /audio/transcriptions语音合成与识别模型配置了供应商时可用
POST /videos/generations视频生成模型配置了供应商时可用

部分模型未配置供应商，会返回模拟结果（向量接口返回占位向量），仍会扣除 CU。生产环境使用前请先确认具体模型。

04

用量如何计量

单位是 CU（1 CU = 10 美元的计算成本）。不同模型按不同单位计费：每 1K 或 1M 令牌、每个向量、每张图片、每秒视频或每次请求，具体单位在模型卡片中标注。

目录价格同时以卢布和 CU 显示。模型价格按俄罗斯央行汇率换算；余额充值使用含支付渠道加价的汇率，因此同样用量的实际付款更高。确认支付前可在收银台看到差额。

充值方式：通过二维码使用 SBP（俄罗斯快速支付系统），或使用银行卡。最低 1 CU。

05

限额

密钥的月限额与日限额均为可选：不设置则没有上限，支出以账户余额为限。如设置了月限额且你拥有套餐，它不能超过套餐的月限额。

请求频率由平台侧限制。超限时返回 429，并带有 Retry-After 请求头，表示需要等待的秒数。

06

错误码

错误码含义处理方式
400 / 422请求格式错误或字段未知检查 JSON 结构与字段名
401密钥缺失、已吊销或无效检查 Authorization 请求头
403该模型被密钥策略禁止移除该模型或修改密钥策略
404路径不存在或模型未找到核对接口列表与 GET /models
429 insufficient_cu余额或密钥预算已耗尽充值或提高密钥限额
429 rate_limit_exceeded请求频率超限按 Retry-After 等待后重试
500网关内部错误稍后重试；持续出现请联系支持
503 provider_unavailable模型供应商不可用稍后重试或改用其他模型
07

控制台可设置的内容

密钥：名称、月度与每日 CU 限额（可选）、暂停与吊销。密钥仅在创建时显示一次。

充值：以 CU 或卢布填写金额，选择支付方式（SBP 二维码或银行卡）。最低 1 CU。

个人资料：名称、修改密码、已绑定的登录账号（Google、Yandex ID）。

组合（Combo）：把自己的模型集合放在一个名称下，请求发往其中最便宜且可用的模型，占用时转向次便宜者。

「数据脱敏」订阅：在转发给供应商之前识别并替换姓名、电话、邮箱、护照、СНИЛС/ИНН 与卡号，响应中再还原原文。标记与取值的对应关系只存在于进程内存中，不会被保存。

?

如果无法使用

  • 401 — 检查密钥是否完整，注意不要带入空格或换行。
  • 403 — 是当前密钥的策略禁止了该模型，与账号无关。
  • 429 的 insufficient_cu 与 rate_limit_exceeded 是两种不同原因，请看响应中的 type 字段。
  • 非对话接口返回空结果或异常结果 — 该模型未配置供应商，返回的是模拟结果。
  • 模型未找到 — 核对 GET /models，该列表会按密钥策略过滤。
创建账号 ← Back to llmall