费率 = 上游官方列表价,0 加价,逐条公开在定价页→

PixCode 接入文档

一个 base URL,两套协议。改一个变量就能接上你在用的 coding agent。

快速开始

先在控制台拿一把 key,再按下面的流程接进你在用的工具。

QUICK~1 MIN

先拿一把 API key

登录控制台,在 API Keys 区点「新建 API Key」。key 只显示一次,复制后填进下面任意工具的环境变量。用我们 CLI 登录也会自动签发。

GUIDED~5 MIN

完整配置流程

手动配 base URL、认证头和三个别名:把 fast 交给杂务,pro 当默认,max 留给必须落地的那次。

TUTORIAL~10 MIN

跑通第一轮真实任务

在一个真实仓库里跑一次多文件改动,看清三个别名分别在什么时候被调用、缓存读命中之后账单长什么样。

开始教程 →

按工具接入

选你在用的那个,复制过去就行。没列出来的工具,只要能填自定义端点就能用。

写进 shell 配置或 ~/.claude/settings.json 的 env 块。自定义 base_url 下 Claude Code 不校验模型名。

~/.zshrc
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 配置里按角色分配:标题和压缩交给便宜的,必须落地的那次交给强的。

31 个模型的官方名和逐条费率在模型页上,别名只是三个默认入口。

限制与错误码

并发上限是为了不让少数挂机脚本把上游配额吃光;触发时给 retry-after,等前面的请求完成即可。另外网关侧单个请求的硬上限是 780 秒,客户端超时放得再宽也不会超过它。

402

晶石不足

返回 402 并提示获取晶石,不会静默降级到便宜模型。补上就继续。

429

并发超限

每个档位有并发 agent 数上限,同时跑太多会拿到 429 和 retry-after。

GET

实时余额可查

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 和账单由谁管。

接完了想知道一轮扣多少晶石?