AI Cloud Seeker API 文档

平台概览

AI Cloud Seeker 基于 New API 构建，为合法授权的上游模型服务提供统一入口、身份认证、额度计量和调用日志。

快速开始

1. 访问 控制台并登录。
2. 进入「令牌」，创建并立即保存 Key。
3. 在「模型广场」确认可用模型名称和价格。
4. 发送请求：

复制curl https://aicloudseeker.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"model":"模型名称","messages":[{"role":"user","content":"你好"}]}'

接口与鉴权

OpenAI 兼容 SDK 一般只需设置 base_url 与 api_key。

令牌管理

入口：/console/token。建议不同项目、环境分别创建令牌。

API 调用

模型列表

复制curl https://aicloudseeker.com/v1/models \
  -H "Authorization: Bearer sk-你的令牌"

聊天补全

端点：POST /v1/chat/completions

复制{
  "model": "模型名称",
  "messages": [
    {"role": "system", "content": "你是一名简洁的中文助手。"},
    {"role": "user", "content": "解释向量数据库。"}
  ],
  "temperature": 0.7,
  "stream": false
}

流式返回请将 stream 设为 true，客户端按 SSE 逐块读取。

Responses

复制curl https://aicloudseeker.com/v1/responses \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"model":"模型名称","input":"写一句欢迎语"}'

SDK 示例

Python

复制from openai import OpenAI
client = OpenAI(
    api_key="sk-你的令牌",
    base_url="https://aicloudseeker.com/v1"
)
result = client.chat.completions.create(
    model="模型名称",
    messages=[{"role":"user","content":"你好"}]
)
print(result.choices[0].message.content)

Node.js

复制import OpenAI from "openai";
const client = new OpenAI({
  apiKey: "sk-你的令牌",
  baseURL: "https://aicloudseeker.com/v1"
});
const result = await client.chat.completions.create({
  model: "模型名称",
  messages: [{role:"user", content:"你好"}]
});
console.log(result.choices[0].message.content);

用量与计费

请求按模型价格、输入/输出 Token、缓存命中及分组倍率扣减额度。「日志」中可查看模型、Token、响应时间与扣费。

• 调用前确认模型价格与可用性。
• 合理设置 max_tokens。
• 生产令牌设置独立配额并监控异常用量。

管理员后台

管理员与用户共用控制台，登录后按角色展示管理菜单。

渠道管理

渠道只能连接平台合法持有或获授权的上游 API。选择服务商、填写 Key、勾选模型后，先测试再启用。

路由与分组

系统通常先比较优先级，再在同优先级的可用渠道中按权重选择。失败重试能提高可用性，也会增加延迟与成本。

• 用户分组：用户默认渠道和计费倍率。
• 令牌分组：令牌可指定渠道分组。
• 渠道分组：决定哪些分组可访问渠道。
• 模型映射：对外名称稳定，内部切换上游型号。

用户与运营

管理员可调整用户状态、角色、分组和额度，并管理兑换码、订阅、模型倍率与全站日志。

• 开放充值前发布服务条款、隐私政策、退款规则与联系方式。
• 确认每个上游许可范围允许提供相应服务。
• 价格覆盖输入、输出、缓存、汇率、手续费与重试成本。
• 支付回调验证签名和订单金额。
• 定期备份数据库并演练恢复。

常见错误

安全与合规

• 每个应用使用独立令牌，生产环境启用 IP 白名单。
• 通过环境变量或密钥服务保存 Key，禁止写入前端与公开仓库。
• 管理员使用唯一强密码并启用 2FA/Passkey（若已配置）。
• 异常调用立即禁用令牌并检查日志。
• 遵守上游条款、隐私、内容安全、税务和当地监管要求。