Personal API key
แต่ละบัญชีมี API key ที่ใช้งานได้สูงสุดหนึ่งตัว เข้าสู่ระบบที่ editor แล้วเปิดหน้าบัญชีเพื่อสร้าง key, คัดลอก, สร้างใหม่แทนที่เดิม หรือยกเลิก key
key เต็มจะแสดงครั้งเดียวเมื่อสร้าง ระบบเก็บเฉพาะ SHA-256 hash จึงเรียกดู key เดิมซ้ำไม่ได้ หากลืมให้สร้างใหม่ ซึ่งทำให้ key เดิมใช้ไม่ได้ทันที key ไม่มีวันหมดอายุ แต่ใช้ไม่ได้ขณะบัญชีถูกปิดใช้งาน หากเปิดบัญชีอีกครั้ง key เดิมกลับมาใช้ได้เว้นแต่ถูกยกเลิกไปแล้ว
export LOMA_API_SECRET_KEY="loma_<your-personal-key>"
# หลังเผยแพร่แพ็กเกจ lomasub บน npm:
npx lomasub transcribe ./video.mp4 --language th
personal key ใช้กับ client routes เดียวกับ editor เช่น /presigned-url, /new-transcribe, /status, /jobs*, /short-topics, /account/me และใช้โควตาบัญชีเดียวกัน งานจาก CLI/SDK ปรากฏในประวัติงานของเจ้าของ key เข้าถึงงานของคนอื่นไม่ได้ และใช้กับ worker/admin routes ไม่ได้
shared deployment secret ของ worker และสคริปต์ภายในเป็นคนละ credential มีสิทธิ์ทุกงานและไม่คิดโควตา ไม่ใช่ key สำหรับแจกให้ผู้ใช้
API สำหรับจัดการ key — session เท่านั้น
ทั้งสาม route ต้องใช้ session cookie จาก Google login (credentials: 'include') personal key และ shared secret เพียงอย่างเดียวใช้จัดการ key ไม่ได้ POST/DELETE ต้องมี Origin ใน LOMA_CORS_ALLOW_ORIGINS ทุก response ที่สำเร็จมี Cache-Control: no-store
| Method / path | Response |
|---|---|
GET /account/api-key |
{"exists": false, "created_at": null} หรือ exists: true พร้อมเวลา ISO 8601 |
POST /account/api-key |
สร้างหรือแทนที่: {"api_key": "loma_...", "created_at": "..."}; ต้องเปิดใช้งานบัญชีแล้ว |
DELETE /account/api-key |
ยกเลิก: {"ok": true}; เรียกซ้ำได้ |
สร้างใหม่หรือยกเลิก key ไม่ยกเลิกงานที่ส่งแล้ว และไม่ออกจากระบบ browser ดาวน์โหลดผลเดิมด้วย key ใหม่หรือ session ของเจ้าของงานได้
ตอบ 401 เมื่อไม่มี session และ 403 เมื่อ Origin ไม่ถูกต้อง หรือสร้าง key ขณะบัญชีไม่เปิดใช้งาน