Gommo public API

Use these URLs when integrating directly with Gommo (standard Gommo public API). Auth: Authorization: Bearer <access_token> on HTTPS. Form bodies include domain (your app domain, e.g. <registration-domain>).

Hosts

Host	Use for
https://v2.api.gommo.net	Models, create/poll jobs, upload image/video, album library
https://api.gommo.net	Login, /ai/me, info jobs, library lists, chat, platform audio

The playground Endpoints tab shows the full URL per operation (v2 vs auth).

Media & jobs (v2)

Operation	Method	URL
List models	GET or POST	https://v2.api.gommo.net/ai/models?type={type}
Create job	POST	https://v2.api.gommo.net/ai/jobs/{type}/{model_id}
Poll job	POST	https://v2.api.gommo.net/ai/jobs/{id_base}?media=image|video|music
Upload image	POST	https://v2.api.gommo.net/ai/upload/image
Upload video	POST	https://v2.api.gommo.net/ai/upload/video

Create/poll use application/x-www-form-urlencoded (not gateway JSON). Always load models first — never guess ratio, mode, resolution, or duration.

Poll: 3.5s interval, max 80 attempts (~5 min). No webhooks.

Library & albums

Operation	Host	Path
Image album	v2	POST /ai/library/album-images
Video album	v2	POST /ai/library/album-videos
Music library	v2	POST /ai/library/musics
Audio library	v2	POST /ai/library/audios

Album body (typical): domain, project_id, limit, order_by, sort_by (+ access_token in form or Bearer header).

Community explore (auth platform app)

Public feeds shown on dealer sites (e.g. Explore tab). application/x-www-form-urlencoded. Bearer is optional for read-only browsing; signed-in users get fields like liked and permissions.

Operation	URL
Community videos	POST https://api.gommo.net/api/apps/go-mmo/ai/public-videos
Community images	POST https://api.gommo.net/api/apps/go-mmo/ai/images

Videos (typical): domain, type=public_home, public_prompt=true|false, optional language, model, access_token.

Images (typical): domain, project_id=default, feed_type=suggested, optional search, category, after_id (pagination cursor), language, model, type (often empty), access_token.

Response items include media URLs (download_url, thumbnail_url, resolutions[]), author (author.name, author.avatar), and social counts. Top-level shape is usually { "data": [ … ] } (array) or nested lists — treat as pass-through JSON.

Home newsfeed (newfeeds)

Mixed timeline on dealer home (Bảng tin / Của tôi). POST https://api.gommo.net/ai/newfeeds — form-urlencoded, login required (access_token).

Preset	Typical form
Public timeline (Bảng tin)	privacy=PUBLIC, limit=30, project_id=default, optional after_video_id, language
My feed (Của tôi)	privacy= (empty), limit=30, after_video_id + after_image_id (empty first page), same domain/device

Response: { "data": [ … ] } — video/image/music items with type, URLs, author, liked, permissions (pass-through).

→ Step-by-step: Home feed cookbook

Projects & notifications (auth)

Typical home app shell calls (form-urlencoded on api.gommo.net, login required):

Operation	URL
List AI projects (legacy)	POST https://api.gommo.net/ai/projects
AI projects V2 (CRUD)	POST https://api.gommo.net/api/v2/ai-projects
Notifications inbox	POST https://api.gommo.net/ai/notifications
News & updates (dealer CMS)	POST https://api.gommo.net/api/apps/go-mmo/news/getAll
Changelogs (recent updates)	POST https://api.gommo.net/api/apps/go-mmo/app/changelogs
Session devices	POST https://api.gommo.net/api/v2/devices
Support tickets	POST https://api.gommo.net/api/apps/go-mmo/support/myTickets (+ create, detail, reply)

Projects (legacy): domain, access_token — response { "data": [ { "id", "id_base", "name", … } ] } (pass-through).

AI projects V2: same host, form action=list, create, get, update, delete, set_password (id_base, password; empty clears), get optional password when protected, member_list, member_kick, invite, invite_revoke, set_budget, stats (id_base, period: all|today|yesterday|this_month|last_month), or activity_list (id_base, limit, offset — dealer tab Lịch sử hoạt động), plus domain, access_token, language, device fields. invite: identifier, role (member|mod|admin), access, scopes (JSON). invite_revoke: invite_id. member_kick: user_id from member_list. set_budget: integer budget (0 = unlimited upstream). Credit pools (budget tab): POST …/api/v2/credit-pools with action=list, ledger, create, deposit (pool_id, amount), delete (pool_id), or set_share_credit; scope_type=project, scope_id=id_base where applicable. deposit: wallet must keep 100k reserve (amount + 100k required).

