云雾 API (yunwu.ai) 使用教程

2026-06-11 AI 整理 rainforcetime

云雾 API (yunwu.ai) 使用教程

高速、稳定的 AI API 中转站 — 无需代理，直连全球 AI 模型

1. 什么是云雾 API

云雾 API（yunwu.ai） 是一个 OpenAI 格式兼容的 API 中转站，主要面向国内开发者。它将 OpenAI、Anthropic Claude、Google Gemini、xAI Grok、DeepSeek、通义千问、智谱 GLM、Kimi、MiniMax 等 450+ 款模型统一为一个接口，使用标准的 OpenAI API 格式即可调用。

核心优势：

✅ 无需代理 — 全球直连，国内可直接访问
✅ 无需外币卡 — 人民币充值，支付宝/微信即可
✅ 1 元起充 — 极低门槛体验
✅ OpenAI SDK 兼容 — 改一行 base_url 即可迁移
✅ 支持流式输出 (SSE) — 所有聊天模型均支持
✅ 99.9% 可用性 — 号称高稳定性

2. 支持模型一览

截至 2025 年中，云雾 API 共托管 450+ 模型。以下是精选列表：

对话/推理模型

厂商	模型
OpenAI	`gpt-5.2`, `gpt-5.2-codex`, `gpt-5.1`, `gpt-5-pro`, `gpt-5`
Anthropic	`claude-opus-4-5`, `claude-sonnet-4-5`, `claude-haiku-4-5`
Google	`gemini-3-pro-preview`
xAI	`grok-4.1`, `grok-4`
DeepSeek	`deepseek-v3.2`, `deepseek-r1`
阿里	`qwen3-max`
智谱	`glm-4.6`
月之暗面	`kimi-k2-thinking`
MiniMax	`minimax-m2`

图像生成

模型
`gpt-image-2`, `gpt-image-1.5`
`flux-2-pro`, `flux.1-kontext-pro`
`qwen-image-2.0`, `grok-4.2-image`
`doubao-seedream-5-0-260128`

视频生成

模型
`sora-2`, `veo3.1`
`kling-2.6`, `viduq3`, `viduq3-pro`
`seedance-1-5-pro`, `MiniMax-Hailuo-2.3`

Midjourney

操作
`mj_imagine`（文生图）, `mj_variation`（变体）, `mj_upscale`（放大）
`mj_reroll`（重新生成）, `mj_blend`（混合）, `mj_describe`（图生文）
`mj_zoom`（缩放）, `mj_pan`（平移）, `mj_inpaint`（局部重绘）

💡 提示：完整模型列表可调用 GET /v1/models 接口实时获取。

3. 注册与获取 API Key

付费用户

打开 yunwu.ai
点击注册，使用邮箱或手机号创建账户
进入控制台，选择充值（最低 1 元），支持支付宝/微信
充值后系统自动生成 API Key，在"API Keys"页面复制即可

免费用户

访问 free.yunwu.ai，使用 GitHub 账号登录即可获得免费 API Key，每日配额：

模型	每日限额
`gpt-4o`	30 次
`gpt-4o-mini`	200 次
DeepSeek 系列	30 次

4. 计费说明

项目	说明
计价方式	0.5 元 ≈ 1 USD 的 token 用量（约官网价格的 50%）
最低充值	1 元
并发限制	官方宣称无限制
计费单位	按模型实际 token 消耗扣费，与 OpenAI 计费方式一致

5. API 使用方法

5.1 基础信息

配置项	值
Base URL	`https://yunwu.ai/v1`（也支持 `https://api.yunwu.ai/v1`）
认证方式	`Authorization: Bearer <你的API_Key>`
Chat 端点	`POST /v1/chat/completions`
Embeddings	`POST /v1/embeddings`
图像生成	`POST /v1/images/generations`
语音转文字	`POST /v1/audio/transcriptions`
文字转语音	`POST /v1/audio/speech`
模型列表	`GET /v1/models`

5.2 Python (OpenAI SDK)

推荐方式，与官方 OpenAI 用法几乎一致：

from openai import OpenAI

# 初始化客户端，只需修改 base_url 和 api_key
client = OpenAI(
    base_url="https://yunwu.ai/v1",
    api_key="your-yunwu-api-key"  # 替换为你的 API Key
)

