接入文档

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

01拿到 API Key

1. 用邮箱注册账户,无需信用卡
2. 在控制台用支付宝或微信充值,实时到账
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生图请求

按张计费,生成失败不扣费。1K 与 4K 是两个独立模型名——计费按模型名结算,不看 size 参数: 用 4K 模型却传 1024×1024,仍按 4K 单价扣费;1K 模型不支持 4K 尺寸,传了会被直接拒绝(不扣费)。

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

# 4K 换成 "model": "gpt-image2-4k" 并传 "size": "3840x2160"

05生成视频

视频是异步的:提交任务拿到 task_id,轮询到 completed 后下载。整段约 1–3 分钟。按秒计费,总价 = 每秒单价 × duration,不填默认 4 秒。

# ① 提交任务
curl https://api.yunmengapi.com/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-720p",
    "prompt": "一只橘猫在草地上慢慢走过,阳光,电影感",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'
# → {"task_id": "task_xxx", "status": "queued", "seconds": "5"}

# ② 轮询,直到 status 变成 completed
curl https://api.yunmengapi.com/v1/videos/task_xxx \
  -H "Authorization: Bearer $API_KEY"
# → {"status": "completed", "progress": 100, "url": "https://..."}

# ③ 下载上一步返回的 url(无需鉴权)

视频地址是临时的,请及时下载或转存。生成结果不长期保留,不要把返回的 url 当作长期存储引用。

06模型怎么选

Anthropic · Claude

claude-opus-5 / sonnet-5 / haiku-4-5 / fable-5

长上下文与复杂编码最强,指令遵循严谨。缓存命中后输入价大幅下降,长对话和代码库场景最划算。

OpenAI · GPT

gpt-5.4 / 5.4-mini / 5.5 / 5.6-sol / 5.6-terra

通用能力均衡,生态与工具链最成熟。mini 系列适合批量分类、摘要这类高频低难度任务。

OpenAI · 图像

gpt-image2-1k / gpt-image2-4k

文生图与图生图,指令遵循准确。1K 适合草稿与配图,4K 为原生 3840×2160,可直接印刷。

Google · 图像

gemini-3-pro-image-preview

高分辨率直出,单张最高 5504×3072、300 DPI。传 quality="4K" 与 size(画幅)取高清结果。

字节跳动 · 视频

seedance 系列共 7 个

480p 到 4K 全覆盖,按秒计费。2.0 系列支持 4–15 秒,seedance2.5 支持到 30 秒并可用多图/视频/音频参考。

所有厂商的文本模型都能用同一个 OpenAI 兼容端点调用,换 model 字段即可,其余代码不用改。完整价格见价格页。

07常用客户端配置

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 接口地址改成本站地址即可。

08错误码

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

接入前请务必知道

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