📖 使用文档

人民中转是一个社区驱动的 AI API 共享平台。上传你的 API 密钥，获取一个通用站点密钥，一个密钥调用全站所有共享模型。

一、获取站点密钥

注册账号并登录
在控制台中上传你的 AI API 密钥（支持 OpenAI / Anthropic / DeepSeek 等）
系统自动测试连接并读取可用模型
生成 pt-xxx 格式的通用站点密钥

你已经共享的 API 越多，站点密钥调用时可用的模型就越多。

💡 提示：上传后系统会每 10 分钟检测一次 API 连通性。连续 3 次失败会自动禁用该 API 和你的站点密钥。

二、调用方式

人民中转兼容 OpenAI SDK 和 Anthropic SDK 格式。你只需要修改 baseURL 和 apiKey。

📡 OpenAI 格式（推荐）

适用于 OpenAI SDK、LangChain、Vercel AI SDK 等所有兼容 OpenAI 格式的客户端。

curl

curl https://key.aifcloud.shop/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的站点密钥" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Python (openai)

from openai import OpenAI

client = OpenAI(
    base_url="https://key.aifcloud.shop/api/v1",
    api_key="你的站点密钥"
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)

Node.js (openai)

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://key.aifcloud.shop/api/v1',
  apiKey: '你的站点密钥'
});

const response = await client.chat.completions.create({
  model: 'gpt-4o-mini',
  messages: [{ role: 'user', content: 'Hello!' }]
});
console.log(response.choices[0].message.content);

🧠 Anthropic 格式

适用于 Anthropic SDK 或 Claude 原生格式偏好。

curl https://key.aifcloud.shop/api/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: 你的站点密钥" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Python (anthropic)

from anthropic import Anthropic

client = Anthropic(
    base_url="https://key.aifcloud.shop/api/v1",
    api_key="你的站点密钥"
)

response = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.content[0].text)

三、模型列表

你可以通过以下方式查看所有可用模型：

访问模型广场 — 可视化浏览所有模型
API 调用 GET https://key.aifcloud.shop/api/v1/models — 获取 JSON 格式模型列表

curl https://key.aifcloud.shop/api/v1/models \
  -H "Authorization: Bearer 你的站点密钥"

四、模型选择说明

当你调用代理 API 时，系统会自动从所有活跃的共享 API 中选取一个来响应你的请求。模型名称仅用于标识，实际调用的模型取决于你上传的 API 所支持的模型。

📌 注意：模型广场中展示的模型来自全站共享。你在调用时传的 model 参数会被用于匹配，系统会优先选择支持该模型的 API 进行转发。

五、配额说明

账户等级	日配额	月配额	获取条件
🥇 高端	500 次/天	500 万 tokens/月	上传包含高端模型的 API
🥈 中端	300 次/天	200 万 tokens/月	上传包含中端模型的 API
🥉 基础	100 次/天	50 万 tokens/月	默认等级，注册即可使用

在控制台可以查看当前配额的实时使用情况。

六、常见问题

为什么上传 API 后检测失败？

可能原因：API 地址不正确、密钥已过期或需要续费、该 API 服务当前不可用。请检查你的 API 提供商状态。

代理调用的响应速度如何？

系统会选择响应最快的 API 进行转发（所有 API 经过延迟排序）。通常响应时间在 500ms-3s 之间，取决于上游 API 的响应速度。

站点密钥可以分享给他人使用吗？

可以。站点密钥本身就是设计为共享使用的。但请注意：所有 API 调用会计入你的配额，分享密钥可能导致配额快速用完。

如何确保 API 密钥安全？

你的 API 密钥仅用于验证和代理转发，不会明文展示给其他用户。你可以在控制台随时重新生成站点密钥，旧密钥会立即失效。

支持流式输出 (Stream) 吗？

支持。代理完全兼容 SSE 流式输出，你可以在请求中添加 "stream": true。

支持哪些模型提供商？

支持所有兼容 OpenAI 格式的提供商（OpenAI、DeepSeek、通义千问、Moonshot 等）以及原生 Anthropic 格式（Claude）。系统会自动识别并做格式转换。