Gói GrokTeam Grok vô hạn
Dành cho tài khoản có team Grok: tạo key ảnh và video Grok không giới hạn cho từng thành viên, mỗi key một số request song song và một hạn dùng, ngay từ hệ thống của bạn.
Framewharf cấp cho tài khoản có team Grok một key quản lý bắt đầu bằng fwteam_. 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ố luồng còn bán được; key thành viên nhận được mới là key gọi mô hình, bắt đầu bằng sk-.
Budget của team là ví trả trước. Tạo key trừ ngay giá của nó theo số request song song và số ngày: key 1 ngày bằng một phần bảy key 7 ngày cùng số luồng. Sửa key thì chỉ phần chênh lệch được trừ thêm hoặc hoàn, xoá key còn hạn thì phần thời gian còn lại được hoàn, còn key hết hạn là đã dùng hết. Số dư còn lại quyết định key lớn nhất tạo được.
Tiền trừ thêm và tiền hoàn đều tính theo đúng số giây còn lại của key, nên key chỉ tốn đúng số giờ, số ngày đã chạy. Mọi khoản làm tròn tới đồng: tiền trừ làm tròn lên, tiền hoàn làm tròn xuống. Mỗi lần budget thay đổi là một dòng trong lịch sử budget, nên số dư luôn đối soát được tới từng đồng.
Tạo một key mới. Cả ba trường đều bắt buộc:
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. price_vnd là số tiền vừa trừ khỏi budget, free_vnd là số dư còn lại.
Trả 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.
active là false khi key đã hết hạn; key hết hạn vẫn nằm trong danh sách cho tới khi bạn xoá nó. refund_vnd là số tiền được hoàn nếu xoá key ngay lúc đọc.
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, trường bỏ trống giữ nguyên giá trị:
Đổi concurrent mà không gửi days thì hạn giữ nguyên: tăng thì trừ thêm số luồng thêm cho thời gian còn lại, giảm thì hoàn số luồng bỏ đi cho thời gian còn lại. Gửi days là bắt đầu một kỳ mới: trừ giá đủ kỳ mới sau khi trừ đi phần còn lại của kỳ cũ (kỳ mới rẻ hơn thì phần chênh được hoàn) — gia hạn, rút ngắn hay mở lại key đều theo cách này. Ví dụ dưới đây nâng key 5 luồng còn 6 ngày lên 8 luồng cho một tuần mới.
Mọi khoản tính theo giá hiện tại, kể cả với key tạo trước một lần đổi giá. charged_vnd và refunded_vnd là số tiền thay đổi này trừ thêm hoặc hoàn, free_vnd là số dư sau đó. Thay đổi phải trừ thêm cần đủ số dư; thay đổi được hoàn và việc đổi tên thì luôn được.
Xoá key của một thành viên. Key ngừng hoạt động ngay, thời gian còn lại của nó được hoàn vào budget (key đã hết hạn thì không hoàn), và phản hồi là 204.
Trả 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, sửa key hay hoàn tiền khi xoá là một dòng, kèm số dư ngay sau dòng đó.
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, và system cho các dòng mở sổ lúc budget chuyển sang ví. Các loại dòng:
Số request song song còn bán được lúc này, chung cho mọi key đang chạy. Tạo key, tăng concurrent hay gửi days cho key đã hết hạn cần còn đủ số luồng thêm vào; hết suất thì yêu cầu nhận 409.
available là số request song song còn thêm được; open là false khi không còn suất nào. Số đọc được cập nhật mỗi 15 giây, còn lần tạo hay sửa key luôn kiểm lại đúng lúc đó, nên một yêu cầu vừa lọt available vẫn có thể nhận 409 nếu suất vừa được dùng hết. Giảm luồng, rút ngắn và xoá key thì luôn được.
Mọi lỗi có dạng { "error": { "message": string } }.
https://framewharf.com/api/v1/grok-team/keysAuthorization: Bearer fwteam_...https://framewharf.com/api/v1/grok-team/keyshttps://framewharf.com/api/v1/grok-team/keys/{id}https://framewharf.com/api/v1/grok-team/keys/{id}https://framewharf.com/api/v1/grok-team/transactionshttps://framewharf.com/api/v1/grok-team/capacitycurl "https://framewharf.com/api/v1/grok-team/keys" \
-H "Authorization: Bearer fwteam_..." \
-H "Content-Type: application/json" \
-d '{
"name": "Khách A",
"concurrent": 5,
"days": 7
}'{
"id": "cm...",
"name": "Khách A",
"key": "sk-...",
"concurrent": 5,
"days": 7,
"expires_at": "2026-10-21T08:00:00.000Z",
"price_vnd": 2205000,
"free_vnd": 41895000
}curl "https://framewharf.com/api/v1/grok-team/keys" \
-H "Authorization: Bearer fwteam_..."{
"budget_vnd": 44100000,
"allocated_vnd": 2205000,
"free_vnd": 41895000,
"keys": [
{
"id": "cm...",
"name": "Khách A",
"concurrent": 5,
"days": 7,
"key_hint": "sk-...abcd",
"active": true,
"refund_vnd": 1890000,
"created_at": "2026-10-14T08:00:00.000Z",
"expires_at": "2026-10-21T08:00:00.000Z",
"last_used_at": null
}
]
}curl -X PATCH "https://framewharf.com/api/v1/grok-team/keys/cm..." \
-H "Authorization: Bearer fwteam_..." \
-H "Content-Type: application/json" \
-d '{ "concurrent": 8, "days": 7 }'{
"id": "cm...",
"name": "Khách A",
"concurrent": 8,
"active": true,
"expires_at": "2026-10-22T08:00:00.000Z",
"charged_vnd": 1638000,
"refunded_vnd": 0,
"free_vnd": 40257000
}curl -X DELETE "https://framewharf.com/api/v1/grok-team/keys/cm..." \
-H "Authorization: Bearer fwteam_..."curl "https://framewharf.com/api/v1/grok-team/transactions?limit=50" \
-H "Authorization: Bearer fwteam_..."{
"transactions": [
{
"id": "cm...",
"type": "key_update",
"source": "api",
"amount_vnd": -1638000,
"balance_after_vnd": 40257000,
"key_id": "cm...",
"key_name": "Khách A",
"description": "Sửa key Khách A: 5 → 8 luồng, hạn mới 7 ngày từ lúc sửa",
"created_at": "2026-10-15T08:00:00.000Z"
},
{
"id": "cm...",
"type": "key_create",
"source": "api",
"amount_vnd": -2205000,
"balance_after_vnd": 41895000,
"key_id": "cm...",
"key_name": "Khách A",
"description": "Tạo key Khách A: 5 luồng × 7 ngày",
"created_at": "2026-10-14T08:00:00.000Z"
},
{
"id": "cm...",
"type": "grant",
"source": "admin",
"amount_vnd": 44100000,
"balance_after_vnd": 44100000,
"key_id": null,
"key_name": null,
"description": "Cấp team Grok",
"created_at": "2026-10-13T08:00:00.000Z"
}
],
"next_cursor": null
}curl "https://framewharf.com/api/v1/grok-team/capacity" \
-H "Authorization: Bearer fwteam_..."{
"open": true,
"available": 120
}