构建，从一个请求开始
兼容 OpenAI Chat Completions API。这里提供清晰的人工文档，以及可直接复制给 AI 的 Markdown 和 JSON 结构化资料。
快速开始
只需完成以下步骤，即可使用任何兼容 OpenAI Base URL 的客户端。
- 进入控制台，在“API Key”页面创建密钥。
- 复制并安全保存完整 Key；完整内容只展示一次。
- 将 Base URL 设置为
https://token.3dpclub.com/v1。 - 从模型市场复制准确的模型 ID 并发送请求。
cURL 示例
curl https://token.3dpclub.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"glm-5.2","messages":[{"role":"user","content":"你好"}],"stream":true}'请勿在浏览器前端、公开仓库、截图或日志中暴露完整 API Key。
API Key 与服务档位
档位绑定到 Key，可在控制台修改，无需重新生成 Key。修改只影响保存后的新请求。
经济档0.2x 规划
价格优先，适合批处理或对首字延迟不敏感的任务。
快速档0.4x 规划
优先低延迟、高稳定渠道；首字 5 秒为服务目标。
自动档按实际结算
根据模型与渠道健康度选路，并按最终成功档位计费。
服务档位正在分阶段上线；控制台显示的实时价格与可选范围为最终有效规则。
SDK 接入
Python、Node.js、Claude Code、Codex、Cursor 等支持自定义 OpenAI Base URL 的工具通常可以直接接入。
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://token.3dpclub.com/v1"
)
response = client.chat.completions.create(
model="glm-5.2",
messages=[{"role": "user", "content": "你好"}]
)错误码与排查
请优先记录请求 ID、模型 ID、发生时间和是否为流式请求。
| 状态 | 常见原因 | 建议 |
|---|---|---|
| 400 | 参数或模型能力不兼容 | 检查模型 ID、tools、JSON 模式和 token 上限 |
| 401 | Key 无效或停用 | 确认 Bearer 格式与 Key 状态 |
| 402 | 余额不足 | 充值后重新请求 |
| 429 | 并发、RPM 或上游限流 | 指数退避并降低并发 |
| 503 | 渠道暂不可用或重试耗尽 | 保留请求 ID，稍后重试 |
技术支持与自主排障
遇到调用问题时，建议先在本页搜索错误码、模型 ID、Key 或参数名称，按对应建议检查配置并重试。文档中心覆盖快速接入、错误码、流式行为和路由降级说明，可以先完成大多数常见问题的定位。
如果搜索后仍无法解决，请联系技术支持：微信 aaa3dpclub 或邮箱 [email protected]。反馈时请附上 HTTP 状态码、错误码、Request ID、发生时间、模型 ID、是否流式以及客户端或 SDK 版本。请勿发送完整 API Key、私密对话或其他敏感数据。
路由与降级
路由综合模型能力、健康度、优先级、首字延迟、并发和冷却状态。
- 流式内容一旦发送，不会透明切换到其他上游。
- 快速档在开始输出前不可用时，可按明确规则降级。
- 最终档位、倍率和降级原因应在使用记录中留痕。
- 模型、价格及实时状态以控制台“模型市场”为准。