Wu Xianzhi API常见问题
无审查 API 常见问题:注册、计费、接口、错误码与内容边界
这里整理了开发者在使用无审查 API 时最常问到的问题,按注册与免费试用、计费与余额、接口与参数、错误码、内容边界、隐私六类分组。接口兼容 OpenAI 格式,只有一个模型 uncensored,按 token 预付费计费。想先看代码怎么写,可以去代码示例页,想了解完整参数,可以查看接口文档。
更新于
要点
- 注册只要邮箱和密码,不用绑卡,新账号有 $0.50 试用额度,7 天内有效
- 价格是输入 $0.25、输出 $1.00 每百万 tokens,预付费,余额不会过期
- 上下文 64,000 tokens,max_tokens 默认 2048、最大 16,000,每个密钥每分钟 300 次请求
- 涉及未成年人的性内容始终拦截,仅限成年用户与合法用途;提示词不会被用于训练
注册与免费试用
怎么注册,需要绑定银行卡吗?
在 /get-api-key/ 页面用邮箱和密码注册即可,不需要绑卡。注册成功后密钥会立即显示在页面上,不用等待审核。
新账号有多少试用额度,能用多久?
新账号有 $0.50 试用额度,7 天内有效。按输出 $1.00 / 百万 tokens 算,大约够生成 50 万 tokens 的回复,用来做接入测试和小规模验证是够的。
一个账号可以有几个密钥?密钥丢了怎么办?
每个账号只有一个密钥。如果泄露或丢失,可以在账号里重新生成,旧密钥会立刻失效,所有还在使用旧密钥的服务都会收到 401,所以更换后要同步更新环境变量。
试用到期后会发生什么?
试用额度过期后,请求会返回 402,错误码是 no_credit。需要继续使用时,给账号充值预付费余额即可,代码不用改。
计费与余额
价格是多少,按什么计费?
按 token 计费:输入 $0.25 / 百万 tokens,输出 $1.00 / 百万 tokens。没有订阅,也没有月费,用多少扣多少。完整说明见 价格页。
余额会过期吗?
不会。充值的预付费余额没有有效期,只有新账号的 $0.50 试用额度有 7 天的时间限制。
怎么知道一次请求花了多少钱?
每个响应的 usage 字段会给出本次的输入和输出 token 数,乘以单价就是费用。流式请求的最后一个数据块里也带有 usage,读取时注意这个块的 choices 是空数组。
怎么避免意外产生高额费用?
主要靠两点:用 max_tokens 限制单次输出,默认是 2048;多轮对话时裁剪历史,别让输入越滚越长。因为是预付费,余额用完请求就会停止,不会产生超出余额的账单。
举个例子,一次普通请求大概多少钱?
假设输入 2,000 tokens、输出 500 tokens:输入约 $0.0005,输出约 $0.0005,合计约 $0.001,也就是一千次这样的请求大约 $1。实际数字以响应里的 usage 为准。
余额用完后会怎样?
接口返回 402,错误码 no_credit。充值后可以继续使用,不需要重新生成密钥。
接口与参数
接口地址和模型名是什么?
Base URL 是 https://api.wuxianzhiapi.com/v1,模型名固定写 uncensored。可用的接口有 POST /v1/chat/completions 和 GET /v1/models。
兼容 OpenAI 的 SDK 吗?
兼容。官方 Python 的 openai v1 及以上、npm 的 openai v4 及以上,只要改 base_url 和密钥就能用。具体写法见 代码示例,从其他接口迁移可以看 迁移指南。
上下文有多长?max_tokens 能设多大?
上下文是 64,000 tokens,提示词和输出加起来不能超过这个数。max_tokens 默认 2048,单次最大 16,000。请求体不能超过 8 MB。
支持流式输出和函数调用吗?
都支持。流式用 stream: true,服务器会在最后自动追加一个带 usage 的数据块;函数调用使用 OpenAI 格式的 tools 和 tool_choice,工具结果以 role: "tool" 的消息回传。
流式响应最后一块为什么没有文字?
那是自动追加的用量统计块,choices 是空数组,usage 里是本次的 token 数。解析时先判断 choices 是否为空再取内容,就不会报下标越界。
有速率限制吗?
每个密钥每分钟 300 次请求。超过会返回 429,等待后重试即可,建议用指数退避。
支持向量、图片、语音或微调吗?
都不支持。这里只提供文本对话,只有 uncensored 一个模型,没有 embeddings,也没有图片、音频、视频生成和微调。
错误码
所有错误响应都是 JSON,格式为 {"error":{"code":...,"message":...}}。下面按状态码逐个说明该怎么处理。
400 是什么错误?
请求本身有问题,最常见的是提示词加 max_tokens 超过了 64,000 tokens,或者 JSON 格式不对、字段类型错误。需要修改请求,重试没有用。
401 怎么排查?
密钥无效或没有带。检查请求头是不是 Authorization: Bearer <密钥>,环境变量是否生效,密钥有没有被重新生成过,旧密钥在重新生成后会立即失效。
402 no_credit 是什么意思?
余额用完,或者试用额度已过期。给账号充值后即可恢复,不需要更换密钥。
403 content_blocked 是什么意思?
请求触发了内容拦截。涉及未成年人的性内容始终会被拦截,包括虚构和角色扮演,这是不可调整的。修改请求内容后再试,原样重发结果不会变。
404 是怎么回事?
访问了不存在的接口。常见原因是 URL 写错,比如漏了 /v1,或者调用了不支持的接口,像 embeddings 和图片生成。
429 和 503 该怎么处理?
429 是超过了每分钟 300 次的速率限制;503 的错误码是 upstream_busy,表示模型暂时繁忙,几秒后再试。两者都适合用指数退避重试,示例见代码示例页。
内容边界
「无审查」是不是什么都能生成?
不是。合法的成人内容、虚构创作和有争议的话题不会被拒绝,但涉及未成年人的性内容始终会被拦截,返回 403,无论是否虚构、是否角色扮演。使用必须合法。
面向哪些用户?
仅面向 18 岁以上的成年用户。如果你用它做面向终端用户的产品,需要在自己的应用里做成年确认,并保留举报和账号管理机制。
可以用来做角色扮演、小说、游戏吗?
可以,这是最典型的用法。各场景的提示词示例和成本估算见 应用场景 一文。
角色扮演里什么情况下会返回 403?
只有触发内容拦截时才会返回,典型就是涉及未成年人的性内容,包括虚构设定。成年人之间的合法内容不会因为是角色扮演而被拒绝。遇到 403 时,请调整人设或情节后再请求。
模型输出的事实一定可靠吗?
不一定。不拒答不代表内容准确,涉及事实、数据、法律或医疗的结论,需要你自己核实后再使用。
隐私
我的提示词会被用来训练模型吗?
不会。你发送的提示词不会被用于训练。
该怎么保管密钥?
把密钥放在服务端的环境变量里,不要写进前端页面、移动端安装包或公开的代码仓库。如果怀疑泄露,立刻在账号里重新生成,旧密钥会马上失效。
应用里的用户数据该怎么处理?
这部分取决于你自己的产品。建议只发送完成任务必需的内容,不要把用户的真实姓名、证件号、联系方式等敏感信息放进提示词,并在你自己的隐私政策里写清楚数据如何流转。
常见问题
注册需要银行卡吗?试用额度有多少?
不需要绑卡,邮箱加密码注册后密钥立即显示。新账号有 $0.50 试用额度,7 天内有效。
价格怎么算,余额会过期吗?
输入 $0.25 / 百万 tokens,输出 $1.00 / 百万 tokens,预付费,没有订阅和月费。充值的余额不会过期,只有试用额度有 7 天限制。
上下文长度和 max_tokens 上限是多少?
上下文 64,000 tokens,提示词和输出合计。max_tokens 默认 2048,单次最大 16,000,请求体不超过 8 MB,每个密钥每分钟 300 次请求。
返回 402 或 403 是什么原因?
402 的错误码是 no_credit,表示余额用完或试用已过期,充值即可。403 的错误码是 content_blocked,涉及未成年人的性内容始终会被拦截,包括虚构内容。
提示词会被用于训练吗?
不会,提示词不会被用于训练。