三分钟上手

从零到调通第一次 API 调用

注册 → 零代码生图 / 拿额度 → 建令牌 → 调用,全流程图文指引。兼容 OpenAI 接口格式,会调 OpenAI 就会用谐波AI。

1注册账号

打开 wdwds.cn/register,用户名 + 邮箱 + 密码即可完成注册,无需实名。

已有账号直接 登录:想先玩生图跳到第 4 步,要接 API 从第 3 步开始。

2获取额度(兑换码)

付钱前先看懂换算:500,000 quota = $1 额度 · $1 额度 = ¥5 · ¥10 体验包 = $2 额度。控制台余额按美元计,各模型单价在 定价页 按百万 token(或按次)计费。

当前充值方式为兑换码:加客服微信 KK0011388 购买,拿到一串 32 位兑换码,下一步用它充值。

在线充值即将上线,上线前请加客服微信 KK0011388 购买兑换码。技术交流 QQ 群:664933198(模型问题、报错排查群里都有人管)。

3兑换充值

登录后进入 控制台 → 左侧菜单 「钱包」「兑换码充值」,粘贴兑换码确认,额度即时到账。

兑换即时到账,余额在控制台「钱包」实时可查。

4零代码生图(新手推荐第一步)

不写代码也能先用起来:登录后打开 wdwds.cn/playground,切到「生图」页签,输入提示词,出图直接下载。

1024 图约 $0.006/张——注册送的 $1 体验金约可生 160 张,先玩明白再决定要不要接 API。

路径:登录 → 顶部导航 Playground →「生图」页签 → 输入提示词 → 出图下载。

5创建 API 令牌

控制台 → 「令牌」「添加令牌」:名称随意(如 my-key),额度选「无限额度」,分组选 default,保存后复制 sk- 开头的密钥

密钥只显示一次,丢了只能删掉重建。别把密钥发到群里/提交到 GitHub。

6发起第一次调用

接口地址(Base URL):https://wdwds.cn/v1,与 OpenAI 格式完全兼容。

curl 示例(对话):

# 模型名按需替换,全部在售模型见 /pricing
curl https://wdwds.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-k3",
    "messages": [{"role": "user", "content": "你好,介绍一下你自己"}]
  }'

Python 示例(用官方 openai 库直接改 base_url):

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://wdwds.cn/v1"
)

resp = client.chat.completions.create(
    model="kimi-k3",
    messages=[{"role": "user", "content": "你好"}]
)
print(resp.choices[0].message.content)
第三方工具(Cherry Studio、NextChat、LobeChat 等)里选「OpenAI / 自定义渠道」,Base URL 填 https://wdwds.cn/v1 + 你的密钥即可直接用。

常见问题

报 401 是什么意思?

密钥不对:检查 Authorization 头里的 sk- 令牌是否完整、是否被删掉重建过。

报 403 insufficient quota?

额度不足:去控制台「钱包」看余额,找客服充值,或在「兑换码充值」输入新兑换码。

视频模型怎么计费?

视频生成类模型(文生视频/图生视频)按次计费,单价见定价页,生成失败不计费。

支持流式输出吗?

支持。请求加 "stream": true 即可,SSE 格式与 OpenAI 一致。

能开发票/对公吗?

可以,加客服微信 KK0011388 说明需求。