Upload

Upload assets to Gommo storage before passing URLs into media jobs (e.g. image-to-video, edit workflows).

Endpoints (recommended)

Asset	URL
Image	POST https://v2.api.gommo.net/ai/upload/image
Video	POST https://v2.api.gommo.net/ai/upload/video

Auth: Authorization: Bearer {access_token}. Form: domain, project_id=default, file field.

Multipart fields

Type	Field name	Notes
Image	file	Optional fileName
Video	video_file or file	Respect upstream size limits

Upload image

curl -X POST "https://v2.api.gommo.net/ai/upload/image" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "domain=%REGISTRATION_DOMAIN%" \
  -F "project_id=default" \
  -F "[email protected]"

Response includes a URL to use in subsequent job form fields (exact field name depends on the target model).

Upload video

curl -X POST "https://v2.api.gommo.net/ai/upload/video" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "domain=%REGISTRATION_DOMAIN%" \
  -F "project_id=default" \
  -F "[email protected]"

Typical workflow

Upload asset  →  URL in response
       ↓
POST v2…/ai/models?type=video
       ↓
POST v2…/ai/jobs/video/{model_id}  with URL + prompt + ratio from catalog
       ↓
Poll POST v2…/ai/jobs/{id}?media=video

Portal UI

Manage uploads at Files (sidebar Developer → Files, badge beta):

• Gommo album (images/videos) from library API
• Copy URL for use in job form fields

Optional: self-host (operators)

When self-hosting this repo — Deploy → Self-host (advanced).

Full API

→ Upload reference · Gommo public API

Next

→ Media jobs · Features overview