一次接入，统一登录、任务、扣点与统计。

稳定边界

已接入站点无需感知具体供应商，公开接口、登录、扣点与结果 URL 保持不变。

RokoAPI 任务失败时不会转回 Evolink/GRSAI；图片、视频与音频只有成功持久化到 Star Task R2 后才会向前端报告成功。

快速开始

统一登录

https://auth.starhk.uk/login?site_id=site-xx&redirect=ENCODED_CALLBACK_URL

服务地址

AUTH_BASE_URL=https://auth.starhk.uk
TASK_BASE_URL=https://task.starhk.uk
DOCS_BASE_URL=https://doc.starhk.uk

AI 任务与扣点

用用户 Access Token 调用 POST /v1/tasks。每次真实操作生成 UUID v4 幂等键；网络重试复用同一个键。创建响应中的 cost_points 是权威扣点值。

fetch('https://task.starhk.uk/v1/tasks', {
  method: 'POST',
  headers: { Authorization: 'Bearer <token>', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    site_id: 'site-xx', model: 'nano-banana-2', task_type: 'text-to-image',
    input: { prompt: 'Hong Kong harbour at dawn', quality: '1K' },
    idempotency_key: crypto.randomUUID()
  })
})

前端不要调用点数消费接口，也不要写死供应商或扣点。通过 /v1/models 与 /v1/pricing/rules 获取当前站点的有效配置。

RokoAPI 能力目录

Star Task 已具备以下类型的 RokoAPI 协议适配。前端实际可展示的模型以在线 /v1/models 返回为准，灰度与定价启用由后台控制。

PV / UV 自动上报

在全局布局加入一行代码。SDK 自动生成匿名 UUID、上报首次访问和 SPA 路由变化，并跳过登录回调；失败不会影响页面。

<script defer src="https://doc.starhk.uk/sdk/analytics.js" data-site-id="site-xx"></script>

数据发送至 https://auth.starhk.uk/analytics/collect。PV 是被接受的页面访问次数，UV 是统计周期内不同匿名访客 UUID 数；后台可查看今日、当月与趋势。不要上报邮箱、用户 ID、Prompt 或 Token。

给 AI 编程工具的 Skill

把 Skill 目录交给 Codex 等 AI 编程工具，它会按真实契约完成登录、模型发现、扣点、任务与统计接入。

上线前最小验收