Upstream hosts

Gommo exposes two HTTP bases. Production integrations call them directly — no gateway wrapper required.

Host map

Env variable	Default	Host	Used for
GOMMO_API_BASE_URL or GOMMO_BASE_URL	https://v2.api.gommo.net	V2 API	Media models, jobs, V2 upload
GOMMO_AUTH_BASE_URL	https://api.gommo.net	Platform API	Auth, chat, audio, feed
GOMMO_AUTH_PATH	/api/apps/go-mmo	—	Prefix for login, /ai/me
GOMMO_API_DOMAIN	(see .env.example)	—	domain field on every upstream call

Domain is not a hostname

GOMMO_API_DOMAIN is the registration domain of Gommo accounts (dealer-specific — do not copy from docs), not the API host. Send it in every form body.

What runs on each host

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

• POST /ai/models?type={type} — model catalog
• POST /ai/jobs/{type}/{modelSlug} — create job
• POST /ai/jobs/{id}?media={media} — poll status
• POST /ai/upload/image, /ai/upload/video — asset upload

Auth: Authorization: Bearer {user_access_token}
Body: application/x-www-form-urlencoded with domain, project_id, job fields.

api.gommo.net (platform)

• POST {GOMMO_AUTH_PATH}/auth/login — user login
• POST /ai/me — profile + credits
• POST /api/v2/chat — chat (supports SSE stream)
• POST /ai/audio — voices, TTS lists

Auth: Bearer for /api/v2/*; form access_token (+ Bearer where required) for platform routes.

Direct calls (recommended)

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 (operators only)

Optional REST/proxy mounts when you deploy this repo — Deploy → Self-host (advanced). Not part of the standard integrator path.

Next

→ Gommo public API · Routing overview