快速开始
AnyInt 的设计旨在消除使用先进 AI 模型的阻碍。你无需花时间对接多个提供商、比较不同的 API 风格、猜测该用哪个模型,而是从一个网关和一条关键流程开始。
AnyInt 的设计旨在消除使用先进 AI 模型的阻碍。你无需花时间对接多个提供商、比较不同的 API 风格、猜测该用哪个模型,而是从一个网关和一条关键流程开始。
最快的路径是先从与 OpenAI 兼容的端点开始,确认你的账号可用哪些模型 ID,然后只在需要时再扩展到提供商原生或媒体工作流。
开始之前你需要
- 一个 AnyInt API 密钥
- 一个你的账号可用的模型 ID
- 一个 HTTP 客户端或 SDK
AnyInt 帮你避免的事项
如果没有平台层,团队通常不得不:
- 分别在多个提供商处注册
- 管理不同的认证和请求格式
- 猜测哪个模型对任务来说足够好
- 因为不确定哪些能力可以安全降级,而过度使用昂贵模型
AnyInt 降低了这部分接入成本,并通过路由和策略提供通往更智能模型选择的路径。
选择正确的端点家族
| 家族 | 基础 / 路径 | 认证方式 | 在以下情况下使用 |
|---|---|---|---|
| 兼容 OpenAI | https://api.anyint.ai/openai/v1 | Authorization: Bearer | 你已经在使用 OpenAI SDK,或者只想要一个简单的聊天入口点 |
| 兼容 Anthropic | https://api.anyint.ai/anthropic/v1 | x-api-key + anthropic-version | 你需要 Claude 风格的消息体或 token 计数 |
| 兼容 Gemini | https://api.anyint.ai/gemini/v1beta | Authorization: Bearer | 你需要 Gemini 原生 generateContent、流式传输或函数声明 |
| Models API | https://api.anyint.ai/openai/v1/models | Authorization: Bearer | 你想在硬编码之前先发现模型 ID |
| AI 音乐 | https://api.anyint.ai/suno/* | Authorization: Bearer | 你想要歌曲生成、翻唱工作流、歌词、分轨或 MV 生成 |
请使用 models 路由返回的模型 ID,或在控制台配置中显示的模型 ID。不要假设某个公开的营销名称已为你的账号启用。
推荐的首次请求流程
- 在控制台中创建一个 AnyInt API 密钥。
- 调用
GET /openai/v1/models以发现你的账号可见的模型 ID。 - 对以下端点发起流式请求
POST /openai/v1/chat/completions. - 只有在你需要提供商原生请求格式时,才切换到 Anthropic、Gemini、媒体或 AI Music 路由。
- 在生产中使用前,运行 验证你的集成 清单。
使用 OpenAI SDK 的 Python 示例
from openai import OpenAI
client = OpenAI(
base_url="https://api.anyint.ai/openai/v1",
api_key="your-anyint-api-key",
)
response = client.chat.completions.create(
model="claude-sonnet-4-6",
stream=True,
messages=[
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Say hello from AnyInt."},
],
)
for chunk in response:
delta = chunk.choices[0].delta.content
if delta:
print(delta, end="")这与 OpenRouter 风格的“发起你的第一次请求”流程最为接近,也是已经使用 OpenAI 兼容客户端的应用最容易上手的起点。
使用 OpenAI SDK 的 Node.js 示例
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.anyint.ai/openai/v1",
apiKey: process.env.ANYINT_API_KEY,
});
const response = await client.chat.completions.create({
model: "claude-sonnet-4-6",
stream: true,
messages: [
{ role: "system", content: "You are a concise assistant." },
{ role: "user", content: "Say hello from AnyInt." },
],
});
for await (const chunk of response) {
const delta = chunk.choices?.[0]?.delta?.content;
if (delta) process.stdout.write(delta);
}cURL
curl https://api.anyint.ai/openai/v1/chat/completions \
-H "Authorization: Bearer $ANYINT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"stream": true,
"messages": [
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Say hello from AnyInt."}
]
}'当 stream: true,该路由会返回 SSE 分块。每个事件都包含一个 chat.completion.chunk 有效载荷,流会以以下内容结束 [DONE].
先发现模型 ID
在硬编码模型名称之前,请先使用已发布的 models 路由查看你的账号可用内容。
curl https://api.anyint.ai/openai/v1/models \
-H "Authorization: Bearer $ANYINT_API_KEY"Anthropic 兼容客户端也可以使用 x-api-key 和 anthropic-version 请求头调用 GET /anthropic/v1/models。
典型响应字段:
data[].id:你后续请求中应发送的模型 IDdata[].display_name:一个便于理解的人类可读标签data[].created_at:模型的发布时间戳
何时应从 OpenAI 兼容路由切换出去
| 需求 | 继续阅读 |
|---|---|
| Claude 风格的消息块、图像输入或 token 计数 | Anthropic 兼容 API |
Gemini 原生 generateContent、流式传输、图像生成或函数声明 | Gemini 兼容 API |
| 通过 DashScope 进行图像和视频生成 | 媒体 API |
| 歌曲生成、翻唱、分轨、歌词或 MV 工作流 | 媒体与音乐总览 |
生产前
使用 验证你的集成 确认 API 密钥处理、模型发现、流式输出、异步任务轮询、回调处理和重试行为。普通 AI API 集成不需要支付类测试卡流程;请使用你自己的账号和安全示例提示词直接验证公开 API 契约。