云雾API怎么用?3分钟新手教程:注册、创建Key到第一次调用(2026)

云雾API · 教程 · 更新于 2026-07-13

📌 本文要点
- 核心三步：注册（免费额度自动到账）→「令牌」页创建 sk- Key → base_url 指向 https://api.yunwu.cloud/v1
- 最容易踩的坑：Claude 系模型名必须带日期后缀（如 claude-sonnet-4-5-20250929）
- 不写代码也能用：NextChat / Cursor / Claude Code 都只需填地址、Key、模型名
- 适合人群：第一次使用 API 中转站的新手

后台客服被问得最多的一句话就是:"注册完了,然后呢?"这篇把从注册到跑通第一个请求的完整流程写清楚,总共三步,照着做 3 分钟够了。已经注册过的可以直接登录从第二步开始看。

三步接入云雾API:注册→创建令牌→发起调用

一、注册:免费测试额度自动到账

打开注册页,用邮箱注册一个账号。注册成功后,免费测试额度会自动到账,不需要找客服领,进控制台就能直接调模型。之后每天签到,还能续领一点额度。

我们建议的顺序是:先用免费额度把整个流程跑通,确认模型输出、延迟都符合你的预期,再考虑充值。第一次充值建议先充几块钱试试水——本站最低 1 元起充,人民币支付,约 0.5 元兑 1 美元 token 额度,充得多有阶梯折扣(以充值页面实际显示为准)。充值的详细步骤我们单独写过一篇:《云雾API怎么充值》,这里不重复。

二、创建令牌(就是你的 API Key)

登录后进入控制台,点控制台菜单里的「令牌」;
点添加令牌,给它起个名字。这一步可以顺手设置额度上限——如果你有多个项目,建议一个项目建一个令牌、分别限额,月底在「日志」里逐条看调用明细,哪个项目烧钱多一眼就能看出来;
创建完成后,复制那串 sk- 开头的字符串,存好。

顺带提醒一句:别把 Key 写死在要推上 GitHub 的代码里。Key 泄露被人刷掉额度,只能自己认,用环境变量存是最省心的做法。

三、跑通第一个请求(Python 示例)

本站是 OpenAI 兼容接口,base_url 填 https://api.yunwu.cloud/v1,原来用 OpenAI SDK 写的代码基本都能直接迁过来。最小可运行示例:

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的令牌",
    base_url="https://api.yunwu.cloud/v1"
)

resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "用一句话介绍你自己"}]
)
print(resp.choices[0].message.content)

想换模型,只改 model 字段。命名规则记两条就行:

gpt-4o、gemini-2.5-pro、deepseek-v3 这类直接写名字;
Claude 系必须带日期后缀,例如 claude-sonnet-4-5-20250929,不带后缀会报"模型不存在"一类的错误。

模型名书写规则:Claude 系必须带日期后缀

本站支持 200+ 模型,完整调用名和单价都在模型价格表里,复制粘贴即可。除了 OpenAI 格式,本站也兼容 Claude、Gemini 的接口格式,细节见文档教程。

跑完这个请求,回控制台「日志」里刷新一下,能看到这条调用消耗了多少 token、扣了多少额度——第一次建议看一眼,心里对成本有个数。

四、在客户端里用:NextChat / ChatBox / Cursor / Claude Code

不写代码也能用。所有客户端接入其实就填三样东西:接口地址、Key、模型名(界面细节以客户端当前版本为准):

客户端接入三要素:接口地址、API Key、模型名

NextChat / ChatBox 这类聊天客户端:在设置里选自定义接口(或 OpenAI 兼容),API 地址填 https://api.yunwu.cloud/v1,Key 填你的 sk- 令牌,模型名按上面的规则填;
Cursor:在设置中把 API 地址改成 https://api.yunwu.cloud/v1,填入 Key 即可;
Claude Code:通用做法是设置两个环境变量——ANTHROPIC_BASE_URL=https://api.yunwu.cloud 和 ANTHROPIC_AUTH_TOKEN=你的Key(注意这里不带 /v1,具体以文档教程为准),模型用 claude-sonnet-4-5-20250929 这类带日期后缀的写法。

常见问题 FAQ

云雾API 免费额度有多少?怎么领?
注册即送、自动到账,具体金额以页面显示为准;每日签到可以续领。用免费额度就能完成本文全部步骤。

云雾API 有月费或最低消费吗?
没有。按量计费,余额按实际 token 用量扣减,不用不扣钱。注意不同模型有分组倍率,同样一段话不同模型的花费不一样,单价看价格表。

调用报 401 或"模型不存在"怎么办?
先查三处:Key 是否完整复制(sk- 开头)、base_url 是否带了 /v1、Claude 系模型名是否带日期后缀。都对还报错,去「日志」看具体返回,或直接找客服支持。

能开对公充值 / 大额充值吗?
可以,联系客服支持处理,适合公司报销和团队用量。

一个账号能给多个项目用吗?
能。在「令牌」里给每个项目单独建 Key、单独设额度上限,互不影响,日志里也分得清。

三步到这就全部跑通了。趁免费额度还在，把你真实业务的请求发几条，看看延迟和输出质量，合适再充值。

相关阅读:《云雾API怎么充值》 · 模型价格表 · 文档教程 · 注册入口