Skip to content

Media jobs ​

Generate images, videos, music, and other media through Gommo V2 (https://v2.api.gommo.net). Jobs are asynchronous — create, then poll until complete.

Supported job types ​

typeExamples
imageText-to-image, edit
videoText/image-to-video
musicMusic generation
ttsTTS as a job type
avatar-lipsyncTalking avatar
image-upscale, remove-bgImage tools
video-upscale, video-vfx, video-subtitle, video-cutVideo tools

List available models for each type:

http
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%

Typical flow ​

1. POST v2…/ai/models?type=image     → pick model id + ratio/mode/…
2. POST v2…/ai/jobs/image/{model_id} → create job
3. POST v2…/ai/jobs/{id}?media=image → poll until complete
4. Use result URL from completed job

Create job ​

http
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 on white background&ratio=16:9&mode=low&resolution=2k

WARNING

ratio, mode, resolution, and duration must come from your models list for that model — not from docs or other models.

Polling ​

Poll every 3500 ms, max 80 attempts:

http
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

Poll media: image | video | music (match job type).

Upload + job pipeline ​

Many video/image workflows need an asset URL first:

  1. Upload image or video → get file URL
  2. Pass URL in job form (field name from model catalog)
  3. Create and poll job

Job status (auth host) ​

Optional detail endpoints on api.gommo.net:

POST https://api.gommo.net/ai/info/image/{id_base}
POST https://api.gommo.net/ai/info/video/{id}

Optional: self-host (operators) ​

When self-hosting this repo — see Deploy → Self-host (advanced). Not required for direct Gommo integration.

Full API ​

→ Media & jobs reference · Models overview · Gommo public API

Next ​

→ Upload · Chat · Features overview