文档

十分钟完成接入
不用重新学习协议

接口路径、请求体和流式格式都与 OpenAI 兼容。已有项目通常只需替换 API 地址和 Key，即可开始调用。

快速开始

在控制台创建 API Key，然后按下面的示例发起请求。完整 Key 只展示一次，请及时保存到环境变量中。

curl https://api.suanlimiao.com/v1/chat/completions \
  -H "Authorization: Bearer $SLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.8-max",
    "messages": [{"role": "user", "content": "你好"}]
  }'

接口地址

https://api.suanlimiao.com/v1可继续使用 /chat/completions、/embeddings、/models 等标准路径

OpenAI 兼容范围

算力喵会把统一请求转换成各厂商的接口格式。下表列出当前已兼容的能力；暂未支持的参数不会生效，并会在响应头中说明。

能力	支持	说明
流式输出	全部模型	SSE 流式返回，以 data: [DONE] 结束，格式与 OpenAI 一致
工具调用	全部模型	tools / tool_choice 归一化后转发
JSON 模式	多数模型	response_format 不被支持的模型会返回 400
多模态输入	视觉模型	image_url 支持 URL 与 base64
推理参数	推理模型	reasoning_effort 按厂商档位映射
批量接口	暂不支持	可用并发请求替代，网关不做排队

客户端与工具

支持自定义 API 地址的工具都可以接入，下面列出三种常见用法。

Claude Code

在 shell 配置中写入以下变量，CLI 就会通过算力喵调用模型。

~/.zshrc

export ANTHROPIC_BASE_URL="https://api.suanlimiao.com"
export ANTHROPIC_AUTH_TOKEN="sk-slm-..."

Cursor / IDE

在模型设置中选择 OpenAI 兼容，填入 API 地址和 Key，再从模型名录复制 model 名称。

settings

Base URL:  https://api.suanlimiao.com/v1
API Key:   sk-slm-...
Model:     qwen3.8-max

OpenAI SDK

官方 Python / Node SDK 无需改动调用逻辑，只需配置 API 地址和 Key。

.env

OPENAI_BASE_URL=https://api.suanlimiao.com/v1
OPENAI_API_KEY=sk-slm-...

错误码与重试

网关沿用 OpenAI 的错误结构，额外信息会放在响应头中，便于定位问题。

401: Key 无效或已吊销; 检查 Authorization 头，不要带多余空格
402: 余额不足; 充值后立即恢复，无需等待
429: 密钥或厂商限流; 读取 Retry-After，退避后重试；也可配置备用模型
502: 厂商上游异常; 网关已自动重试一次；持续出现请查看状态页
504: 上游超时; 长输出建议开启流式，避免整段超时

合规与数据

国内模型的请求由国内节点处理，不经过境外链路。调用海外模型时，仅该次请求的输入输出会发往对应厂商的境外服务。

请求日志默认保留 7 天，也可以在控制台关闭正文记录，只保留模型、耗时和 token 用量。日志不用于训练。

面向公众提供服务时，请按《生成式人工智能服务管理暂行办法》完成相应备案与内容安全措施；企业客户可索取数据处理协议（DPA）。

发票与合同

充值完成后在控制台「财务」页申请发票，抬头与税号填写后 1 个工作日开出，支持电子专票与普票。需要年度框架合同或 SLA 附件的，写信到 hi@suanlimiao.com。

十分钟完成接入不用重新学习协议