# 聊天补全（非流式）
response = client.chat.completions.create(
    model="gpt-5.2",
    messages=[
        {"role": "system", "content": "你是一个有帮助的助手。"},
        {"role": "user", "content": "请用一句话介绍人工智能。"}
    ]
)
print(response.choices[0].message.content)

# 聊天补全（流式 SSE）
stream = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[
        {"role": "user", "content": "写一首关于春天的诗"}
    ],
    stream=True
)
for chunk in stream:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="")

# 获取模型列表
models = client.models.list()
for model in models.data:
    print(model.id)

切换模型示例

# OpenAI
client.chat.completions.create(model="gpt-5.2", messages=[...])

# Claude
client.chat.completions.create(model="claude-sonnet-4-5", messages=[...])

# DeepSeek
client.chat.completions.create(model="deepseek-r1", messages=[...])

# Grok
client.chat.completions.create(model="grok-4.1", messages=[...])

# 通义千问
client.chat.completions.create(model="qwen3-max", messages=[...])

# Gemini
client.chat.completions.create(model="gemini-3-pro-preview", messages=[...])

5.3 Node.js / TypeScript

使用 OpenAI SDK

npm install openai

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://yunwu.ai/v1",
  apiKey: "your-yunwu-api-key",
});

async function main() {
  const completion = await client.chat.completions.create({
    model: "gpt-5.2",
    messages: [
      { role: "user", content: "你好，请介绍一下你自己" },
    ],
  });
  console.log(completion.choices[0].message.content);
}

main();

流式输出

const stream = await client.chat.completions.create({
  model: "claude-sonnet-4-5",
  messages: [{ role: "user", content: "讲一个笑话" }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

5.4 curl 命令行

# 非流式请求
curl https://yunwu.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.2",
    "messages": [
      {"role": "user", "content": "用一句话解释什么是量子计算"}
    ]
  }'

# 流式请求
curl https://yunwu.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.2",
    "messages": [
      {"role": "user", "content": "用一句话解释什么是量子计算"}
    ],
    "stream": true
  }'

# 查询可用模型列表
curl https://yunwu.ai/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

5.5 常用第三方客户端配置

云雾 API 兼容所有支持自定义 OpenAI Base URL 的客户端，在对应设置中填入以下信息即可：

配置项	填写内容
API Provider / 类型	OpenAI 或 OpenAI Compatible
Base URL / API 地址	`https://yunwu.ai/v1`
API Key	你的云雾 API Key

支持的客户端包括但不限于：

ChatBox（桌面端 AI 聊天）
LobeChat（自部署 AI 聊天）
ChatGPT Next Web（网页端聊天）
Cursor（AI 编程 IDE）— 在 Settings → Models 中添加
Cline（VS Code 插件）— 选择 OpenAI Compatible
Aider（终端 AI 编程）— 设置 OPENAI_API_BASE
Dify（AI 应用平台）
LangChain / llama_index（开发框架）
Immersive Translate（沉浸式翻译插件）
Zotero GPT（文献管理插件）
AutoGPT

📖 详细配置教程请参考官方文档站: yunwu.apifox.cn

6. Midjourney 绘图

Midjourney 接口使用单独的端点路径（不在 /v1 下），需通过 HTTP POST 提交任务并轮询结果。

发起绘图 (imagine)

curl -X POST https://yunwu.ai/mj/submit/imagine \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "prompt": "a beautiful sunset over the ocean, oil painting style --ar 16:9"
  }'

返回示例：

{
  "id": "task_id_xxx",
  "status": "pending"
}

查询任务结果

curl https://yunwu.ai/mj/task/task_id_xxx/fetch \
  -H "Authorization: Bearer YOUR_API_KEY"

其他 Midjourney 操作

操作	端点	说明
变体	`POST /mj/submit/variation`	基于某张图生成变体
放大	`POST /mj/submit/upscale`	放大指定图像的某一格
混合	`POST /mj/submit/blend`	多图混合
图生文	`POST /mj/submit/describe`	根据图片生成 prompt
缩放	`POST /mj/submit/zoom`	缩放图像
平移	`POST /mj/submit/pan`	平移扩展图像
局部重绘	`POST /mj/submit/inpaint`	局部修改
重新生成	`POST /mj/submit/reroll`	重新随机生成

