API 概览

AnyPath 在平台定价的共享 AI 资源之上提供一组精简的公开网关接口。

Base URL

协议	Base URL	适用场景
OpenAI 兼容	https://api.anypath.dev/v1	Chat Completions、Responses、模型发现和图像
Anthropic Messages	https://api.anypath.dev	Anthropic Messages 原生请求形式
Gemini /v1beta	https://api.anypath.dev/v1beta	Gemini 兼容 REST 请求形式

认证

协议	支持的认证方式
OpenAI 兼容	Authorization: Bearer sk-...
Anthropic Messages	Authorization: Bearer sk-... 或 x-api-key: sk-...
Gemini /v1beta	Authorization: Bearer sk-...、x-goog-api-key: sk-... 或 ?key=sk-...

API Key 处理方式和错误响应详见 认证。

可用端点

OpenAI 兼容

Endpoint	Method	说明
/v1/models	GET	当前 API Key 和路由策略下可用模型的发现接口
/v1/routes	GET	网关公开契约的路由目录
/v1/chat/completions	POST	Chat Completions 请求形式
/v1/responses	POST	Responses 请求形式
/v1/images/generations	POST	图像生成
/v1/images/edits	POST	图像编辑

Anthropic Messages

Endpoint	Method	说明
/v1/messages	POST	Claude 原生 Messages 请求形式
/v1/messages/count_tokens	POST	Anthropic 兼容 Token 计数请求形式

Gemini /v1beta

Endpoint	Method	说明
/v1beta/models	GET	列出 Gemini 兼容模型
/v1beta/models/{model}	GET	获取 Gemini 兼容模型元数据
/v1beta/models/{model}:generateContent	POST	生成内容
/v1beta/models/{model}:streamGenerateContent	POST	流式生成内容
/v1beta/models/{model}:countTokens	POST	对 Gemini 兼容请求体返回网关 Token 估算

速率限制

账号 Tier 决定账号策略；每个 API Key 可以进一步收紧模型访问、路由策略、预算、RPM 和 TPM。API Key 的路由策略决定可用的供应商范围。实际限额还会受账号、Key、路由和上游 key 的影响。请从 /v1/models 和控制台读取当前有效的 RPM / TPM。触发限流时，网关返回 429 并可能携带 Retry-After 提示。

重试方式详见 速率限制。

错误响应格式

OpenAI 兼容网关错误使用以下格式：

{
  "error": {
    "message": "Invalid API key",
    "type": "auth_invalid",
    "code": "auth_invalid"
  }
}

运行时 type 等于 code。完整列表见 错误码。

路由与结算

请求通过当前 API Key 可用的路由进行路由：

• 共享路由在请求成功后按 USDT 结算。
• 共享路由价格由官方模型价格和当前供应商级平台倍率派生。
• 路由策略和可用性决定了该 Key 可以使用哪些模型。