PixCode 接入文档
一个 base URL,两套协议。改一个变量就能接上你在用的 coding agent。
快速开始
先在控制台拿一把 key,再按下面的流程接进你在用的工具。
QUICK~1 MIN
先拿一把 API key
登录控制台,在 API Keys 区点「新建 API Key」。key 只显示一次,复制后填进下面任意工具的环境变量。用我们 CLI 登录也会自动签发。
TUTORIAL~10 MIN
跑通第一轮真实任务
在一个真实仓库里跑一次多文件改动,看清三个别名分别在什么时候被调用、缓存读命中之后账单长什么样。
按工具接入
选你在用的那个,复制过去就行。没列出来的工具,只要能填自定义端点就能用。
写进 shell 配置或 ~/.claude/settings.json 的 env 块。自定义 base_url 下 Claude Code 不校验模型名。
export ANTHROPIC_BASE_URL="https://api.pixcode.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-px-..."
export ANTHROPIC_DEFAULT_OPUS_MODEL="pixcode-max"
export ANTHROPIC_DEFAULT_SONNET_MODEL="pixcode-pro"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="pixcode-fast"
export API_TIMEOUT_MS=3000000
claude端点与认证
端点只有两条,认证支持 x-api-key 和 Authorization: Bearer 两种,用哪个都行。网关在新加坡出网,到上游少绕一段。
Anthropic
https://api.pixcode.ai/anthropic
Claude Code、Cline、Zed 这类走 Messages API 的工具用这条。
OpenAI 兼容
https://api.pixcode.ai/v1
任何能填自定义 OpenAI 端点的工具用这条,/models 可直接列表。
curl https://api.pixcode.ai/anthropic/v1/messages \
-H "x-api-key: sk-px-..." \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "pixcode-pro",
"max_tokens": 1024,
"messages": [{ "role": "user", "content": "hi" }]
}'模型别名
三个别名都给 1M 上下文,按任务长度选。在 agent 配置里按角色分配:标题和压缩交给便宜的,必须落地的那次交给强的。
pixcode-fast
便宜到可以随便用
便宜到可以随便用
context 1M
pixcode-pro
日常主力默认就填它
日常主力
context 1M
pixcode-max
长任务能跑完
长任务能跑完
context 1M
31 个模型的官方名和逐条费率在模型页上,别名只是三个默认入口。
限制与错误码
并发上限是为了不让少数挂机脚本把上游配额吃光;触发时给 retry-after,等前面的请求完成即可。另外网关侧单个请求的硬上限是 780 秒,客户端超时放得再宽也不会超过它。
晶石不足
返回 402 并提示获取晶石,不会静默降级到便宜模型。补上就继续。
并发超限
每个档位有并发 agent 数上限,同时跑太多会拿到 429 和 retry-after。
实时余额可查
curl https://api.pixcode.ai/v1/balance -H "x-api-key: sk-px-..."
超时怎么设?
长任务建议把客户端超时放宽到 3000000ms(Claude Code 用 API_TIMEOUT_MS)。20 步以上的 agent 轮次经常单次就要几分钟,默认超时会在中途把连接掐掉。
前缀缓存需要我做什么吗?
不需要额外参数。保持系统提示和文件上下文的顺序稳定,命中后重复的上下文按缓存价结算,不按输入价——这是长会话里最省的一项。
能用我自己的上游 key 吗?
可以。CLI 支持填你自己的上游 key,代理这一段永久免费。走网关价格也和官网一致,差别只在 key 和账单由谁管。