sangtao.ai
API key

Tài khoản

Thông tin tài khoản

Tài khoản sở hữu API key: credit, gói tháng, key và giới hạn.

GEThttps://api.sangtao.ai/v2/account

Xác thực

  • X-Api-Keystring · headerbắt buộc

    API key của bạn, tạo ở trang API key trong tài khoản.

Key nào cũng đọc được — không cần scope riêng. Chỉ cần số dư? GET /account/balance nhẹ hơn.

Response

  • idstring

    Mã tài khoản công khai, không đổi. Dùng khi liên hệ hỗ trợ.

  • namestring

    Tên hiển thị của tài khoản.

  • emailstring

    Email của tài khoản.

  • emailVerifiedboolean

    Email đã xác minh chưa.

  • createdAtstring

    Lúc tạo tài khoản, ISO 8601 giờ UTC.

  • creditsobject

    Số dư, giống GET /account/balance (không có các trường chỉ web dùng).

    Hiện thuộc tính con

    • freeCreditnumber

      Từ gói tháng hoặc quà tặng; reset hằng tháng.

    • purchasedCreditnumber

      Đã mua; không hết hạn.

    • lockedCreditnumber

      Đang giữ cho các job đang chạy.

    • availableCreditnumber

      freeCredit + purchasedCredit − lockedCredit

    • hasPurchasedboolean

      Đã từng mua credit chưa.

  • subscriptionobject | null

    Gói tháng đang dùng. null nếu không có.

    Hiện thuộc tính con

    • tierstring

      Tên gói.

    • periodStartstring

      Đầu kỳ hiện tại.

    • periodEndstring

      Cuối kỳ hiện tại.

    • daysLeftnumber

      Số ngày còn lại của kỳ.

    • quotasobject[]

      Hạn mức của gói, theo từng model.

      Hiện thuộc tính con

      • modelstring | null

        Model dùng hạn mức này, theo tên công khai (ví dụ "gpt-image-2.6").

      • maxPerMonthnumber

        Tối đa mỗi tháng.

      • maxPerDaynumber

        Tối đa mỗi ngày.

      • usedThisPeriodnumber

        Đã dùng trong kỳ.

      • remainingnumber

        Còn lại trong kỳ.

  • apiKeyobject

    Key đang dùng để gọi.

    Hiện thuộc tính con

    • namestring

      Tên bạn đặt cho key.

    • prefixstring

      Vài ký tự đầu để phân biệt các key — không bao giờ là cả key.

    • legacyboolean

      true với key kiểu cũ: một key mỗi tài khoản, toàn quyền, không tên.

    • scopesstring[] | null

      Quyền của key. null là toàn quyền.

    • createdAtstring

      Lúc tạo key.

    • expiresAtstring | null

      Lúc key hết hạn. null: không hết hạn.

    • lastUsedAtstring | null

      Lần dùng gần nhất.

  • limitsobject

    Giới hạn của tài khoản.

    Hiện thuộc tính con

    • requestsPerMinutenumber

      Số request tối đa mỗi phút.

    • maxConcurrentJobsnumber

      Số job chạy cùng lúc tối đa.

GET/account
curl "https://api.sangtao.ai/v2/account" \
  -H "X-Api-Key: YOUR_API_KEY"
{
  "success": true,
  "data": {
    "id": "acct_3kT9qPz0B",
    "name": "An Nguyễn",
    "email": "[email protected]",
    "emailVerified": true,
    "createdAt": "2026-08-01T03:12:00Z",
    "credits": {
      "freeCredit": 50,
      "purchasedCredit": 100,
      "lockedCredit": 8,
      "availableCredit": 142,
      "hasPurchased": true
    },
    "subscription": {
      "tier": "Pro",
      "periodStart": "2026-11-01T00:00:00Z",
      "periodEnd": "2026-12-01T00:00:00Z",
      "daysLeft": 22,
      "quotas": [
        {
          "model": "gpt-image-2.6",
          "maxPerMonth": 3000,
          "maxPerDay": 200,
          "usedThisPeriod": 412,
          "remaining": 2588
        }
      ]
    },
    "apiKey": {
      "name": "Worker VPS-03",
      "prefix": "sk_live_ab12",
      "legacy": false,
      "scopes": [
        "jobs:create",
        "jobs:read"
      ],
      "createdAt": "2026-10-02T08:00:00Z",
      "expiresAt": null,
      "lastUsedAt": "2026-11-09T10:01:00Z"
    },
    "limits": {
      "requestsPerMinute": 6000,
      "maxConcurrentJobs": 20
    }
  }
}