Gói GrokTeam Grok Quota
Dành cho tài khoản có team Grok Quota: tạo key ảnh và video Grok tính theo lượt cho từng thành viên ngay từ hệ thống của bạn — mua lượt một lần, dùng dần, không hết hạn.
Framewharf cấp cho tài khoản có team Grok Quota một key quản lý bắt đầu bằng fwquota_. Gửi nó trong header Authorization: Bearer. Key quản lý chỉ tạo, xem, sửa, xoá key của team, đọc lịch sử budget và số key còn tạo được; key thành viên nhận được mới là key gọi mô hình, bắt đầu bằng sk-.
Mỗi key bán theo lượt: 504000 mỗi 1000 lượt. Một video — tạo mới, sửa hay nối thêm — là 1 lượt, một ảnh 0.25 lượt, bất kể độ dài hay độ phân giải; job lỗi được hoàn lượt. Lượt không hết hạn, và mỗi key chạy tối đa 10 job cùng lúc.
Budget của team là ví trả trước. Tạo key hay nạp thêm lượt trừ ngay giá của số lượt đó; xoá key thì phần lượt chưa dùng được hoàn vào budget. Mỗi lần budget thay đổi là một dòng trong lịch sử budget.
https://framewharf.com/api/v1/grok-quota/keysAuthorization: Bearer fwquota_...Tạo một key lượt mới. Cả hai trường đều bắt buộc:
curl "https://framewharf.com/api/v1/grok-quota/keys" \
-H "Authorization: Bearer fwquota_..." \
-H "Content-Type: application/json" \
-d '{ "name": "Khách A", "quota": 5000 }'Trường key chỉ trả về một lần trong phản hồi này. Giao nó cho thành viên để gọi API ảnh và video Grok như mọi key khác. concurrent là số job key chạy được cùng lúc, price_vnd là số tiền vừa trừ khỏi budget, free_vnd là số dư còn lại.
{
"id": "cm...",
"name": "Khách A",
"key": "sk-...",
"quota": 5000,
"concurrent": 10,
"price_vnd": 2520000,
"free_vnd": 22680000
}https://framewharf.com/api/v1/grok-quota/keysTrả về budget đã được cấp (budget_vnd), phần các key đã tiêu sau khi trừ tiền hoàn (allocated_vnd), số dư còn lại (free_vnd, luôn bằng budget_vnd − allocated_vnd) và mọi key của team, mới nhất trước.
{
"budget_vnd": 25200000,
"allocated_vnd": 2520000,
"free_vnd": 22680000,
"keys": [
{
"id": "cm...",
"name": "Khách A",
"quota": 5000,
"units_left": 4987.75,
"key_hint": "sk-...abcd",
"refund_vnd": 2513826,
"created_at": "2026-10-29T08:00:00.000Z",
"last_used_at": "2026-10-29T09:12:00.000Z"
}
]
}quota là tổng số lượt đã mua cho key, units_left là số lượt còn lại (lẻ một phần tư khi có ảnh; null khi chưa đọc được), refund_vnd là số tiền được hoàn nếu xoá key ngay lúc đọc.
https://framewharf.com/api/v1/grok-quota/keys/{id}Sửa một key tại chỗ: thành viên giữ nguyên key đang dùng. Gửi trường nào muốn đổi:
curl -X PATCH "https://framewharf.com/api/v1/grok-quota/keys/cm..." \
-H "Authorization: Bearer fwquota_..." \
-H "Content-Type: application/json" \
-d '{ "add_quota": 2000 }'{
"id": "cm...",
"name": "Khách A",
"quota": 7000,
"charged_vnd": 1008000,
"free_vnd": 21672000
}charged_vnd là số tiền lượt mua thêm, trừ ngay khỏi budget, free_vnd là số dư sau đó. Key đã hết lượt chạy lại ngay sau khi nạp. Nạp thêm cần đủ số dư; đổi tên thì luôn được.
https://framewharf.com/api/v1/grok-quota/keys/{id}Xoá key của một thành viên. Key ngừng hoạt động ngay. Tiền của lượt chưa dùng được chốt và hoàn vào budget sau 10 phút — khi mọi request cuối của key, kể cả video đang render, đã tính xong — thành một dòng key_delete trong lịch sử budget. Phản hồi là 204.
curl -X DELETE "https://framewharf.com/api/v1/grok-quota/keys/cm..." \
-H "Authorization: Bearer fwquota_..."https://framewharf.com/api/v1/quotaAuthorization: Bearer sk-...Thành viên tự tra lượt còn lại bằng chính key sk- của họ — không cần key quản lý:
curl "https://framewharf.com/api/v1/quota" \
-H "Authorization: Bearer sk-..."{
"object": "quota",
"total": 7000,
"used": 12.25,
"remaining": 6987.75,
"video_units": 1,
"image_units": 0.25
}used và remaining tính theo lượt, nên có thể lẻ một phần tư khi có ảnh. Hết lượt thì mọi request của key bị từ chối cho tới khi bạn nạp thêm.
https://framewharf.com/api/v1/grok-quota/usageTrả về số video, số ảnh, lượt đã dùng và tiền đã tiêu của từng key và cả team, theo từng giờ hoặc từng ngày giờ Việt Nam — số để bạn đối soát và thu tiền khách của mình. Mọi tham số đều tuỳ chọn:
curl "https://framewharf.com/api/v1/grok-quota/usage?bucket=hour&start=2026-10-29T00:00:00%2B07:00&end=2026-10-30T00:00:00%2B07:00" \
-H "Authorization: Bearer fwquota_..."{
"bucket": "hour",
"start": "2026-10-28T17:00:00.000Z",
"end": "2026-10-29T17:00:00.000Z",
"totals": { "videos": 12, "images": 1, "failed": 1, "units_used": 12.25, "spend_vnd": 6174, "refunded_vnd": 504 },
"slots": [
{ "slot": "2026-10-29 09", "videos": 8, "images": 0, "failed": 1, "units_used": 8, "spend_vnd": 4032, "refunded_vnd": 504 },
{ "slot": "2026-10-29 10", "videos": 4, "images": 1, "failed": 0, "units_used": 4.25, "spend_vnd": 2142, "refunded_vnd": 0 }
],
"keys": [
{
"id": "cm...",
"name": "Khách A",
"deleted_at": null,
"totals": { "videos": 12, "images": 1, "failed": 1, "units_used": 12.25, "spend_vnd": 6174, "refunded_vnd": 504 },
"slots": [
{ "slot": "2026-10-29 09", "videos": 8, "images": 0, "failed": 1, "units_used": 8, "spend_vnd": 4032, "refunded_vnd": 504 },
{ "slot": "2026-10-29 10", "videos": 4, "images": 1, "failed": 0, "units_used": 4.25, "spend_vnd": 2142, "refunded_vnd": 0 }
]
}
]
}slot là YYYY-MM-DD theo ngày hoặc YYYY-MM-DD HH theo giờ, giờ Việt Nam; ô không có gì bị bỏ. spend_vnd là tiền đã tiêu, đã trừ tiền hoàn của job lỗi; refunded_vnd là phần hoàn đó; failed là số job lỗi đã được hoàn lượt; units_used là spend_vnd chia giá một lượt, có thể lẻ một phần tư khi có ảnh. Số liệu chi tiết giữ 8 ngày gần nhất, nên hãy đọc định kỳ và lưu phía bạn; tổng trọn đời của mỗi key là quota trừ units_left ở mục Xem budget và key. Key đã xoá vẫn có trong báo cáo, với deleted_at là lúc xoá.
https://framewharf.com/api/v1/grok-quota/transactionsTrả về các dòng của budget, mới nhất trước: mỗi lần cấp thêm, tạo key, nạp thêm lượt hay hoàn tiền khi xoá là một dòng, kèm số dư ngay sau dòng đó.
curl "https://framewharf.com/api/v1/grok-quota/transactions?limit=50" \
-H "Authorization: Bearer fwquota_..."{
"transactions": [
{
"id": "cm...",
"type": "key_update",
"source": "api",
"amount_vnd": -1008000,
"balance_after_vnd": 21672000,
"key_id": "cm...",
"key_name": "Khách A",
"description": "Nạp thêm 2.000 lượt cho key Khách A",
"created_at": "2026-10-29T10:00:00.000Z"
},
{
"id": "cm...",
"type": "key_create",
"source": "api",
"amount_vnd": -2520000,
"balance_after_vnd": 22680000,
"key_id": "cm...",
"key_name": "Khách A",
"description": "Tạo key Khách A: 5.000 lượt",
"created_at": "2026-10-29T08:00:00.000Z"
}
],
"next_cursor": null
}amount_vnd dương là cộng vào số dư, âm là trừ. source là admin khi Framewharf thực hiện, console hoặc api khi bạn thực hiện. Các loại dòng:
https://framewharf.com/api/v1/grok-quota/capacityMỗi key lượt chạy được key_concurrent job cùng lúc và chiếm đúng ngần ấy request song song trong số còn bán được lúc này. Endpoint này cho biết còn tạo được bao nhiêu key mới; hết suất thì tạo key nhận 409. Nạp thêm lượt cho key đã có không cần suất.
curl "https://framewharf.com/api/v1/grok-quota/capacity" \
-H "Authorization: Bearer fwquota_..."{
"open": true,
"available": 1500,
"key_concurrent": 10,
"available_keys": 150
}available là số request song song còn bán được, available_keys là số key mới còn tạo được (available chia key_concurrent, làm tròn xuống), open là false khi không tạo thêm được key nào. Số đọc được cập nhật mỗi 15 giây, còn lần tạo key luôn kiểm lại đúng lúc đó. Số lượt còn bán là một giới hạn riêng: chạm nó thì tạo key và nạp lượt cũng nhận 409.
Mọi lỗi có dạng { "error": { "message": string } }.