แผนที่ endpoint

ตารางเปรียบเทียบสำหรับงานทั่วไป

การ integrate สาธารณะ (แนะนำ): เรียก Gommo โดยตรง — ดู Gommo public API
ทางเลือก dev: แทน {gateway} ด้วย base URL ของ Gommo Developer (เช่น http://localhost:3001)

Media & jobs

งาน	Mode A (Direct)	Mode B (REST)	Mode C (Proxy)
รายการโมเดล	`POST https://v2.api.gommo.net/ai/models?type={type}`	`GET {gateway}/gateway/models?type={type}`	`POST {gateway}/v2/ai/models?type={type}`
สร้าง job	`POST https://v2.api.gommo.net/ai/jobs/{type}/{slug}`	`POST {gateway}/gateway/jobs/{type}`	`POST {gateway}/v2/ai/jobs/{type}/{slug}`
Poll job	`POST https://v2.api.gommo.net/ai/jobs/{id}?media={media}`	`GET {gateway}/gateway/jobs/{id}?media={media}`	`POST {gateway}/v2/ai/jobs/{id}?media={media}`

ประเภท job: image, video, tts, music, avatar-lipsync, image-upscale, remove-bg, video-upscale, video-vfx, video-subtitle, video-cut

Poll media: image | video | music

Body สร้าง job Mode B (JSON):

json

{
  "modelSlug": "flux-dev",
  "wait": false,
  "fields": { "prompt": "…", "ratio": "16:9" }
}

Body สร้าง job Mode A/C (form): domain, project_id, prompt, ratio, …

Upload

งาน	Mode A	Mode B	Mode C
อัปโหลดภาพ	`POST v2…/ai/upload/image`	`POST {gateway}/gateway/upload/image`	`POST {gateway}/v2/ai/upload/image`
อัปโหลดวิดีโอ	`POST v2…/ai/upload/video`	`POST {gateway}/gateway/upload/video`	`POST {gateway}/v2/ai/upload/video`

Chat

งาน	Mode A	Mode B	Mode C
Chat (JSON)	`POST api…/api/v2/chat`	`POST {gateway}/gateway/chat`	`POST {gateway}/api/v2/chat`
Chat (stream)	เหมือนกัน + SSE	เหมือนกัน — gateway pipe stream	เหมือนกัน — proxy pipe stream
Chat models	`POST api…/api/v2/chat` `action=models`	`GET {gateway}/gateway/chat-models`	`POST api…/api/v2/chat`
Chat sessions	`POST api…/api/v2/ai-chat-sessions`	`POST {gateway}/gateway/chat-sessions`	`POST api…/api/v2/ai-chat-sessions`
OpenAI shim	—	`POST {gateway}/v1/chat/completions`	—

Stream ทำงานเมื่อ URL มี /chat หรือ Content-Type: text/event-stream

OpenAI shim รับ messages[] มาตรฐาน + stream: true (optional) รูปแบบ model: model::server (เช่น gpt-5.5::cheap) หรือ default server จาก env

→ OpenAI-compatible chat

Audio

งาน	Mode A	Mode B	Mode C
Voices	`POST api…/ai/audio`	`POST {gateway}/gateway/audio/voices`	`POST {gateway}/ai/audio`
TTS	`POST api…/ai/audio`	`POST {gateway}/gateway/audio/tts`	`POST {gateway}/ai/audio`
Lists	`GET api…/…`	`GET {gateway}/gateway/audio/lists`	ผ่าน platform paths

Library (รายการและอัลบั้ม)

งาน	Mode A	Mode B	Mode C
อัลบั้มภาพ	`POST v2…/ai/library/album-images`	`POST {gateway}/gateway/library/album-images`	`POST {gateway}/v2/ai/library/album-images`
อัลบั้มวิดีโอ	`POST v2…/ai/library/album-videos`	`POST {gateway}/gateway/library/album-videos`	`POST {gateway}/v2/ai/library/album-videos`
รายการ music / audio / image / video	`POST v2…/ai/library/{musics\|audios\|images\|videos}`	`POST {gateway}/gateway/library/{resource}`	`POST {gateway}/v2/ai/library/{resource}`

Body Mode B (JSON): projectId, limit, order_by, sort_by, และ device_id / device_name / device_info (optional) — gateway เติม domain และ access_token จาก Bearer

Explore ชุมชน

งาน	Mode A	Mode B	Mode C
วิดีโอสาธารณะ	`POST api…/api/apps/go-mmo/ai/public-videos`	`POST {gateway}/gateway/explore/public-videos`	`POST {gateway}/api/apps/go-mmo/ai/public-videos`
รูปสาธารณะ	`POST api…/api/apps/go-mmo/ai/images`	`POST {gateway}/gateway/explore/images`	`POST {gateway}/api/apps/go-mmo/ai/images`

Mode B (JSON): วิดีโอ — type, publicPrompt, language, model (optional); รูป — projectId, afterId, feedType (upstream feed_type), search, category, model, type, language (optional) — Bearer ไม่บังคับเมื่อ browse สาธารณะ

ฟีดข่าว home (newfeeds)

งาน	Mode A	Mode B	Mode C
Newfeeds	`POST api…/ai/newfeeds`	`POST {gateway}/gateway/newfeeds`	`POST {gateway}/ai/newfeeds`

Mode B JSON: preset (public_timeline | my_feed, alias public / mine), limit, projectId, afterVideoId, afterImageId, language, privacy (optional) — Bearer จำเป็น

Auth (ผ่าน platform host เสมอ)

งาน	Mode A	Mode B/C
Login	`POST api…/api/apps/go-mmo/auth/login`	`POST {gateway}/api/apps/go-mmo/auth/login` หรือ `POST {gateway}/gateway/auth/login` (JSON)
สมัคร	Merchant `POST …/auth/register` (server only)	`POST {gateway}/gateway/auth/register` (JSON; merchant env บนเซิร์ฟเวอร์)
เปลี่ยนรหัสผ่าน	`POST api…/api/apps/go-mmo/auth/change-password`	`POST {gateway}/gateway/auth/change-password` only (JSON + Bearer)
โอน credit	`POST api…/users/sendBalances`	`POST {gateway}/gateway/credits/transfer` only (JSON + Bearer)
ประวัติธุรกรรม	`POST api…/users/paymentsHistory`	`POST {gateway}/gateway/credits/transactions` only (JSON + Bearer)
อุปกรณ์เซสชัน	`POST api…/api/v2/devices`	`POST {gateway}/gateway/devices` only (JSON + Bearer)
ตั๋วซัพพอร์ต	`POST api…/support/*`	`POST {gateway}/gateway/support/tickets` (+ `/create`, `/detail`, `/reply`)
โปรแกรมพาร์ทเนอร์	`POST api…/users/partner_program`	`POST {gateway}/gateway/partner-program`
Creator Rewards	`POST api…/users/creator_rewards`	`POST {gateway}/gateway/creator-rewards`
Profile	`POST api…/api/apps/go-mmo/ai/me`	`POST {gateway}/ai/me` หรือ proxy `POST {gateway}/api/apps/go-mmo/ai/me`

Mode A: เรียก api.gommo.net โดยตรง (login, เปลี่ยนรหัส, โอน credit, ledger, devices, support, partner, creator rewards, /ai/me) Mode B self-host: JSON typed login/register/change-password/transfer, /gateway/credits/transactions, /gateway/devices, /gateway/support/tickets, /gateway/partner-program, /gateway/creator-rewards ดู สมัครสมาชิก · เปลี่ยนรหัส · โอน credit · ประวัติธุรกรรม · อุปกรณ์เซสชัน · ตั๋วซัพพอร์ต · โปรแกรมพาร์ทเนอร์ · Creator Rewards

ฟิลด์ domain

โหมด	ใครส่ง `domain`
A Direct	Client ในทุก form body
B REST	ไม่บังคับ — gateway ใช้ `GOMMO_API_DOMAIN`
C Proxy	Client ใน form (upstream บังคับ)

ค่าเริ่มต้น polling (Mode B `wait: true`)

การตั้งค่า	ค่า
Interval	3500 ms
จำนวนครั้งสูงสุด	80 (~4.7 นาที)
Webhook	ไม่มี — Gommo ไม่ push เมื่อเสร็จ

Home app shell

งาน	Mode A	Mode B	Mode C
List projects (legacy)	`POST api…/ai/projects`	`POST {gateway}/gateway/projects`	`POST {gateway}/ai/projects`
AI projects V2	`POST api…/api/v2/ai-projects` … `set_password`, `get` + `password`, `invite`, `member_kick`, `stats`, `activity_list`, …	`POST {gateway}/gateway/ai-projects` JSON `{ action, id_base?, password?, … }`	`POST {gateway}/api/v2/ai-projects`
Project media	files-manager `list`; `/ai/audio` `get.list`; `ai_musics/getAll`	`/gateway/files-manager`, `/gateway/project-media/audio`, `/gateway/project-media/music`	`POST {gateway}/api/v2/files-manager`
Credit pools	`POST api…/api/v2/credit-pools` — `list`, `ledger`, `create`, `deposit`, `delete`, `set_share_credit`; `scope_type`, `scope_id`, `pool_id`	`POST {gateway}/gateway/credit-pools` JSON	`POST {gateway}/api/v2/credit-pools`
Notifications	`POST api…/ai/notifications`	`POST {gateway}/gateway/notifications`	`POST {gateway}/ai/notifications`
News & updates	`POST api…/api/apps/go-mmo/news/getAll`	`POST {gateway}/gateway/news`	`POST {gateway}/api/apps/go-mmo/news/getAll`
Changelogs (recent updates)	`POST api…/api/apps/go-mmo/app/changelogs`	`POST {gateway}/gateway/changelogs`	`POST {gateway}/api/apps/go-mmo/app/changelogs`
Devices	`POST api…/api/v2/devices`	`POST {gateway}/gateway/devices`	`POST {gateway}/api/v2/devices`
Support	`POST api…/support/myTickets` (+ create/detail/reply)	`POST {gateway}/gateway/support/tickets` (+ subpaths)	`POST {gateway}/api/apps/go-mmo/support/*`
โปรแกรมพาร์ทเนอร์	`POST api…/users/partner_program`	`POST {gateway}/gateway/partner-program`	`POST {gateway}/api/apps/go-mmo/users/partner_program`
Creator Rewards	`POST api…/users/creator_rewards`	`POST {gateway}/gateway/creator-rewards`	`POST {gateway}/api/apps/go-mmo/users/creator_rewards`

Mode B JSON (devices): action register | list | rename | disable; ไม่บังคับ current_device_id, language, device_id / device_name / device_info — Bearer จำเป็น — rename/disable ใช้ device_id (UUID) ดู อุปกรณ์เซสชัน. Support: ticket_id_base (SUP-…) — ตั๋วซัพพอร์ต. Partner: action_type status | apply — โปรแกรมพาร์ทเนอร์. Creator Rewards: action_type status | pool | apply — Creator Rewards. Notifications: ไม่บังคับ limit, page ที่ /gateway/notifications

รายละเอียด media (info)

งาน	Mode A	Mode B	Mode C
Image info	`POST api…/ai/info/image/{id}`	`POST {gateway}/gateway/info/image/{id}`	`POST {gateway}/ai/info/image/{id}`
Video info	`POST api…/ai/info/video/{id}`	`POST {gateway}/gateway/info/video/{id}`	`POST {gateway}/ai/info/video/{id}`
Music info	`POST api…/ai/info/music/{id}`	`POST {gateway}/gateway/info/music/{id}`	`POST {gateway}/ai/info/music/{id}`

Mode B JSON (optional): projectId — path {id} คือ job id / id_base — Bearer จำเป็น

เอกสาร API ละเอียด

→ Media & jobs · Upload · Chat · AI projects

ขั้นตอนถัดไป

→ Integration modes · Choosing a mode

แผนที่ endpoint ​

Media & jobs ​

Upload ​

Chat ​

Audio ​

Library (รายการและอัลบั้ม) ​

Explore ชุมชน ​

ฟีดข่าว home (newfeeds) ​

Auth (ผ่าน platform host เสมอ) ​

ฟิลด์ domain ​

ค่าเริ่มต้น polling (Mode B wait: true) ​

Home app shell ​

รายละเอียด media (info) ​

เอกสาร API ละเอียด ​

ขั้นตอนถัดไป ​