用量聚合、余额与流水、价目表、计费告警与策略、兑换码。 完整参数、请求 / 响应 schema 见下方（本页只渲染该组）：
Rayrun REST API —— 控制台与命令行（rayrun CLI）的统一接口，也是自托管部署的
第三方集成的接入点。共 13 组、93 个端点（分组见左侧栏或「介绍」页的接口一览）。
基地址与部署同源：<实例地址>/v1（如 https://rayrun.example.com/v1）。
认证：Bearer Token（控制台「设置 → 我的 API Token」或 rayrun login 创建）
或浏览器会话 Cookie；GET /health 免认证。详见「介绍」页的认证一节。
用量聚合、余额与流水、价目表、在线充值（微信支付）、兑换码。
tokens 为 trust = Guest，仅展示，永不参与计费
缺省 = 全局（MVP 即全部沙箱）；给定 = 该沙箱
curl https://api.rayrunos.com/v1/usage \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"vm_hours": 1,
"egress_bytes": 1,
"tokens": {
"input_tokens": 1,
"output_tokens": 1,
"cost_usd": null
}
}curl https://api.rayrunos.com/v1/billing/balance \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"balance_cents": 1,
"currency": "string"
}现场计算当前组织的活跃告警与策略。欠费状态（arrears_stop）始终返回， 不受平台告警开关影响；balance_low / balance_non_positive / runway_low / usage_daily_high 只在平台开启可选告警时返回。只读端点：不发信、不写 journal、不做去重。
curl https://api.rayrunos.com/v1/billing/alerts \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"alerts": [
{
"kind": "balance_low",
"severity": "warning",
"scope": "string",
"sandbox_id": null,
"current": 1,
"threshold": 1,
"unit": "cents",
"message": "string",
"action_url": "string",
"grace_deadline": null
}
],
"policy": {
"arrears_grace_days": 1
}
}降序模式游标（seq，string）；与 from_seq 互斥
升序续传起点（seq，string）；与 cursor 互斥
默认 50，上限 500
curl 'https://api.rayrunos.com/v1/billing/transactions?limit=50' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"entries": [
{
"seq": "string",
"entry_id": "123e4567-e89b-12d3-a456-426614174000",
"tenant_id": "string",
"user_id": "string",
"sandbox_id": null,
"kind": "string",
"payload": {},
"ts": "2026-11-11T06:00:17.727Z",
"trust": "Host",
"risk": "Low",
"outcome": "Success"
}
],
"next_cursor": null
}读启动时解析的全局价目表（RAYRUN_PRICING_JSON）；新沙箱创建时按此快照进 sandbox.created.payload
curl https://api.rayrunos.com/v1/billing/pricing \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"currency": "string",
"cpu_cents_per_core_hour": 1,
"mem_cents_per_gb_hour": 1,
"egress_cents_per_gb": 1,
"storage_cents_per_gib_month": 1,
"storage_free_gib_per_sandbox": 1
}大写规范形（比对大小写不敏感，handler 规范化后校验）；7 组 × 4 字符、28 字符去歧义字母表（去 0/1/O/I，≈ 134 bit）；响应与审计永不含码值
curl https://api.rayrunos.com/v1/redemption-codes/redeem \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"code": ""
}'
{
"amount_cents": 1,
"balance_cents": 1,
"currency": "string"
}curl https://api.rayrunos.com/v1/billing/recharge \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"enabled": true,
"currency": "string",
"presets_cents": [
1
],
"min_cents": 1,
"max_cents": 1
}可选幂等键；同一用户同一 key 在 24h 内重放首次 201
充值金额（分）；范围为 GET /billing/recharge 的 min_cents..max_cents
h5 = 手机浏览器跳转微信支付；native = 桌面二维码扫码
curl https://api.rayrunos.com/v1/orders \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"amount_cents": 1,
"channel": "h5"
}'
{
"order_id": "123e4567-e89b-12d3-a456-426614174000",
"status": "pending",
"channel": "h5",
"amount_cents": 1,
"currency": "string",
"pay_url": null,
"pay_url_expires_at": null,
"expires_at": "2026-11-11T06:00:17.727Z",
"created_at": "2026-11-11T06:00:17.727Z",
"paid_at": null
}充值订单 ID（UUIDv7）
curl https://api.rayrunos.com/v1/orders/123e4567-e89b-12d3-a456-426614174000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"order_id": "123e4567-e89b-12d3-a456-426614174000",
"status": "pending",
"channel": "h5",
"amount_cents": 1,
"currency": "string",
"pay_url": null,
"pay_url_expires_at": null,
"expires_at": "2026-11-11T06:00:17.727Z",
"created_at": "2026-11-11T06:00:17.727Z",
"paid_at": null
}