ข้อมูลผู้เรียก — 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 ของบัญชีที่ไม่เปิดใช้งานหรือถูกปิดใช้งาน

results matching ""

    No results matching ""