หลักการ

หลักการหลักเมื่อสร้างบน Gommo — อ่าน คู่มือ integrator (Tier A) แล้ว เริ่มต้นใช้งาน หรือ โมเดล

ลำดับคำขอ

แอปของคุณ
  │
  ├─ v2.api.gommo.net  ──► models · create/poll jobs · upload image/video
  │
  └─ api.gommo.net     ──► login · /ai/me · chat · audio · job info

ทางเลือก: self-host Gommo Developer สำหรับ portal billing และ BYOK preview — ไม่จำเป็นสำหรับการเชื่อมต่อ Gommo โดยตรง

สอง upstream host

Host	ใช้สำหรับ
https://v2.api.gommo.net	Models, create/poll media jobs, upload
https://api.gommo.net	Login, profile/credits, chat, platform audio

Auth: Authorization: Bearer <access_token> ผ่าน HTTPS form platform และ V2 ต้องมี domain (โดเมนลงทะเบียนบัญชีเดียวกัน)

หลักการออกแบบ

1. เรียก URL public ของ Gommo

ผู้ integrate เรียก upstream host โดยตรง แผนที่ฉบับเต็ม → Gommo public API

การดำเนินการ	URL
ลิสต์โมเดล	POST https://v2.api.gommo.net/ai/models?type={type}
สร้างงาน	POST https://v2.api.gommo.net/ai/jobs/{type}/{model_id}
Poll งาน	POST https://v2.api.gommo.net/ai/jobs/{id}?media={media}
Login	POST https://api.gommo.net/api/apps/go-mmo/auth/login
Me / credits	POST https://api.gommo.net/ai/me

2. ห้ามเดาพารามิเตอร์โมเดล

ratio, mode, resolution, และ duration ต้อง มาจากแคตตาล็อกโมเดล:

POST https://v2.api.gommo.net/ai/models?type=image
Authorization: Bearer {access_token}
Content-Type: application/x-www-form-urlencoded

type=image&domain=%REGISTRATION_DOMAIN%

การเดาค่าทำให้ upstream ปฏิเสธหรือคุณภาพผิดพลาด ดู โมเดล

3. งาน async, poll ชัดเจน

งานมีเดีย Gommo ไม่ push webhook ไปแอปโดยค่าเริ่มต้น client ต้อง poll:

• ช่วง 3500 ms
• สูงสุด 80 ครั้ง (~5 นาที)
• POST …/ai/jobs/{id}?media=… จนสถานะสุดท้าย

Poll ฝั่ง client ทุก 3.5s สูงสุด 80 ครั้ง — Gommo ไม่ webhook เมื่องานเสร็จ

4. Domain ในทุก form body

ส่ง domain ให้ตรงกับ โดเมนลงทะเบียน ของ user (dealer) โดเมนผิด → auth/credit/billing ผิดพลาด ดู การยืนยันตัวตน

Portal multi-dealer อาจล็อก domain ต่อ dealer — ดู Upstream hosts

5. User vs merchant credentials

Credential	ที่อยู่	ใช้สำหรับ
User access_token	Client Bearer / form	ทุก user API call
GOMMO_ACCESS_TOKEN	Server env เท่านั้น	Merchant ops, catalog translate warm
ADMIN_API_KEY	Server env เท่านั้น	Self-hosted /th/admin/*

ห้ามเปิดเผย merchant หรือ admin secret ให้เบราว์เซอร์หรือแอปมือถือ

6. Billing บน platform auth host

เติมเครดิตใช้ Gommo create_payment + payment_sync บน api.gommo.net site docs อาจ wrap billing ใต้ /th/billing/* เมื่อ self-host — ดู Billing & เครดิต

7. ข้อผิดพลาด upstream

Gommo คืน JSON พร้อม message, success, error ตรวจ HTTP status และ body — ไม่ retry credential เดิมเมื่อ auth ล้มเหลว

สิ่งที่เรา optimize

• ความเร็ว integrator — เริ่มต้นใช้งาน ในไม่กี่นาที Playground พร้อม URL public
• ความตรงกับแคตตาล็อก — ไม่สร้าง enum เอง ลิสต์โมเดลก่อน
• host ชัดเจน — v2 สำหรับมีเดีย api สำหรับ auth/chat/audio

เมื่อไหร่ควรพูดถึง /gateway/* ใน docs

ค่าเริ่มต้น: integrator เรียก Gommo public hosts (Mode A) อย่า lead ด้วย /gateway/* ใน Tier A (models, jobs, chat, upload, auth, cookbook)

Gateway อยู่ใน docs เมื่อ: ตารางเปรียบเทียบ Mode B/C, ส่วน self-host ทางเลือก, ฟีเจอร์ portal-only (BYOK, observability, usage, billing), deploy/MCP self-hosted runtime portal อาจ proxy /gateway/* บน :5173 — เป็น dev infrastructure ไม่ใช่ public contract

หน้า gateway-only: ใส่ tip Coming to Gommo platform หลัง H1 และลิงก์ Roadmap แพลตฟอร์ม Gommo เป็น preview สิ่งที่ Gommo จะ ship — ไม่ใช่ผลิตภัณฑ์ preview-only ถาวรของ Gommo Developer

ถัดไป

→ Roadmap แพลตฟอร์ม Gommo · โมเดล · เริ่มต้นใช้งาน · MCP & agents