API 接入

1. 创建 API Key

登录 anypath.dev，进入 控制台 → API 接入，创建一个 Key。完整密钥只显示一次，请立即复制保存。

默认使用智能路由：AnyPath 会在符合条件且健康的共享路由之间自动选择。路由就是一个已保存的供应商凭证加上它能服务的模型；Key 的路由策略决定由 AnyPath 自动选路（智能路由），还是限定在一个供应商内（指定供应商）——指定供应商不等于锁定某一个具体 key。不熟悉路由、供应商、倍率这些概念？先读 核心概念。

API Key 只能保存在服务端的密钥管理中。不要放进浏览器、移动端 App、公开仓库、日志或截图。

2. 选择 Base URL

协议	Base URL	主要端点
OpenAI 兼容	https://api.anypath.dev/v1	/models, /chat/completions, /responses, /images/*
Anthropic Messages	https://api.anypath.dev	/v1/messages, /v1/messages/count_tokens
Gemini /v1beta	https://api.anypath.dev/v1beta	/models, /models/{model}:generateContent, /models/{model}:streamGenerateContent, /models/{model}:countTokens

3. 发现可用模型

curl https://api.anypath.dev/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.anypath.dev/v1",
)
models = client.models.list()
for m in models.data:
    print(m.id)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-api-key",
  baseURL: "https://api.anypath.dev/v1",
});
const models = await client.models.list();
models.data.forEach((m) => console.log(m.id));

响应只包含当前 API Key 和路由策略下可用的模型。构建模型选择器和保存模型配置时应以这个结果为准。

4. 发送网关请求

curl https://api.anypath.dev/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "用一段话总结附件的支持工单。"}
    ],
    "max_tokens": 300
  }'

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "用一段话总结附件的支持工单。"}],
    max_tokens=300,
)
print(response.choices[0].message.content)

const response = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "用一段话总结附件的支持工单。" }],
  max_tokens: 300,
});
console.log(response.choices[0].message.content);

只有当客户端确实需要对应协议的特定行为时，才使用 POST /v1/responses、/v1/messages 或 Gemini /v1beta。

生产环境检查

• 保存模型配置前，先调用 GET /v1/models。
• 显式设置请求超时和输出上限。
• 只重试 429、502、503、504 这类临时失败。如果响应有 Retry-After，以它为准。
• 接入生产流量前，在控制台确认价格、共享路由余额和 Key 使用上限。
• 共享路由在请求成功后按 USDT 结算。

下一步

• 认证：支持的认证方式。
• API 概览：端点参考。
• 定价与账单：价格怎么定，你会被扣多少。
• 资源提供方指南：接入官方算力并获得 USDT 收益。

快速入门覆盖 5 分钟调用方路径（API Key → 基础 URL → 首次请求）。资源提供方指南覆盖如何接入厂商凭证并获得收益。