APIPace 文档 API 参考

快速开始

五分钟从零发出第一个请求：拿 key、选别名、用你手上任何一个 OpenAI 或 Anthropic 客户端打过来。

一张表看懂

项 值
Base URL https://api.apipace.com
OpenAI 协议 POST /v1/chat/completions
Anthropic 协议 POST /v1/messages
Gemini 原生 POST /v1beta/models/{别名}:generateContent
图片生成 POST /v1/image-tasks（异步任务）
鉴权方式 A Authorization: Bearer ak-…
鉴权方式 B x-api-key: ak-…
控制台 https://api.apipace.com/

两种鉴权效力完全相同，任选一种；同一把 key 在两种协议上都能用。

1. 注册

去 https://api.apipace.com/register，三步：

  1. 填邮箱，点发送验证码。邮箱会收到一封 6 位数字的信，10 分钟内有效、只能用一次。
  2. 填验证码和密码（至少 8 位）。
  3. 勾选同意《服务条款》和《隐私政策》——不勾选注册不了。

提交后直接就是登录状态，系统同时给你建好自己的租户和一个默认项目 / 应用。有邀请码可以在「有邀请码？点这里填写」里填，没有也能注册。

忘记密码走 https://api.apipace.com/reset-password，同样是邮箱收码。重置会把这个账号已有的登录全部踢下线，所以重置完其它设备要重新登录。

2. 拿一把 key

进控制台的「API Key」页新建。创建时完整 key 只显示一次，离开页面就看不到了，请立刻存进你的密码管理器或环境变量。

key 建好之后建议写进环境变量，下面所有例子都假设它在 $APIPACE_KEY 里：

export APIPACE_KEY="ak-…"

3. 选一个别名

model 字段填别名，不是厂商的原始模型名。当前可用别名以 GET /v1/models 实时返回为准：

curl https://api.apipace.com/v1/models -H "x-api-key: $APIPACE_KEY"

{"object":"list","data":[
  {"id":"claude-sonnet-4.6","object":"model","created":1789534530,"owned_by":"apipace"},
  {"id":"kimi-k3","object":"model","created":1789534530,"owned_by":"apipace"}
]}

（owned_by 是为兼容 OpenAI 客户端留的占位字段，恒为 apipace，没有别的含义。）

默认只列对话别名——也就是可以直接填进 model 发对话请求的那些。Gemini 原生和图片这类不走对话协议的能力不在默认列表里，填进对话请求只会拿到 400。

想看全部，加 include=all，每条会多一个 capabilities 说明它能怎么用：

curl "https://api.apipace.com/v1/models?include=all" -H "x-api-key: $APIPACE_KEY"

{"object":"list","data":[
  {"id":"claude-sonnet-4.6","object":"model","created":1789534530,"owned_by":"apipace",
   "capabilities":["chat","stream","tools"]},
  {"id":"gemini-2.5-pro","object":"model","created":1789534530,"owned_by":"apipace",
   "capabilities":["gemini_native","video_understanding"]},
  {"id":"gpt-image-2-official","object":"model","created":1789534530,"owned_by":"apipace",
   "capabilities":["image_generation"]}
]}
capability 意思 走哪个接口
chat 对话 /v1/chat/completions、/v1/messages
stream 支持流式 同上，stream: true
tools 支持工具调用 同上
gemini_native 只认 Gemini 原生形状 /v1beta/models/{别名}:generateContent
video_understanding 能读视频 同上
image_generation 生成图片 /v1/image-tasks

当前在售的别名和单价另有一份免鉴权的清单：

curl https://api.apipace.com/v1/pricing

人看的版本在 https://api.apipace.com/pricing。

如果这把 key 设了模型白名单，白名单之外的别名在 /v1/models 里就看不到，填了会返回 MODEL_NOT_FOUND。

4. 发第一个请求

两种协议二选一，看你的客户端和 SDK 讲哪一种。

OpenAI 协议

curl https://api.apipace.com/v1/chat/completions \
  -H "Authorization: Bearer $APIPACE_KEY" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4.6","max_tokens":16,"messages":[{"role":"user","content":"用一个词打招呼"}]}'

{
  "id": "req_01M2M6P1SDGR2X27H0MZRNW0HE",
  "object": "chat.completion",
  "created": 1789531981,
  "model": "claude-sonnet-4.6",
  "choices": [{"index":0,"finish_reason":"stop","message":{"role":"assistant","content":"你好！ 👋"}}],
  "usage": {"prompt_tokens":16,"completion_tokens":11,"total_tokens":27},
  "request_id": "req_01M2M6P1SDGR2X27H0MZRNW0HE",
  "billable_units": {"input_tokens":16,"output_tokens":11,"usage_source":"upstream"}
}

Anthropic 协议

curl https://api.apipace.com/v1/messages \
  -H "Authorization: Bearer $APIPACE_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4.6","max_tokens":16,"messages":[{"role":"user","content":"用一个词打招呼"}]}'

{
  "id": "req_01M2M6NZBQRN748G5NXAMRF6W1",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4.6",
  "content": [{"type":"text","text":"你好！👋"}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens":16,"output_tokens":9,"cache_creation_input_tokens":0,"cache_read_input_tokens":0},
  "request_id": "req_01M2M6NZBQRN748G5NXAMRF6W1",
  "billable_units": {"input_tokens":16,"output_tokens":9,"usage_source":"upstream"}
}

两个响应体都是原样透传，只多了两个平台字段：request_id 和 billable_units。标准 SDK 不认识的字段会被忽略，不影响解析。

5. 查这一笔扣了多少

响应体里有 token，没有钱。钱拿 request_id 去查：

curl https://api.apipace.com/v1/requests/req_01M2M6NZBQRN748G5NXAMRF6W1 \
  -H "x-api-key: $APIPACE_KEY"

{
  "request_id": "req_01M2M6NZBQRN748G5NXAMRF6W1",
  "status": "FINALIZED",
  "model": "claude-sonnet-4.6",
  "stream": false,
  "usage": {"input_tokens":16,"output_tokens":9,"total_tokens":25},
  "billable_units": {"input_tokens":16,"output_tokens":9,"request_count":1,"usage_source":"upstream"},
  "sales_amount": 1365,
  "currency": "CNY",
  "route_id": "01M2M6NZC9C8HYDJFE0ZAFEP4R",
  "latency_ms": {"total":1288,"upstream_first_byte":1274,"upstream_total":1274,"platform_overhead":14},
  "created_at": "2026-09-16T04:12:59.134049Z",
  "adjustments": []
}

sales_amount 是微元：1,365 微元 = ¥0.001365。请求一返回记录就已落库，可以立刻查，不用等。完整口径见计费与账单。

下一步