接入文档

完全兼容 OpenAI SDK。已有项目只需替换 base_url 和 api_key,其余代码零改动。

01拿到 API Key

  1. 1. 用邮箱注册账户,无需信用卡
  2. 2. 在控制台用支付宝或微信充值,实时到账
  3. 3. 进入「令牌」页面创建一个 Key,复制备用

⚠️ Key 等同于你的钱包。不要写死在前端代码里,不要提交到 Git 仓库。 建议放环境变量,并在代码里设置调用次数上限——死循环烧额度是最常见的事故。

02接口地址

把原来的官方地址换成:

https://api.yunmengapi.com/v1

同一个 Key 支持三种协议,按你的客户端选一个:

POST https://api.yunmengapi.com/v1/chat/completions

# 最通用。绝大多数客户端和 SDK 都支持,
# 只需把 base_url 改成上面这个地址。

03发起对话请求

curl https://api.yunmengapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "你好"}]
  }'

04生图请求

生图按张计费,不按 token。size 决定计费档位:1024×1024 走 1K 价(¥0.05/张),更高分辨率走 4K 价(¥0.145/张)。生成失败不扣费。

curl https://api.yunmengapi.com/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只在雪地里打滚的柴犬,电影感光线",
    "size": "1024x1024",
    "n": 1
  }'

05常用客户端配置

Claude Code

设置环境变量 ANTHROPIC_BASE_URL 指向本站,ANTHROPIC_AUTH_TOKEN 填你的 Key。

Cherry Studio

设置 → 模型服务 → 添加提供商 → 选 OpenAI 兼容 → 填入 API 地址和 Key。

Cline / Roo Code

API Provider 选 OpenAI Compatible,Base URL 和 API Key 按下方填。

LobeChat / NextChat

在设置里把 OpenAI 接口地址改成本站地址即可。

06错误码

状态码含义怎么办
401认证失败Key 错误、已吊销,或请求头格式不对
402额度不足账户余额用完了,去控制台充值
404模型不存在模型名拼写错误,或该模型未在你的分组开放
429请求过快触发限流,降低并发或稍后重试
500上游异常上游波动,通常会自动切换渠道,建议重试
503暂时不可用所有渠道都不可用,请稍后再试
接入前请务必知道

本站是独立第三方网关,与模型厂商无授权关系。经由本站的请求,上游链路可能附加系统级指令, 会影响模型的措辞风格和自我描述,但不影响函数调用的正确性。 查看完整差异说明 →