Mini XUI 免费试用 API 接口使用 HTTPS。以下示例先将 BASE 设置为当前服务的 HTTPS 地址和端口, 例如 BASE=https://服务域名:8443。无需登录或付款即可申请试用。 MCP 客户端也可使用同一 HTTPS 服务的 /mcp(Streamable HTTP)。先调用 get_service_info,再通过 create_trial 申请;get_trial_status 和 get_trial_connection 使用创建结果中的 id 和 access_token。MCP 调用结果 包含秘密,使用前请确认客户端和模型提供方的对话及日志保存策略。 1. 查询服务和可用节点 curl "$BASE/v1/service" 从响应的 inbounds 中选择一个 inbound。当前支持 VLESS 和 Hysteria 2; 可用入站以服务响应为准。payment_available=false 表示付费功能尚未开放。 2. 创建试用账户 curl -X POST "$BASE/v1/trials" \ -H 'Content-Type: application/json' \ -d '{"inbound":"替换为第一步返回的 inbound"}' 请使用复数路径 /v1/trials。返回 JSON 包含 id、access_token、expires_at、 quota_bytes 和 ready。201 表示已同步;202 表示已预留名额、后台正在重试, 可按下面的接口查询。expires_at 是 UTC Unix 秒。有效期从预留名额时开始, 不是从第一次连接开始。请妥善保存 id 和 access_token,不要公开或写入日志。 3. 查询状态 curl "$BASE/v1/trials/账户ID" \ -H 'Authorization: Bearer 访问令牌' 将账户ID和访问令牌替换为第二步返回的 id 和 access_token。active 为 true 表示最近一次同步已生效且账户当前满足期限、额度及统计可用性条件; used_bytes 为近似上下行流量。ready=false 时可稍后查询状态。 4. 获取连接链接 curl "$BASE/v1/trials/账户ID/connection" \ -H 'Authorization: Bearer 访问令牌' 响应 JSON 的 link 可导入支持对应协议的代理客户端。link 是敏感凭据, 不要公开。没有订阅地址生成接口;请导入 link 本身。 错误说明:400 为请求格式或入站无效;401 为令牌缺失或错误;创建时 409 trial_capacity_reached 表示试用名额已满;获取连接时 409 not_active 表示 尚未生效或已结束;503 表示服务或流量统计暂不可用。账户创建请求如果超时, 服务器可能已创建账户;直接重试可能产生另一个账户。 试用额度为 1 GiB、30 分钟,最多 10 个占用名额。流量按周期采集,可能有 停用延迟或超额;试用凭据仅用于测试。若执行环境无法访问本 API 的 HTTPS 端口,或客户端无法访问返回链接中的代理端口,需要检查对应网络访问能力。