APIPool 快速接入

Base URL

https://app.apipool.dev

Base URL 不含 /v1，也不含任何协议路径。先按模型与分组选协议：同一个 Key 可以访问其分组已开放的模型，但不代表每个模型都支持每一种接口。

文字对话——支持 Responses 的模型可用 /v1/responses；支持 Chat Completions 的模型可用 /v1/chat/completions。具体以模型说明为准。
图片生成与编辑——使用 Images 请求格式和异步任务轮询，见图片模型与协议。不要把图片模型直接套进下面的文字示例。
厂商原生协议——仅使用本站明确开放的入口，例如 Anthropic /v1/messages。本站暂未开放 Gemini 原生生图入口。

部分 SDK 和工具会自行追加 /v1，配置时以它们的文档或下方示例为准。

选择模型与协议

模型系列	分组	入口与指南
GPT 文字模型	特惠	`/v1/responses`；Codex
Claude	特惠、特惠 2	使用 Claude Code，客户端调用 `/v1/messages`
Qwen、GLM、Kimi 文字模型	官方	`/v1/chat/completions`；Qwen、GLM、Kimi
图片模型	以具体型号为准	Images 与异步任务

协议表不代表所有型号一直可用。先确认目录状态与 Key 分组，再使用对应指南。

鉴权

在 Authorization header 中携带 Key：

Authorization: Bearer $APIPOOL_API_KEY

在控制台创建 Key，并保存完整值。列表中提供“复制”按钮时，可再次复制；如果只显示掩码且无法复制，请创建新 Key 并更新应用配置。停用或删除后无法再复制。

开始使用

注册并进入控制台。
在余额页充值。按所选模型和分组的公开价格计费，余额永不过期。
创建 API Key，从创建结果或 Key 列表复制完整值。
从模型列表选择模型，按下方示例调用。

curl

APIPOOL_ENDPOINT="https://app.apipool.dev"

curl "$APIPOOL_ENDPOINT/v1/responses" \
  -H "Authorization: Bearer $APIPOOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-luna","input":"Hello from APIPool"}'

OpenAI SDK（JavaScript）

import OpenAI from 'openai';

const APIPOOL_ENDPOINT = 'https://app.apipool.dev';

const client = new OpenAI({
  baseURL: `${APIPOOL_ENDPOINT}/v1`,
  apiKey: process.env.APIPOOL_API_KEY,
});

const response = await client.responses.create({
  model: 'gpt-5.6-luna',
  input: 'Hello from APIPool',
});

console.log(response.output_text);

OpenAI SDK（Python）

import os
from openai import OpenAI

APIPOOL_ENDPOINT = "https://app.apipool.dev"

client = OpenAI(
    base_url=f"{APIPOOL_ENDPOINT}/v1",
    api_key=os.environ["APIPOOL_API_KEY"],
)

response = client.responses.create(
    model="gpt-5.6-luna",
    input="Hello from APIPool",
)

print(response.output_text)

原生 HTTP（fetch）

const APIPOOL_ENDPOINT = 'https://app.apipool.dev';

const response = await fetch(`${APIPOOL_ENDPOINT}/v1/responses`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.APIPOOL_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'gpt-5.6-luna',
    input: 'Hello from APIPool',
  }),
});

console.log(await response.json());

Chat Completions

官方分组的 Qwen、GLM 和已开放的 Kimi 文字模型使用此接口。使用官方分组的 Key，从模型列表选择状态为“可用”的文字模型；图片模型不适用。

APIPOOL_ENDPOINT="https://app.apipool.dev"

curl "$APIPOOL_ENDPOINT/v1/chat/completions" \
  -H "Authorization: Bearer $APIPOOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen3.8-flash","messages":[{"role":"user","content":"请只回复：APIPOOL-OK"}],"stream":false}'

非流式回复正文在 choices[0].message.content。流式请求、用量及各系列限制见 Qwen、GLM和 Kimi。

Claude 与 Anthropic Messages

当前特惠分组和特惠分组 2 的 Claude 模型要求使用 Claude Code。虽然请求使用 POST /v1/messages，普通 curl 或 Anthropic SDK 并不因此获得该分组的客户端权限。

请按 Claude Code 接入指南设置地址与 Key，并使用目录中该分组可用的完整模型 ID。不要沿用旧型号或把其他模型的 Responses 示例直接替换为 Claude。

图片生成与编辑

当前已上架图片系列使用 JSON /v1/images/generations；支持文件上传编辑的模型还可使用 /v1/images/edits（multipart/form-data）。Wan 编辑使用生成接口的 image_urls，Z-Image 仅支持文生图。完整型号与例外见图片模型与协议。

这些图片请求均为异步任务：提交成功返回 202 Accepted，之后用同一个 Key 轮询任务 ID。这里采用 Images 请求格式，但返回任务而非 OpenAI 同步 Images 的图片结果；不能直接把提交响应当成 data[].url。图片接口不支持 stream: true。 GPT Image 2 的计费由 Key 所属分组决定，参见官方分组或特惠分组。

curl "$APIPOOL_ENDPOINT/v1/images/generations" \
  -H "Authorization: Bearer $APIPOOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"A product photo on a white background","size":"1:1","resolution":"1k","n":1}'

提交与轮询的完整说明见图片异步任务。

流式输出

Responses、Chat Completions 和 Messages 接口支持 "stream": true，返回 SSE 流式响应。图片接口不支持流式。

错误码参考

状态码	含义	处理方式
`401`	Key 缺失、无效、被禁用或已删除	检查 header 与控制台中的 Key 状态
`403`	Key 无权访问所请求的模型	检查 Key 的模型限制设置
`429` insufficient_quota	余额耗尽	在控制台充值
`429` concurrency_limit_exceeded	触发并发限制	按 `Retry-After` 退避后重试
`404` model_not_found	模型 ID 不可用	从模型列表选择可用模型

以下错误请按对应步骤处理，通常无需更换 API Key 或充值：

状态码与错误码	含义与处理方式
`400` model_not_supported_in_group	当前分组未开放该型号；核对模型与分组，持续失败时联系支持
`429` rate_limit_exceeded	请求频率受限；降低请求频率，并遵循响应中的 `Retry-After`
`502` upstream_authentication_failed	服务暂时异常；保留请求 ID 联系支持
`503` upstream_service_unavailable / upstream_capacity_exhausted	服务暂不可用或繁忙；稍后重试或使用其他可用型号

排查时保留 X-APIPool-Request-Id 响应头或 error.request_id。图片请求已返回任务 ID 后，应继续查询原任务；轮询断开不代表提交失败，不要直接重新生成。

计费

在余额页以美元充值。文本模型按模型列表所列的 token 单价扣费；按次计费的模型（例如图片）按档位单价与实际返回数量扣费。请求数、token 数、分模型消费和逐请求扣费见用量页和账单页。

APIPool 快速接入

On this page