OpenAPI

ดาวน์โหลดหรือเรียกดูสเปก OpenAPI 3.0 สำหรับ Gommo public API (v2.api.gommo.net + api.gommo.net) ไฟล์เดียวกันยังรวม endpoint dev ของ Gommo Developer สำหรับ operator (billing, admin, Mode B REST)

งานมีเดีย async (Tier A)

แท็ก Gommo V2: POST /ai/models → create job → poll POST /ai/jobs/{id} (3.5s สูงสุด 80) ไม่มี webhook งานบน public API — วงจร request · อ่านแคตตาล็อก

ไฟล์สเปก

Dev	Production
http://localhost:5173/openapi.yaml	https://docs.yourdomain.com/openapi.yaml

เซิร์ฟเวอร์เริ่มต้น (Swagger)

เซิร์ฟเวอร์	คำอธิบาย
https://v2.api.gommo.net	งาน โมเดล อัปโหลด คลัง album
https://api.gommo.net	Auth แชท เสียง info รายการคลัง

แต่ละ operation ตั้ง servers เมื่อใช้ได้กับ host เดียว ดู Gommo public API สำหรับแผนที่ครบ

กลุ่ม path Gommo public

Tag	Host	ตัวอย่าง
Gommo V2	v2.api.gommo.net	/th/ai/models, /th/ai/jobs/{type}/{model}, /th/ai/library/album-images
Gommo Platform	api.gommo.net	/th/ai/me, /th/api/v2/chat, /th/ai/info/image/{id}

Self-host only (operator)

tag เหล่านี้เมื่อรัน repo บนเครื่อง (localhost:3001) — ไม่ใช่ contract การเชื่อมต่อค่าเริ่มต้น:

Tag	Server	ตัวอย่าง
Gateway Dev	localhost:3001	/gateway/jobs/{type}, /gateway/models
Billing	localhost:3001	/th/billing/payment/*
Admin	localhost:3001	/th/admin/*

→ Deploy → Self-host ขั้นสูง

Auth ในสเปก

Security scheme	ใช้กับ
bearerAuth	path สาธารณะ Gommo, /gateway/*, billing
adminKey (x-admin-key)	/th/admin/*

อ้างอิงสำหรับมนุษย์

→ Gommo public API · มีเดีย & งาน · การยืนยันตัวตน

ถัดไป

→ แผนที่ endpoint · โหมดการเชื่อมต่อ