专用供应凭据
凭据仅拥有“登记供应资源”权限,不能登录门户,也不能调用模型。原文仅在签发时显示一次。
- 请求头
- Authorization: Bearer
- 权限
- supply_api
- 轮换
- 先增后撤,可并行切换
供应商访问
使用开通时设置的用户名和密码。登录状态可保持 30 天,并可由平台随时撤销。
会话最长保持 30 天。账号或密码被重置时,现有会话立即退出。
管理渠道、订阅账号及其网络出口。只有通过质检的资源才会进入调度池。
| 资源 | 平台 / 模型 | 出口 | 池内状态 | 质检 | 成本倍率 |
|---|
调整搜索条件,或登记一份新的供应资源。
资源通过全部检查后才能接收流量。
查看自己登记过的每个账号、状态变化和实际产出。金额来自不可变用量与结算账本,不以调度估算代替。
只追加登记、状态和配置事件;凭据原文不会写入档案。
批量登记 API 渠道并获取可追踪回执。认证、幂等与资源质检是接口的一部分,不把风险留给供应商脚本。
创建 API 渠道
/api/v1/supply/resources
返回资源编号与提交回执。相同幂等键安全重放,不会重复上号。
凭据仅拥有“登记供应资源”权限,不能登录门户,也不能调用模型。原文仅在签发时显示一次。
curl --request POST 'https://your-xrouter.example/api/v1/supply/resources' \
--header 'Authorization: Bearer <SUPPLY_API_CREDENTIAL>' \
--header 'Idempotency-Key: channel-20260907-0001' \
--header 'Content-Type: application/json' \
--data '{
"name": "OpenAI 官方项目 · P08",
"kind": "api_channel",
"platform": "openai",
"base_url": "https://api.openai.com/v1",
"auth_type": "api_key",
"credential": "<UPSTREAM_API_KEY>",
"models": ["gpt-5.6-sol"],
"egress_id": "<VERIFIED_EGRESS_ID>",
"concurrency": 8,
"requests_per_minute": 300,
"tokens_per_minute": 600000,
"price_multiplier": 0.80
}'
订阅账号将使用服务方网页授权:创建短时会话、供应商在服务方完成登录、xrouter 校验回调与 state 后入库。平台不采集邮箱密码或 2FA 种子。
每个逻辑资源使用稳定键;超时后可重发原请求。
先在门户验证出口,再由 API 引用,避免代理密码进入脚本日志。
响应、生命周期档案与请求日志只保留摘要和资源编号。
供应商继续登记 SOCKS5/HTTP 代理;运营方也可以把本机公网 IP 开通为直连出口。一个出口可服务多份资源。
每笔金额保留上游用量、模型映射、价格版本与供应倍率。确认和异议只追加记录,不覆盖原账。
等待上游账单导入
按发生时间倒序,当前展示最近 100 笔。
| 发生时间 | 资源 / 平台 | 模型依据 | 令牌 | 应付金额 | 上游核对 | 状态 |
|---|
成功完成并收到上游用量后,记录会自动出现在这里。
查看一次模拟请求的候选过滤、评分因素与最终选择。
先执行租户、状态、平台、模型、配额和并发限制,再计算负载、排队、错误率、TTFT、质检、成本与会话亲和。
提交模拟请求后,这里会显示入选资源、分数和排除原因。