SStar Developers
开发者中心/开发者中心
统一接入概览和服务边界查看 Markdown

Star 开发者中心#

Star 为多个前端站点提供统一的登录、会员、积分、支付、AI 任务、动态定价、媒体存储和访问统计能力。本开发者中心同时服务人工开发者和 AI 编程工具。

从这里开始#

  1. 在 Star Admin 注册站点，取得唯一的 site_id，登记生产与测试 Origin、精确登录回调地址。
  2. 按配置与登录接入 Star Auth，并验证登录、刷新和退出。
  3. 按业务需要选择支付与订阅、模型与任务、聊天接入、动态定价或AI 工具。
  4. 在全局布局加入PV / UV 统计，最后执行上线验收。

服务地址#

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

平台边界#

服务负责内容前端禁止事项
Star Auth登录、会话、会员、积分、PV / UV不直接修改积分或套餐
Star Pay商品、Stripe / Airwallex Checkout、订单、退款履约不提交金额，不发放权益，不暴露支付密钥
Star Task模型、报价、扣点、同步/流式聊天、异步任务、R2 结果不写死供应商，不自行计算最终扣点
RokoAPIStar Task 内部模型供应和路由前端不直接持有平台 Token

面向 AI 开发工具#

AI 工具应从 SKILL.md 开始，并只加载当前任务需要的在线参考文件。所有参考文件都以 text/markdown 返回，可跨机器直接读取。

text
请先完整阅读 https://doc.starhk.uk/skill/SKILL.md，
再按其中路由读取与本次任务相关的 references 文档。
不要假定能访问任何本机 Star 仓库。

运行时真相来源#

文档描述稳定契约；模型启停、站点可用范围、商品价格和具体扣点必须读取运行时接口。不要把后台可变数据复制成长期硬编码。

  • 模型与模式：GET https://task.starhk.uk/v1/models?view=products&site_id=<SITE_ID>
  • 聊天模型：GET https://task.starhk.uk/v1/models?view=chat-picker&site_id=<SITE_ID>；调用使用 POST /v1/ai/chat，不是 /v1/tasks
  • AI 工具：GET https://task.starhk.uk/v1/tools?site_id=<SITE_ID>
  • 支付能力：GET https://pay.starhk.uk/api/v1/payment-methods/public?site_id=<SITE_ID>
  • 公共商品：GET https://pay.starhk.uk/api/v1/products/public

通用图片理解使用稳定工具 ID image-understanding，联网搜索使用 web-search-chat。调用、上传、轮询、失败退款和 0.01 点精度要求见 AI 工具；前端只依赖工具契约，不选择或感知后端实现。

上线原则#

任何新站点都必须验证站点隔离、未登录续接、重复提交幂等、支付 Webhook 最终一致性、任务失败退款、永久媒体 URL、移动端布局和前端产物无密钥。

图片分辨率定价#

1K/2K/4K 分档定价接入：服务端报价、可选价格版本保护、站点自定义价格、显式跟随上游，以及已接入站点的兼容规则。