InfiniSynapse Partner Silent Provisioning Guide

你的服务端                        InfiniSynapse
   │                                  │
   │ ① 开通子账号（首次用到某用户时调用一次） │
   │ ──── POST /users/provision ────▶│  按 (clientId, externalUserId) 幂等
   │ ◀─── { infiniUserId, apiKey } ──│  建号 + 签发专属 API Key
   │                                  │
   │ ② 代用户调用开放 API（之后日常使用）    │
   │ ── Authorization: Bearer sk-xxx ▶│  用量自动从你的主账号余额扣除
   │ ◀────────── 结果 ───────────────│

{
  "code": 200,
  "message": "success",
  "data": { }
}

POST /api/auth/partner/users/provision
X-Client-Id: partner_xxxxxxxx
X-Client-Secret: psk_xxxxxxxx
Content-Type: application/json

{
  "code": 200,
  "message": "success",
  "data": {
    "infiniUserId": "68d21916d6802ec254b46975",
    "externalUserId": "your-user-123",
    "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
    "created": true
  }
}

POST /api/auth/partner/users/apikey/rotate
Body: { "externalUserId": "your-user-123" }

POST /api/auth/partner/users/revoke
Body: { "externalUserId": "your-user-123" }

GET /api/auth/partner/users/{externalUserId}

{
  "infiniUserId": "...",
  "externalUserId": "your-user-123",
  "status": "active",
  "hasApiKey": true,
  "created": 1751443200000,
  "lastProvisionAt": 1751443200000,
  "disabledAt": null
}

GET /api/auth/partner/users/{externalUserId}/balance

{
  "infiniUserId": "...",
  "billingUserId": "主账号 userId",
  "shared": true,
  "orderBalance": 128.5,
  "totalBalance": 128.5
}

GET /api/auth/partner/users?page=1&pageSize=50&status=active

{
  "list": [
    {
      "externalUserId": "your-user-123",
      "infiniUserId": "...",
      "status": "active",
      "hasApiKey": true,
      "createTime": 1751443200000,
      "lastProvisionAt": 1751443200000,
      "disabledAt": null
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 50
}

GET /api/auth/partner/users/{externalUserId}/costs?page=1&pageSize=20&startTime=&endTime=&groupByTask=false

{
  "infiniUserId": "...",
  "externalUserId": "your-user-123",
  "groupByTask": false,
  "list": [
    { "taskId": "c3a2f9d0-...", "chatId": "...", "cost": 1.2, "model": "gpt-x", "createTime": 1751443200000 }
  ],
  "total": 37,
  "page": 1,
  "pageSize": 20
}

{
  "groupByTask": true,
  "list": [
    { "taskId": "c3a2f9d0-...", "totalCost": 5.8, "count": 6, "models": ["gpt-x"], "firstTime": 1751443200000, "lastTime": 1751443800000 }
  ],
  "total": 12,
  "page": 1,
  "pageSize": 20
}

GET /api/auth/partner/users/{externalUserId}/cost-stats?startTime=&endTime=

{
  "infiniUserId": "...",
  "externalUserId": "your-user-123",
  "totalCost": 42.6,
  "recordCount": 37,
  "modelStats": [
    { "model": "gpt-x", "cost": 30.1, "count": 20 },
    { "model": "gpt-y", "cost": 12.5, "count": 17 }
  ]
}

GET /api/auth/partner/costs?page=1&pageSize=50&startTime=&endTime=

{
  "clientId": "partner_xxxxxxxx",
  "grandTotalCost": 128.9,
  "subAccountCount": 25,
  "list": [
    { "externalUserId": "your-user-123", "infiniUserId": "...", "totalCost": 42.6, "recordCount": 37 },
    { "externalUserId": "your-user-456", "infiniUserId": "...", "totalCost": 30.2, "recordCount": 21 }
  ],
  "total": 18,
  "page": 1,
  "pageSize": 50
}

POST https://app.infinisynapse.cn/api/ai/message
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

{
  "type": "newTask",
  "taskId": "c3a2f9d0-你生成的UUID-用于幂等",
  "text": "分析最近 7 天的销售数据，输出图表报告",
  "images": []
}

const PROXY_API = 'https://api.infinisynapse.cn/api'
const APP_API = 'https://app.infinisynapse.cn/api'
const partnerHeaders = {
  'Content-Type': 'application/json',
  'X-Client-Id': process.env.INFINI_CLIENT_ID,
  'X-Client-Secret': process.env.INFINI_CLIENT_SECRET,
}

async function callPartner(path, options = {}) {
  const resp = await fetch(`${PROXY_API}${path}`, { headers: partnerHeaders, ...options })
  const json = await resp.json()
  if (json.code !== 200) throw new Error(`${path} 失败: ${json.message}`)
  return json.data
}

// 1. 首次用到某用户时：开通子账号并缓存 apiKey（幂等，可安全重试）
async function ensureInfiniAccount(user) {
  const data = await callPartner('/auth/partner/users/provision', {
    method: 'POST',
    body: JSON.stringify({
      externalUserId: user.id,
      profile: { nickname: user.nickname, email: user.email },
    }),
  })
  // 把 data.infiniUserId / data.apiKey 存入你的用户表
  return data
}

// 2. 代用户发起一个分析任务（消耗从主账号余额扣除）
async function createTask(apiKey, text) {
  const resp = await fetch(`${APP_API}/ai/message`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${apiKey}`,
    },
    body: JSON.stringify({ type: 'newTask', taskId: crypto.randomUUID(), text, images: [] }),
  })
  return resp.json()
}

// 串起来
const { apiKey } = await ensureInfiniAccount({ id: 'your-user-123', nickname: '小明' })
await createTask(apiKey, '分析最近 7 天的销售数据，输出图表报告')