APIPace 文档 API 参考

接入 Cline

Cline 是 VS Code 里的编码 agent。它没有中文界面,下面的字段名保留英文原词。

配置(OpenAI 兼容)

  1. 侧边栏打开 Cline,点齿轮进设置。
  2. API Provider 选 OpenAI Compatible。
  3. 填三个字段:
字段 填什么
Base URL https://api.apipace.com/v1
API Key 你的 ak-…
Model 别名,如 claude-sonnet-4.6
  1. 展开下面的 Model Configuration,手填 Max Output Tokens 和 Context Window(Cline 不会替你猜,不填会影响截断和花费显示)。
  2. 保存,开一个任务试试。

Base URL 必须带 /v1。 Cline 会直接拿这个地址去拼 /models 和 /chat/completions,漏了 /v1 就会打到 https://api.apipace.com/models,拿到 404,模型列表也拉不出来。

配置(Anthropic 协议)

Cline 也能走 Anthropic 那一路,规则和上面正好相反:

  1. API Provider 选 Anthropic。
  2. 勾上 Use custom base URL。
  3. 地址填 https://api.apipace.com——根地址,不带 /v1。Cline 把它原样交给 Anthropic SDK,SDK 自己会补 /v1/messages。
  4. API Key 填同一把 ak-…。

两条路用的是同一把 key、同样的别名;选哪条看你更想要哪种协议的原生行为。

选支持工具调用的别名

Cline 靠工具调用改文件、跑命令。Claude 系别名(claude-sonnet-4.6、claude-opus-4.6 等)在这件事上最稳;工具调用能力弱的模型会表现为「一直在说话、不动手」。

工具调用是原样透传的,一次真实返回:

{"stop_reason":"tool_use",
 "content":[{"type":"tool_use","id":"toolu_01KdKPaTBcuPUDRkz62H3VaU","name":"get_weather","input":{"city":"杭州"}}]}

关于费用显示

Cline 面板上那个花费数字是它按自己填的价格算的估值,不是这里的扣费。真实数字看 GET /v1/user/statement 或控制台「用量」页。

编码 agent 的上下文越滚越长,input_tokens 涨得比想象的快。对话类别名冷热同价、缓存不打折,所以长任务建议中途开新会话,而不是一路滚下去。

常见问题

404 / 模型列表空的 —— OpenAI Compatible 那一路的 Base URL 漏了 /v1。

404 page not found(Anthropic 那一路) —— 自定义 base URL 多写了 /v1,去掉。

MODEL_NOT_FOUND —— Model 要填别名,不是厂商原始模型名。

上下文超了 —— 换上下文更长的别名,或者开新任务。