7. 视频生成

视频生成是异步任务，提交后需轮询结果：

from openai import OpenAI

client = OpenAI(
    base_url="https://yunwu.ai/v1",
    api_key="your-yunwu-api-key"
)

# 提交视频生成任务
response = client.post("/v1/video/submit", json={
    "model": "sora-2",
    "prompt": "一只猫在太空站里失重漂浮",
    "size": "1920x1080",
    "duration": 10
})

task_id = response["id"]

# 轮询结果
import time
while True:
    result = client.get(f"/v1/video/{task_id}")
    if result["status"] == "completed":
        print(f"视频地址: {result['url']}")
        break
    time.sleep(10)

⚠️ 具体视频模型支持的参数有所不同，请以实际 API 文档为准。

8. 免费使用

free.yunwu.ai

如果你只想体验，可以不花一分钱：

打开 free.yunwu.ai
使用 GitHub 账号授权登录
获取免费 API Key（同上使用方法，base_url 不变）
每日免费额度自动刷新

免费配额示例

模型	每日免费调用次数
`gpt-4o`	~30
`gpt-4o-mini`	~200
`deepseek-v3` / `deepseek-r1`	~30

9. 常见问题

Q: 支持流式输出吗？

A: 支持。所有对话模型均支持 SSE（Server-Sent Events）流式输出，和 OpenAI 官方体验一致。

Q: API 调用报 401 错误怎么办？

A: 检查 Authorization 头是否正确，格式为 Bearer <API_Key>（注意 Bearer 后有空格）。确认 API Key 没有过期，且在控制台未被撤销。

Q: 支持 function calling / tools 吗？

A: 支持。任何原生支持 function calling 的模型（如 GPT-5、Claude 等）都可以通过标准 OpenAI tool 参数调用。

Q: 并发有限制吗？

A: 官方宣称无并发限制，但实际体验可能受账户等级影响。

Q: 如何查看余额和用量？

A: 登录 yunwu.ai 控制台即可查看实时余额、历史调用记录和 token 消耗明细。

Q: 退款怎么处理？

A: 充值余额不支持提现/退款（这是大部分中转站的通行做法），建议先 1 元起充体验。

Q: 数据安全吗？

A: 中转站可以看到你发送的内容。如果涉及敏感数据，建议直接使用模型官方 API，或对敏感内容做本地脱敏处理。

快速上手总结

# 三行代码，即可开始使用
from openai import OpenAI
client = OpenAI(base_url="https://yunwu.ai/v1", api_key="你的API_KEY")
print(client.chat.completions.create(model="gpt-5.2", messages=[{"role":"user","content":"你好！"}]).choices[0].message.content)

🔗 官网：yunwu.ai | 免费版：free.yunwu.ai | 文档站：yunwu.apifox.cn

本教程基于公开信息整理，具体功能与定价以官网最新公告为准。

作者：rainforcetime

链接：https://blog.mumudlin.com/index.php/云雾-api-yunwu-ai-使用教程/

文章版权归作者所有，未经允许请勿转载。

云雾 API (yunwu.ai) 使用教程

云雾 API (yunwu.ai) 使用教程

目录

1. 什么是云雾 API

2. 支持模型一览

对话/推理模型

图像生成

视频生成

Midjourney

3. 注册与获取 API Key

付费用户

免费用户

4. 计费说明

5. API 使用方法

5.1 基础信息

5.2 Python (OpenAI SDK)

切换模型示例

5.3 Node.js / TypeScript

使用 OpenAI SDK

流式输出

5.4 curl 命令行

5.5 常用第三方客户端配置

6. Midjourney 绘图

发起绘图 (imagine)

查询任务结果

其他 Midjourney 操作

7. 视频生成

8. 免费使用

free.yunwu.ai

免费配额示例

9. 常见问题

Q: 支持流式输出吗？

Q: API 调用报 401 错误怎么办？

Q: 支持 function calling / tools 吗？

Q: 并发有限制吗？

Q: 如何查看余额和用量？

Q: 退款怎么处理？

Q: 数据安全吗？

快速上手总结

常见问题