Agent / SDK 调用指南
QClaw、OpenAI SDK、Anthropic SDK、openclaw、node-fetch 等自动化调用，建议使用 API 专用入口并按本页模板排查。
Agent（智能体）和 SDK（开发包）新接入优先使用 https://api.jojokey.com/v1
Claude Code / Anthropic 类客户端如果会自动追加路径，通常填写根地址 https://api.jojokey.com
如果 curl 正常但 Agent 失败，优先检查 User-Agent（客户端标识）、headers（请求头）、body（请求体）和出口 IP
如果你使用的是 QClaw、openclaw、OpenAI SDK、Anthropic SDK、node-fetch 或其他自动化 Agent，请优先使用 API 专用入口。这个入口和主站共享同一套令牌、分组、计费和模型路由，只是网络安全策略更适合程序调用。
为什么要用 API 专用入口
JojoKey 主站 https://jojokey.com 同时承载官网、控制台、文档和支付页面，Cloudflare WAF（Web 应用防火墙）会更严格地处理可疑自动化请求。Agent（智能体）和 SDK（开发包）通常会带有 OpenAI/Python、Anthropic/Python、node-fetch、QClaw、openclaw 这类 User-Agent（客户端标识），容易被当成机器人流量。
我们曾遇到过这样的案例：同一台机器、同一个网络、同一个 token（令牌），curl 请求正常，但 SDK / Agent 请求返回 403 Your request was blocked。这类情况通常不是模型不可用，也不是 token 错误，而是请求在 Cloudflare 边缘层被拦截。遇到这种问题，请优先把 Base URL（接口基础地址）切到 https://api.jojokey.com/v1。
应该填写哪个地址
最小验证命令
先用同一台机器、同一个网络出口、同一个 token（令牌）跑下面的最小请求。如果 curl 成功而 Agent 失败，说明问题很可能在 Agent 自己的请求头、请求体、代理出口或缓存 token 上。
curl -i https://api.jojokey.com/v1/models \
-H "Authorization: Bearer sk-你的令牌"curl -i https://api.jojokey.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-H "User-Agent: node-fetch openclaw/2026.6.5" \
-d '{
"model": "gpt-5.4",
"messages": [{"role": "user", "content": "只回复 ok"}],
"max_tokens": 8,
"stream": true
}'如何判断错误发生在哪一层
Agent 失败时请提供这些信息
为了快速定位，请让 Agent / 网关输出下面这些信息。Authorization（授权头）和 API Key（接口密钥）必须脱敏，不要贴完整 token。
请求时间：
实际 URL：
HTTP 状态码：
cf-ray：
x-oneapi-request-id：
User-Agent（客户端标识）：
出口公网 IP：
是否 stream（流式）：true / false
是否走 proxy / VPN（代理 / 虚拟专用网络）：
请求 headers（请求头，Authorization 脱敏）：
请求 body（请求体，prompt 可脱敏但保留结构）：
最小 curl 复现是否成功：速率限制提醒
API 专用入口仍然有 rate limiting（速率限制）。如果多个 Agent 共用同一个出口 IP，高并发短时间爆发可能触发短暂阻断。建议给 Agent 做并发控制、指数退避和失败重试，不要无限立即重试。