RUNToken GATEWAY

API Reference

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

Base URLhttps://runtoken.runsphere.ai

认证 Authentication

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

账户与组织 Account & organizations

POST/v1/auth/register

注册用户,并创建默认组织与 API Key。

Public
POST/v1/auth/login

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

Public
GET/v1/me

获取当前用户及其组织成员关系。

JWT
GET/v1/orgs

列出当前用户所属组织。

JWT
POST/v1/orgs

创建组织。

JWT
POST/v1/orgs/:orgId/members

向组织添加成员(需 admin 角色)。

JWT
GET/v1/keys?orgId=…

列出组织的 API Keys。

JWT
POST/v1/keys

为组织创建 API Key。

JWT
DELETE/v1/keys/:id?orgId=…

撤销指定 API Key。

JWT

模型与推理 Models & inference

GET/v1/models

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

API Key
POST/v1/chat/completions

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

API Key

计费 Billing

POST/v1/billing/topup

创建组织预付费充值意向(需 admin 角色)。

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

生成指定账期账单(需 admin 角色)。

JWT

经销商 Resellers & affiliates

POST/v1/resellers

为组织创建经销商账户(需 admin 角色)。

JWT
POST/v1/resellers/referrals

创建推荐码。

JWT
POST/v1/resellers/referrals/attach

使用推荐码关联被推荐组织。

JWT
GET/v1/resellers/commissions

列出经销商佣金。

JWT
POST/v1/resellers/payouts

结算已累计佣金(需 admin 角色)。

JWT
GET/v1/resellers/summary

获取经销商业务概览。

JWT

管理端 Admin catalog

以下目录管理端点均要求 JWT,且用户须在至少一个组织中拥有 admin 或 owner 角色。

POST/admin/providers

创建 Provider。

Admin JWT
GET/admin/providers

列出 Providers。

Admin JWT
PATCH/admin/providers

更新 Provider。

Admin JWT
POST/admin/models

创建模型。

Admin JWT
GET/admin/models

列出模型。

Admin JWT
PATCH/admin/models

更新模型。

Admin JWT
POST/admin/models/:id/deployments

为模型添加 Provider 部署。

Admin JWT
GET/admin/models/:id/deployments

列出模型部署。

Admin JWT
POST/admin/models/:id/pricing

添加模型定价。

Admin JWT
GET/admin/models/:id/pricing

列出模型定价。

Admin JWT