Host upstream

Gommo có hai HTTP base. Production gọi trực tiếp — không cần gateway wrapper.

Bảng host

Biến env	Mặc định	Host	Dùng cho
GOMMO_API_BASE_URL hoặc GOMMO_BASE_URL	https://v2.api.gommo.net	V2 API	Models, jobs, upload V2
GOMMO_AUTH_BASE_URL	https://api.gommo.net	Platform	Auth, chat, audio
GOMMO_AUTH_PATH	/vi/api/apps/go-mmo	—	Prefix login, /vi/ai/me
GOMMO_API_DOMAIN	(see .env.example)	—	Field domain mọi request

Domain không phải hostname API

GOMMO_API_DOMAIN là domain đăng ký tài khoản Gommo (domain đăng ký — không copy từ docs). Gửi trong mọi form body.

API trên từng host

v2.api.gommo.net (V2 / media)

• POST /ai/models?type={type} — catalog
• POST /ai/jobs/{type}/{modelSlug} — tạo job
• POST /ai/jobs/{id}?media={media} — poll
• POST /ai/upload/image, /vi/ai/upload/video

Auth: Authorization: Bearer {user_access_token}
Body: form urlencoded với domain, project_id, field job.

api.gommo.net (platform)

• POST {GOMMO_AUTH_PATH}/auth/login — login
• POST /ai/me — profile + credit
• POST /api/v2/chat — chat (SSE)
• POST /ai/audio — voices, TTS

Auth: Bearer cho /vi/api/v2/*; form access_token (+ Bearer khi cần) cho platform.

Gọi trực tiếp (khuyến nghị)

POST https://v2.api.gommo.net/ai/jobs/image/flux-dev
  Authorization: Bearer {token}
  domain=%REGISTRATION_DOMAIN%&prompt=...

POST https://api.gommo.net/api/v2/chat
  action=chat&access_token={token}&domain=%REGISTRATION_DOMAIN%&...

POST https://api.gommo.net/api/apps/go-mmo/auth/login
  email=...&password=...&domain=%REGISTRATION_DOMAIN%

→ Gommo public API

Self-host (chỉ operator)

Mount REST/proxy tùy chọn khi deploy repo — Deploy → Self-host nâng cao. Không thuộc luồng integrator chuẩn.

Tiếp theo

→ Gommo public API · Routing overview