Project media (modal tab): POST …/api/v2/files-manager action=list (project, media_type=image|video); POST …/ai/audio action_type=get.list + project_id; POST …/ai_musics/getAll + project_id.

→ AI projects · Credit pools

Notifications: domain, access_token, optional limit, page — pass-through envelope (may include data array when present).

Devices: domain, access_token, optional action, device_id / device_name / device_info — pass-through (typical home app startup). Many feeds accept the same device fields on each request.

Support: domain, access_token — list POST …/support/myTickets; create …/support/create with subject, issue_type, description; detail/reply use public ticket_id_base (SUP-…, same as ticket_id_hash from create). Optional language, device fields.

→ Support tickets

Partner program: domain, access_token, action_type status | apply — POST …/users/partner_program (underscore). Status may send optional lang; apply requires payout fields and accept_rules=1. Prefer application?.status for pending review.

→ Partner program

Creator Rewards: same auth pattern — POST …/users/creator_rewards with action_type status | pool | apply. Apply uses payout_pref (credit | cash) and accept_rules=1. Prefer program.application?.status for pending review.

→ Creator rewards

News & updates (dealer CMS)

Dealer News & Updates tab (not the notifications inbox):

POST https://api.gommo.net/api/apps/go-mmo/news/getAll — form domain, access_token, optional limit (often 100), lang_id (en, vi, …), device fields.

Response: { "data": [ { "id_base", "title", "content" (HTML), "type", "thumbnail", "is_new", "is_pinned", … } ], "runtime" } — content is CMS-managed per registration domain; filter by type is often client-side. Sanitize HTML in your UI.

→ News & updates reference

Changelogs (recent updates)

Dealer Recent updates modal and user-menu Changelogs:

POST https://api.gommo.net/api/apps/go-mmo/app/changelogs — form domain, access_token, optional site_domain (often same as domain), format (e.g. flat), app (e.g. ai), limit, language, device fields.

Response: { "data": [ { "id", "log_type", "title", "content" (HTML), "banner_url", "banner_type", "cta", … } ], "runtime" } — not the same feed as news/getAll.

→ Changelogs reference

Dealer-only (not Tier A home)

Calls such as community-chat, get_rooms, mini-apps, site-config, and domain-config-get appear on dealer web apps but are not required to build a third-party home feed. news/getAll and app/changelogs are optional — News tab vs release-notes modal. See Home feed cookbook.

Job status (auth)

Operation	URL
Image info	POST https://api.gommo.net/ai/info/image/{id_base}
Video info	POST https://api.gommo.net/ai/info/video/{id}
Music info	POST https://api.gommo.net/ai/info/music/{id_base}

Auth & profile (auth)

Operation	URL
Login	POST https://api.gommo.net/api/apps/go-mmo/auth/login
Register (merchant, server)	POST https://api.gommo.net/api/apps/go-mmo/auth/register
Change password	POST https://api.gommo.net/api/apps/go-mmo/auth/change-password
Transfer credits	POST https://api.gommo.net/api/apps/go-mmo/users/sendBalances
Transaction history	POST https://api.gommo.net/api/apps/go-mmo/users/paymentsHistory
Me / credits	POST https://api.gommo.net/ai/me

→ Sign up · Change password · Transfer credits · Transaction history · Session devices · Support tickets · Partner program · Creator rewards

Chat & audio (auth)

Operation	URL
Chat / stream / models / set_model	POST https://api.gommo.net/api/v2/chat — action=chat | stream | models | set_model
Chat sessions (sync)	POST https://api.gommo.net/api/v2/ai-chat-sessions — save_message, list_sessions, get_messages, get_session
Voices / TTS	POST https://api.gommo.net/ai/audio

→ Chat reference (form fields, SSE parsing, sessions)

Self-host (operators only)

This repo can expose optional REST/proxy mounts when deployed — see Deploy → Self-host (advanced). Not the default integration path.

OpenAPI

Public paths are listed in openapi.yaml under tags Gommo V2 and Gommo Platform. Self-host-only paths (billing, /gateway/*, admin) are tagged separately — see Deploy → Self-host (advanced).

Next

→ Quickstart · Authentication · Media & jobs