OnePort AI 聚合平台 API 使用文档

1. 基础介绍

OnePort AI 是一站式大模型 API 聚合平台，提供主流 AI 大模型的统一 API 接入。只需一个 API Key，即可按场景选择分组调用多种模型，无需分别注册海外账号、无需逐个对接官方接口。

四步快速接入

1. 注册账号：oneport.cc/register
2. 充值余额：在「钱包」自助充值或使用兑换码
3. 创建 API Key：在「令牌 / API Keys」创建，并选择对应分组
4. 开始调用：按本文档配置 Base URL 与 Key 即可发起请求

核心公式

1.1 站点操作指南

注册后建议先小额充值测试。企业客户或接入协助可联系站点客服（见控制台 / 页脚公示渠道）。

步骤 1 · 充值余额

• 进入控制台左侧「钱包」，按需充值，确保账户余额大于 0
• 如有兑换码，在兑换入口输入后即可到账
• 可在账单中查看充值与消费记录

步骤 2 · 创建 API Key 并选择分组

• 进入「令牌 / API Keys」，点击添加
• 填写名称，选择令牌分组，设置额度后提交
• 不同分组可用模型与价格请到「价格广场 / 模型广场」查看

步骤 3 · 设置余额预警（可选）

建议在个人设置中配置预警阈值，避免余额用尽导致服务中断。

步骤 4 · 使用 API Key

将 Key 放在 HTTP Header 中鉴权，向 https://oneport.cc 发送请求。第三方软件常见填写形式：

• https://oneport.cc
• https://oneport.cc/v1
• https://oneport.cc/v1/chat/completions

具体以客户端要求为准；也可在价格广场点击模型查看对应端点提示。

1.2 为什么选择 OnePort

1.3 价格 · 充值 · 分组介绍

计费原则

• 模型按输入 / 输出 / 缓存 tokens（或按次）计费，价格以「价格广场」实时展示为准
• 实际扣费与令牌所属分组倍率相关
• 开票与对公需求请联系客服，并提供用户名、开票信息与金额

六档分组（生产）

2. API 软件接入使用教程

本章介绍如何将 OnePort 接入常用客户端与开发工具。

2.1 专有名词速查

2.2 常见问题

额度如何计算？

消耗额度 ≈ 分组倍率 × 模型单价相关倍率 ×（提示 Token + 补全 Token × 补全倍率）。每次调用实时扣减，令牌额度或账户余额不足将无法继续调用。

常见报错

2.3 Chatbox

1. 打开 Chatbox，进入设置，API 模式选择 OpenAI API 兼容
2. API 域名填写 https://oneport.cc/v1
3. API 密钥填写 OnePort 令牌
4. 模型填写价格广场中的模型 ID（如 gpt-5.4-mini）
5. 保存后发送测试问题

2.4 VS Code · Cline

1. 安装官方 Cline 插件
2. API Provider 选择 OpenAI Compatible
3. Base URL：https://oneport.cc/v1（部分版本可填 https://oneport.cc/）
4. 填入 API Key 与 Model ID
5. 保存后发起任务测试

2.5 Cherry Studio

1. 设置 → 模型服务 → 添加供应商
2. 类型选择 OpenAI（Claude 原生可选 Anthropic）
3. API 地址：https://oneport.cc
4. 填入 API Key，拉取或手动添加模型 ID
5. 启用后在会话顶部切换模型

2.6 Codex

编辑用户目录 ~/.codex/config.toml（Windows 一般为 C:\Users\<你的用户名>\.codex\config.toml）：

model_provider = "oneport"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.oneport]
name = "oneport"
base_url = "https://oneport.cc/v1"
wire_api = "responses"
requires_openai_auth = true

若使用 auth.json：

{
  "OPENAI_API_KEY": "sk-your-oneport-api-key-here"
}

2.7 WorkBuddy / 自定义 OpenAI

1. 选择自定义 OpenAI / Compatible 提供商
2. 完整 URL 可填：https://oneport.cc/v1/chat/completions
3. 或 Base URL 填 https://oneport.cc/v1，由客户端自动拼接
4. 填入 OnePort Key 与模型 ID

2.8 OpenCode / Trae / AnythingLLM

统一原则：Provider 选 OpenAI Compatible / Generic OpenAI，Base URL 使用 https://oneport.cc/v1，Key 使用 OnePort 令牌，模型 ID 从价格广场复制。

OpenCode opencode.json 示例：

{
  "provider": {
    "oneport": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OnePort AI",
      "options": {
        "baseURL": "https://oneport.cc/v1",
        "apiKey": "sk-your-api-key-here"
      },
      "models": {
        "gpt-5.4": {},
        "gpt-5.4-mini": {}
      }
    }
  }
}

3. API 接口参考

3.1 支持的接口端点

3.2 鉴权方式

Authorization: Bearer sk-your-api-key-here
Content-Type: application/json

3.3 模型列表

curl -X GET https://oneport.cc/v1/models \
  -H "Authorization: Bearer sk-your-api-key-here"

3.4 聊天补全（Chat Completions）

curl -X POST https://oneport.cc/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {"role": "system", "content": "你是一个专业的AI助手。"},
      {"role": "user", "content": "用三句话介绍 OnePort。"}
    ],
    "temperature": 0.7,
    "stream": false
  }'

Python（OpenAI SDK）：

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key-here",
    base_url="https://oneport.cc/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[
        {"role": "user", "content": "你好"},
    ],
)
print(resp.choices[0].message.content)

3.5 图像生成

curl -X POST https://oneport.cc/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只在港口看日出的橘猫，插画风格",
    "size": "1024x1024"
  }'

4. 支持与使用边界

• 额度、账单、消费明细请在 OnePort 控制台 / 钱包 / 日志中查看，勿向模型追问账户机密信息
• 请勿在对话中索要或传播 API Key、渠道地址等敏感信息
• 模型能力说明以价格广场与实际调用结果为准
• 生产环境域名：https://oneport.cc