Models integration guide

Integrate with the Gommo public API on https://v2.api.gommo.net. Auth: Authorization: Bearer <access_token>. Form bodies include domain (your registration domain, e.g. <registration-domain>).

Read the catalog first

Before your first create, walk through How to read the catalog — then Request lifecycle for poll timing.

Gommo hosts the model catalog. Every media integration follows the same flow:

1. List models for a job type — read-catalog
2. Pick model / slug and allowed parameters from the response
3. Create job — never guess fields
4. Poll — client poll every 3.5s, max 80 attempts (~5 min)

Browse the live catalog on the Models tab.

List models (recommended)

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%

Full request examples → Media & jobs reference.

Create a job

Use the model id from the catalog (field name may be model, slug, or id_base in the response):

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

domain=%REGISTRATION_DOMAIN%&project_id=default&prompt=A product photo on white background&ratio=16:9&mode=low&resolution=2k

Field values must come from your models list for that model — see Parameters.

Polling

Gommo does not webhook job completion. Poll until terminal status:

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

domain=%REGISTRATION_DOMAIN%&project_id=default

Setting	Value
Interval	3500 ms
Max attempts	80
Poll media	image | video | music (match job type)

Optional: self-host (operators)

When self-hosting only — see Deploy → Self-host (advanced). Tier A integrations use the public hosts above.

Next

→ Read the catalog · Job types · Parameters · Quickstart