DOCUMENTATION / 接入文档
从第一次请求开始。
在这里找到接入 DWapi 所需的地址、鉴权方式和请求示例。已有账户可进入工作区，查看与你的密钥分组对应的详细接入配置。
01 / 快速开始
- 创建账户，或登录已有账户。
- 进入API 密钥，选择可用分组并创建密钥。根据需要设置额度、有效期和 IP 限制。
- 在模型价格中确认分组支持的模型和计费规则，并检查账户余额或订阅额度。
- 把密钥设置为服务端环境变量
DWAPI_API_KEY，再复制下方示例执行。
创建账户免费；发送真实模型请求可能消耗额度。文档页面只展示代码，不会自动调用模型。请勿把账户登录密码当作 API Key。
02 / 地址与鉴权
兼容客户端的 Base URL：
https://www.dwapi.xyz/v1下方 Responses 示例使用请求地址 https://www.dwapi.xyz/v1/responses。将密钥放在请求头 Authorization: Bearer YOUR_API_KEY 中，并设置 Content-Type: application/json。
03 / 发送一个请求
示例模型为 gpt-5.4。请先确认你的密钥分组支持该模型和 Responses 接口。Python 示例使用标准库，JavaScript 示例在提供 fetch 的 Node.js 服务端环境中运行。
your-first-requestHTTPS
返回内容与接口协议有关。处理响应时先检查 HTTP 状态，避免把错误信息当作模型输出。需要流式返回时，请根据所用协议处理事件流；首次接入建议先完成非流式调用。
04 / 模型与分组
首页的模型目录汇总本站已配置模型；每把密钥的实际可用范围由其分组决定。使用精确模型名称，不要自行修改版本后缀。
- 文本和编程任务：选择支持对应文本协议的分组。
- 图像和视频任务：选择具备该媒体模型的分组，不能直接套用文本请求体。
- 兼容客户端：检查其接口类型是否与分组一致，再填写 Base URL、密钥和模型名。
05 / 价格与用量
文本模型的基础参考价格以美元 / 100万 Tokens 展示。输入、输出、缓存读取等项目可能有不同单价，实际费用还会受到密钥分组倍率影响。
计算示意：输入费用 + 输出费用 + 适用的缓存等费用，再按分组计费规则结算。图像、视频、音频及特殊模型可能使用不同计费单位，请以工作区实际价格说明和账单为准。
在用量统计中核对请求记录和消费。在线支付、套餐购买目前尚未开放；已有兑换码可在兑换码页面使用。不要把免费注册理解为自动赠送可用额度。
06 / 常见错误与排查
| 现象 | 先检查这些项目 |
|---|---|
| 401 / 鉴权失败 | 确认密钥完整、有效，鉴权请求头正确；没有误用账户登录令牌。 |
| 403 / 无权访问 | 检查分组权限、IP 限制、额度状态及响应中的具体错误说明。 |
| 模型不存在 | 核对模型名称与密钥分组；目录中的模型不一定对所有分组开放。 |
| 429 / 请求受限 | 降低并发与请求频率，按返回信息等待后重试，避免持续快速重发。 |
| 超时 / 5xx | 保留请求时间与请求标识，检查网络和上游状态；媒体任务可能需要更长时间。 |
| 返回格式不匹配 | 检查客户端使用的协议、请求路径与解析方式是否一致。 |
排查时可查看工作区的请求记录。分享错误信息前请移除密钥、用户隐私和不必要的请求内容。
07 / 密钥安全
- 只在服务端保存 API Key，用环境变量或合适的密钥管理服务读取。
- 为不同项目设置独立密钥，按需要限制额度、有效期和允许访问的 IP。
- 不要把真实密钥放在前端代码、截图、公开仓库或提交记录中。
- 发现密钥泄露时，立即在工作区停用，并创建新密钥更新应用配置。