ข้อมูลผู้เรียก — GET /account/me
ตรวจสอบเจ้าของ credential และยอดโควตา ใช้ personal API key หรือ session cookie จาก editor ไม่มีพารามิเตอร์
curl https://api.lomasub.ai/account/me \
-H "Authorization: Bearer $LOMA_API_SECRET_KEY"
Response — 200 OK
{
"via": "api_key",
"id": 42,
"email": "somchai@gmail.com",
"name": "Somchai J.",
"picture": "https://lh3.googleusercontent.com/a/example",
"activated": true,
"quota": 52.92,
"monthly_quota": 52.92,
"credit_quota": 0,
"reserved": 0,
"tier": "free",
"package": "free",
"package_name": "ฟรี",
"monthly_allowance": 54,
"next_reset_at": "2026-10-22T17:00:00Z",
"last_reset_at": null,
"ever_paid": false,
"subscription": null,
"limits": {"max_unfinished_jobs": 2, "max_audio_duration_seconds": 1800, "max_source_bytes": 100000000},
"allow_training_data": true,
"invite": {"used": 1, "limit": 3, "reward": 100},
"admin": false
}
| ฟิลด์ | ความหมาย |
|---|---|
via |
api_key สำหรับ personal key, session สำหรับ browser, secret สำหรับ shared secret ภายใน |
id, email, name, picture |
ข้อมูลเจ้าของบัญชี |
activated |
บัญชีเปิดใช้งานแล้วหรือไม่ |
quota |
โควตาที่ใช้ได้ทั้งหมด = monthly_quota + credit_quota (ทศนิยม 3 ตำแหน่ง) ร่วมกันระหว่าง CLI, SDK และ editor |
monthly_quota |
โควตารายเดือนที่เหลือ ใช้ก่อนเสมอ รีเซ็ตเป็น monthly_allowance ทุกเดือน (ไม่สะสม) |
credit_quota |
เครดิตที่ซื้อหรือได้รับ ใช้เมื่อโควตารายเดือนหมด ติดลบได้ถ้างานสุดท้ายใหญ่กว่ายอด |
reserved |
โควตาที่งานซึ่งยังไม่เสร็จจองไว้ |
tier, package |
แพ็กเกจ free (54/เดือน), creator (324/เดือน), studio (1,296/เดือน) |
next_reset_at |
เวลา 00:00 ในวันครบรอบสมัครบัญชีครั้งถัดไป ตามเวลาไทย; วันที่ 29–31 ใช้วันสุดท้ายของเดือนที่สั้นกว่า |
ever_paid |
เคยชำระเงินผ่าน Stripe แล้วหรือไม่ (สมัครแพ็กเกจหรือซื้อเครดิต) |
subscription |
null ถ้าไม่เคยสมัครแพ็กเกจรายเดือน มิฉะนั้น {"status", "package", "current_period_end", "cancel_at_period_end", "active"} ดูการชำระเงิน |
limits |
ขีดจำกัดงานที่ยังไม่เสร็จ, เวลาเสียง (วินาที), และไฟล์เสียง (bytes) ของแพ็กเกจปัจจุบัน |
allow_training_data |
ผู้ใช้อนุญาตให้ใช้ข้อมูลเพื่อพัฒนาโมเดล Speech to text หรือไม่ ค่าเริ่มต้น true ทุกบัญชี เปลี่ยนได้ในหน้าบัญชีของ editor |
invite |
ความคืบหน้าการชวนเพื่อน: used บัญชีใหม่ที่สมัครผ่านลิงก์ของผู้ใช้ (แสดงแค่จำนวน ไม่บอกว่าเป็นใคร), limit จำนวนสูงสุดที่ได้โบนัส, reward เครดิตที่ได้ต่อคน ดูหัวข้อชวนเพื่อนด้านล่าง |
admin |
เป็น true เฉพาะ session ของผู้ดูแลระบบ; personal key ไม่ให้สิทธิ์ admin |
ค่าใช้จ่าย: การถอดเสียง 0.015 โควตาต่อวินาที (อย่างน้อย 0.9 ต่องาน), promodel: "pro" หรือการแปล 0.035 (อย่างน้อย 2.1), หัวข้อสั้น 6 โควตาต่อครั้ง ดูรายการเดินบัญชีได้ที่ GET /account/usage?page=1 รายการเก่ายังแสดง weekly_delta; รายการใหม่แสดง monthly_delta
Response ไม่แสดง key หรือ hash ใช้หน้าบัญชีใน editor เพื่อสร้างหรือยกเลิก key
shared deployment secret สำหรับสคริปต์/worker ภายในยังตอบ via: "secret", id, email, name, picture, quota เป็น null, activated: true, admin: false เพราะไม่ใช่ credential ของผู้ใช้ ห้ามแจก secret นี้ให้ลูกค้า
การตั้งค่าบัญชี — POST /account/settings (session เท่านั้น)
เปิดหรือปิดการอนุญาตให้ใช้ข้อมูลเพื่อพัฒนาโมเดล ต้องใช้ session cookie จาก Google login (credentials: 'include') และ Origin ใน LOMA_CORS_ALLOW_ORIGINS personal key และ shared secret ใช้ไม่ได้ บัญชีที่ยังไม่เปิดใช้งานหรือยังไม่ยอมรับข้อกำหนดก็เปลี่ยนค่านี้ได้
{"allow_training_data": false}
ตอบ 200 พร้อม {"allow_training_data": false} และ Cache-Control: no-store; 401 เมื่อไม่มี session, 403 เมื่อ Origin ไม่ถูกต้อง, 422 เมื่อค่าไม่ใช่ boolean
ชวนเพื่อน — GET /account/invite
ลิงก์ชวนเพื่อนส่วนตัวของผู้ใช้ (สร้างรหัสครั้งแรกที่เรียก แล้วใช้รหัสเดิมตลอด) ใช้ได้ทั้ง session และ personal key; shared secret ตอบ 401
{"code": "K7Q2MXA9", "url": "https://app.lomasub.ai/?invite=K7Q2MXA9", "used": 1, "limit": 3, "reward": 100, "available": true}
เมื่อบัญชี Google ที่ยังไม่เคยเข้าสู่ระบบ Loma Sub เข้าสู่ระบบครั้งแรกผ่านลิงก์นี้ ทั้งผู้ชวนและเพื่อนได้เครดิต reward คนละครั้ง (เครดิตไม่หมดอายุ ใช้หลังโควตารายเดือน รายการเดินบัญชีชนิด referral_bonus) ผู้ชวนได้โบนัสจากบัญชีใหม่ limit บัญชีแรกเท่านั้น (available: false เมื่อครบ) บัญชีที่มีอยู่แล้วหรือลิงก์ของตัวเองไม่ได้โบนัส
GET /invites/{code} (ไม่ต้องใช้ credential) ใช้แสดงผู้ชวนในหน้าเข้าสู่ระบบ: {"code", "inviter": {"first_name", "picture"}, "available", "reward"}; รหัสที่ไม่มีอยู่ตอบ 404
ข้อผิดพลาด
| สถานะ | สาเหตุ |
|---|---|
401 |
ไม่มี credential หรือ bearer key ผิด/ถูกยกเลิก; bearer ที่ผิดไม่ fallback ไปใช้ session |
403 |
personal key ของบัญชีที่ไม่เปิดใช้งานหรือถูกปิดใช้งาน |