RUNToken GATEWAY

API Reference

OpenAI 兼容的模型调用,以及 RunToken 原生的账户、计费、渠道和目录管理 API。

Base URLhttps://api.ontosphere.ai

认证 Authentication

推理和模型目录使用 API Key:Authorization: Bearer rt-...。账户管理使用登录获得的 JWT Bearer token。注册和登录无需认证;billing webhook 由 Provider 签名验证。

用户账户 User account

POST/v1/auth/register

注册独立用户账户,并创建 API Key。

Public
POST/v1/auth/login

使用邮箱和密码登录并获取 JWT。

Public
GET/v1/me

获取当前账户:{user:{id,email,name,status,isPlatformAdmin}}

JWT
GET/v1/keys

列出当前用户的 API Keys。

JWT
POST/v1/keys

为当前用户创建 API Key。

JWT
DELETE/v1/keys/:id

撤销当前用户的指定 API Key。

JWT

模型与推理 Models & inference

GET/v1/models

获取可用模型、部署与价格目录。

API Key
POST/v1/chat/completions

创建 OpenAI 兼容的聊天补全,支持 SSE 流式响应。

API Key

计费 Billing

POST/v1/billing/topup

为当前用户创建预付费充值意向。

JWT
POST/v1/billing/webhook

接收计费 Provider 的充值回调。

Signature
GET/v1/billing/balance

查询当前用户余额;支持 JWT 或 API Key。

JWT / API Key
GET/v1/billing/usage

按时间范围汇总当前用户用量。

JWT
GET/v1/billing/invoices

列出当前用户账单。

JWT
POST/v1/billing/invoices

为当前用户生成指定账期账单。

JWT

经销商 Resellers & affiliates

POST/v1/resellers

将当前用户注册为经销商。

JWT
POST/v1/resellers/referrals

创建推荐码。

JWT
POST/v1/resellers/referrals/attach

使用推荐码关联当前用户。

JWT
GET/v1/resellers/commissions

列出经销商佣金。

JWT
POST/v1/resellers/payouts

结算当前用户已累计的佣金。

JWT
GET/v1/resellers/summary

获取经销商业务概览。

JWT

平台管理 Admin API

所有 /admin/* 端点均要求平台管理员 JWT;用户须通过 PLATFORM_ADMIN_EMAILS 配置获得 isPlatformAdmin 权限。

POST/admin/providers

创建 Provider。

Platform-admin JWT
GET/admin/providers

列出 Providers。

Platform-admin JWT
PATCH/admin/providers

更新 Provider。

Platform-admin JWT
POST/admin/models

创建模型。

Platform-admin JWT
GET/admin/models

列出模型。

Platform-admin JWT
PATCH/admin/models

更新模型。

Platform-admin JWT
POST/admin/models/:id/deployments

为模型添加 Provider 部署。

Platform-admin JWT
GET/admin/models/:id/deployments

列出模型部署。

Platform-admin JWT
POST/admin/models/:id/pricing

添加模型定价。

Platform-admin JWT
GET/admin/models/:id/pricing

列出模型定价。

Platform-admin JWT
GET/admin/users?limit=…&offset=…&q=…

分页搜索平台用户。

Platform-admin JWT
PATCH/admin/users/:userId

设置用户状态:{status:"active"|"suspended"}

Platform-admin JWT
POST/admin/users/:userId/credits

调整用户余额:{amount, reason?}

Platform-admin JWT
GET/admin/stats?days=…

获取指定天数的平台统计。

Platform-admin JWT
GET/admin/invoices?status=…

按可选状态筛选用户账单。

Platform-admin JWT
GET/admin/receivables

获取按用户汇总的平台应收账款。

Platform-admin JWT