WuDi API / Documentation

从第一条请求开始

获取平台 Key，填写统一地址，再选择一个已开放的模型。这里的示例使用已经验证的 DeepSeek Flash。

在线支付通道尚未接通。如果需要充值，请联系客服：QQ号318401088

快速开始

注册账户并登录控制台。
进入「API 密钥」，为你的应用创建独立 Key，并在创建后及时保存。
确认钱包额度与模型价格，再按下面的接口配置发送请求。
进入「使用日志」，核对返回结果、Token 用量和扣费。

账户与 API Key

客户端使用的是你在 WuDi API 创建的平台 Key。每个项目建议使用单独的 Key，设置合理的额度与有效期。

Key 相当于调用凭据，应放在可信服务端的环境变量中。泄露后请立即在控制台停用或删除，并重新创建。不要把真实 Key 写进公开网页、截图或代码仓库。

接口配置

配置项	填写内容
API Base URL	`https://wudiapi.com/v1`
认证	`Authorization: Bearer YOUR_WUDI_API_KEY`
聊天端点	`POST /v1/chat/completions`
示例模型 ID	`deepseek-flash`

部分客户端会自动拼接 /v1。如果出现 /v1/v1 或路径错误，请将该客户端的地址改为 https://wudiapi.com。

发送聊天请求

先在你自己的服务端配置 WUDI_API_KEY 环境变量，再执行示例。限制首次请求的输出长度，便于核对结果与费用。

cURL / 普通响应

curl https://wudiapi.com/v1/chat/completions \

  -H "Content-Type: application/json" \

  -H "Authorization: Bearer $WUDI_API_KEY" \

  -d '{

    "model": "deepseek-flash",

    "messages": [{"role": "user", "content": "你好，请简短介绍自己"}],

    "thinking": {"type": "disabled"},

    "max_tokens": 128,

    "stream": false

  }'

普通文本结果位于 choices[0].message.content；用量一般在 usage 中返回。上例的 thinking 参数针对该 DeepSeek 模型，切换模型时按对应模型能力调整。

Python 示例

适用于已安装支持自定义地址的 OpenAI-compatible Python 客户端的项目。

Python

import os

from openai import OpenAI



client = OpenAI(

    api_key=os.environ["WUDI_API_KEY"],

    base_url="https://wudiapi.com/v1",

)



response = client.chat.completions.create(

    model="deepseek-flash",

    messages=[{"role": "user", "content": "你好"}],

    max_tokens=128,

    extra_body={"thinking": {"type": "disabled"}},

)

print(response.choices[0].message.content)

使用流式响应

将 stream 设为 true。响应采用 SSE 分段返回；客户端需要按事件解析，而不是把整个响应当作单个 JSON。使用 cURL 时增加 -N，关闭客户端输出缓冲。

cURL / SSE

curl -N https://wudiapi.com/v1/chat/completions \

  -H "Content-Type: application/json" \

  -H "Authorization: Bearer $WUDI_API_KEY" \

  -d '{

    "model": "deepseek-flash",

    "messages": [{"role": "user", "content": "你好"}],

    "thinking": {"type": "disabled"},

    "max_tokens": 128,

    "stream": true,

    "stream_options": {"include_usage": true}

  }'

读取 choices[].delta.content 拼接文本；兼容接口正常完成时会返回 data: [DONE]。网络中断后先核对日志，避免无条件反复重试。

查询可用模型

模型广场展示平台当前配置。也可使用你的 Key 请求模型列表：

cURL / Models

curl https://wudiapi.com/v1/models \

  -H "Authorization: Bearer $WUDI_API_KEY"

可用模型还会受到 Key 的模型限制与分组影响。列表中存在某个模型不代表所有功能都已验证，图片、工具调用等能力以该模型实际支持情况为准。

余额与计费

用户钱包和 Key 限额都需要满足本次请求要求。不同模型可能对输入、输出和缓存采用不同单价，实际扣费请以使用日志为准。

模型价格以模型广场和实际使用记录为准。平台额度与上游账号余额分别管理，两者不是同一个余额。钱包没有可用充值方式时，请联系站点管理员，不要向未经确认的个人账户转账。

常见错误与排查顺序

现象	先检查什么
401 / 认证失败	Key 是否正确，是否已停用或到期，Bearer 头是否完整。
权限或余额不足	钱包余额、Key 额度、模型限制和所选分组。
404 / 路径错误	Base URL 是否重复拼接 /v1，端点和模型 ID 是否正确。
429 / 限流	降低并发，按错误提示等待，采用有限次数的退避重试。
5xx / 上游异常	先发送短请求，核对使用日志中的请求 ID 与错误信息。
流式内容延迟出现	关闭客户端缓冲；自建代理时检查 SSE 缓冲和超时设置。

反馈问题时提供时间、模型 ID、请求 ID 和脱敏错误内容即可，不要提供完整 Key 或用户隐私内容。

常见问题

我需要向模型服务商单独申请 Key 吗？

通过 WuDi API 调用平台已开放的模型时，使用本站 Key。自行管理的服务商 Key 由管理员在渠道中配置。

购买模型会员等于有 API 额度吗？

会员与 API 通常属于不同产品。请以相应服务商的产品说明和授权范围为准。

切换模型需要修改 API 地址吗？

在同一兼容接口内，通常只需调整 model；模型特有参数和功能仍需相应调整。

可以直接把 Key 放进网页 JavaScript 吗？

不要放入公开前端。让可信服务端保存 Key，再由你的应用服务端调用接口。

进入控制台了解 WuDi API

文档更新：2026 年 10 月 16 日。当前已验证 DeepSeek Flash 的文本普通响应与 SSE。