WuDi API / Documentation

WuDi API 接入文档：从第一条请求开始

先创建本站 API Key，确认模型与可用额度，再配置接口地址并发送短请求。下文使用 deepseek-flash 作为现有文档示例；使用前请在模型广场确认该 ID 仍然开放。

在线支付通道尚未接通。如果需要充值，请联系客服：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 的模型限制与分组影响。列表中存在某个模型不代表所有功能都已验证，图片、工具调用等能力以该模型实际支持情况为准。

余额与计费

继续阅读：Token 费用计算说明。

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

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

常见错误与排查顺序

继续阅读：完整排错步骤。

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

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

专题指南

API Base URL 怎么填：区分根地址、版本前缀和完整端点。
API 常见错误排查：按认证、权限、路径和限流检查调用失败。
Token 费用怎么算：用真实用量和当前单价估算预算。

常见问题

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

通过 WuDi API 调用本站已开放的模型时，使用在本站创建的 API Key。其他平台的账户、会员和 Key 不会自动变成本站可用额度。

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

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

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

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

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

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

进入控制台了解 WuDi API

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