1 USD ≈ 27,000 credits · display only
Reference rate may change over time.
Endpoint map
Advanced / operator docs
Linked from Deploy → Self-host (advanced). Tier A integrators use Gommo public API only.
Side-by-side mapping for common operations.
Public integration (recommended): call Gommo directly — see Gommo public API.
Optional dev: replace {gateway} with your Gommo Developer base (e.g. http://localhost:3001).
Media & jobs
| Operation | Mode A (Direct) | Mode B (REST) | Mode C (Proxy) |
|---|---|---|---|
| List models | POST https://v2.api.gommo.net/ai/models?type={type} | GET {gateway}/gateway/models?type={type} | POST {gateway}/v2/ai/models?type={type} |
| Create job | POST https://v2.api.gommo.net/ai/jobs/{type}/{slug} | POST {gateway}/gateway/jobs/{type} | POST {gateway}/v2/ai/jobs/{type}/{slug} |
| Poll job | POST https://v2.api.gommo.net/ai/jobs/{id}?media={media} | GET {gateway}/gateway/jobs/{id}?media={media} | POST {gateway}/v2/ai/jobs/{id}?media={media} |
Job types: image, video, tts, music, avatar-lipsync, image-upscale, remove-bg, video-upscale, video-vfx, video-subtitle, video-cut
Poll media: image | video | music
Mode B create body (JSON):
json
{
"modelSlug": "flux-dev",
"wait": false,
"fields": { "prompt": "…", "ratio": "16:9" }
}Mode A/C create body (form): domain, project_id, prompt, ratio, …
Upload
| Operation | Mode A | Mode B | Mode C |
|---|---|---|---|
| Upload image | POST v2…/ai/upload/image | POST {gateway}/gateway/upload/image | POST {gateway}/v2/ai/upload/image |
| Upload video | POST v2…/ai/upload/video | POST {gateway}/gateway/upload/video | POST {gateway}/v2/ai/upload/video |
Chat
| Operation | Mode A | Mode B | Mode C |
|---|---|---|---|
| Chat (JSON) | POST api…/api/v2/chat | POST {gateway}/gateway/chat | POST {gateway}/api/v2/chat |
| Chat (stream) | Same + SSE | Same — gateway pipes stream | Same — proxy pipes stream |
| Chat models catalog | POST api…/api/v2/chat action=models | GET {gateway}/gateway/chat-models | POST api…/api/v2/chat |
| Chat sessions sync | POST api…/api/v2/ai-chat-sessions | POST {gateway}/gateway/chat-sessions JSON { action, sessionId?, … } | POST api…/api/v2/ai-chat-sessions |
| OpenAI shim | — | POST {gateway}/v1/chat/completions | — |
Stream triggers when URL contains /chat or Content-Type: text/event-stream.
OpenAI shim accepts standard messages[] + optional stream: true. Model format: model::server (e.g. gpt-5.5::cheap) or server default from env.
Audio
| Operation | Mode A | Mode B | Mode C |
|---|---|---|---|
| Voices | POST api…/ai/audio | POST {gateway}/gateway/audio/voices | POST {gateway}/ai/audio |
| TTS | POST api…/ai/audio | POST {gateway}/gateway/audio/tts | POST {gateway}/ai/audio |
| Lists | GET api…/… | GET {gateway}/gateway/audio/lists | via platform paths |
Library (lists & albums)
| Operation | Mode A | Mode B | Mode C |
|---|---|---|---|
| Image album | POST v2…/ai/library/album-images | POST {gateway}/gateway/library/album-images | POST {gateway}/v2/ai/library/album-images |
| Video album | POST v2…/ai/library/album-videos | POST {gateway}/gateway/library/album-videos | POST {gateway}/v2/ai/library/album-videos |
| Music / audio / image / video lists | POST v2…/ai/library/{musics|audios|images|videos} | POST {gateway}/gateway/library/{resource} | POST {gateway}/v2/ai/library/{resource} |
Mode B body (JSON): projectId, limit, order_by, sort_by, optional device_id / device_name / device_info. Gateway fills domain and upstream form access_token from Bearer.
Community explore
| Operation | Mode A | Mode B | Mode C |
|---|---|---|---|
| Public videos | POST api…/api/apps/go-mmo/ai/public-videos | POST {gateway}/gateway/explore/public-videos | POST {gateway}/api/apps/go-mmo/ai/public-videos |
| Public images | POST api…/api/apps/go-mmo/ai/images | POST {gateway}/gateway/explore/images | POST {gateway}/api/apps/go-mmo/ai/images |
Mode B body (JSON): videos — type, publicPrompt, language, optional model; images — projectId, afterId, feedType (upstream feed_type; alias sort), optional search, category, model, type, language. Bearer optional (public browse); gateway fills domain when omitted.
Home newsfeed
| Operation | Mode A | Mode B | Mode C |
|---|---|---|---|
| Newfeeds | POST api…/ai/newfeeds | POST {gateway}/gateway/newfeeds | POST {gateway}/ai/newfeeds |
Mode B JSON: preset (public_timeline | my_feed, aliases public / mine), limit, projectId, afterVideoId, afterImageId, language, optional explicit privacy. Bearer required. Presets map to privacy=PUBLIC vs empty privacy + dual cursors for my feed.
Home app shell
| Operation | Mode A | Mode B | Mode C |
|---|---|---|---|
| List projects (legacy) | POST api…/ai/projects | POST {gateway}/gateway/projects | POST {gateway}/ai/projects |
| AI projects V2 | POST api…/api/v2/ai-projects … set_password, get + optional password, invite, invite_revoke, member_kick, stats (period), activity_list (limit, offset), … | POST {gateway}/gateway/ai-projects JSON { action, id_base?, password?, period?, limit?, offset?, identifier?, role?, access?, scopes?, invite_id?, user_id?, budget?, … } | POST {gateway}/api/v2/ai-projects |
| Project media | files-manager list (project, media_type); /ai/audio get.list + project_id; ai_musics/getAll | POST {gateway}/gateway/files-manager, /gateway/project-media/audio, /gateway/project-media/music | POST {gateway}/api/v2/files-manager |
| Credit pools | POST api…/api/v2/credit-pools — verified list, ledger, create, deposit (pool_id, amount), delete, set_share_credit; scope_type, scope_id | POST {gateway}/gateway/credit-pools JSON { action, scope_type?, scope_id?, pool_id?, amount?, … } | POST {gateway}/api/v2/credit-pools |
| Notifications | POST api…/ai/notifications | POST {gateway}/gateway/notifications | POST {gateway}/ai/notifications |
| News & updates | POST api…/api/apps/go-mmo/news/getAll | POST {gateway}/gateway/news JSON { limit?, lang_id? } | POST {gateway}/api/apps/go-mmo/news/getAll |
| Changelogs (recent updates) | POST api…/api/apps/go-mmo/app/changelogs | POST {gateway}/gateway/changelogs JSON { limit?, app?, format?, language?, site_domain? } | POST {gateway}/api/apps/go-mmo/app/changelogs |
| Devices | POST api…/api/v2/devices | POST {gateway}/gateway/devices | POST {gateway}/api/v2/devices |
| Support tickets | POST api…/support/myTickets (+ create/detail/reply) | POST {gateway}/gateway/support/tickets (+ /create, /detail, /reply) | POST {gateway}/api/apps/go-mmo/support/* |
| Partner program | POST api…/users/partner_program | POST {gateway}/gateway/partner-program | POST {gateway}/api/apps/go-mmo/users/partner_program |
| Creator Rewards | POST api…/users/creator_rewards | POST {gateway}/gateway/creator-rewards | POST {gateway}/api/apps/go-mmo/users/creator_rewards |
Mode B JSON (devices): action register | list | rename | disable; optional current_device_id, language, device_id / device_name / device_info. Bearer required. Rename/disable target device_id (UUID). See Session devices.
Mode B JSON (support): list at /gateway/support/tickets; create subject, issue_type, description; detail/reply ticket_id_base (SUP-…). See Support tickets.
Mode B JSON (partner): action_type status | apply at /gateway/partner-program; apply requires payout fields + accept_rules. See Partner program.
Mode B JSON (creator rewards): action_type status | pool | apply at /gateway/creator-rewards; apply uses payout_pref credit | cash + accept_rules. See Creator rewards.
Media info (detail)
| Operation | Mode A | Mode B | Mode C |
|---|---|---|---|
| Image info | POST api…/ai/info/image/{id} | POST {gateway}/gateway/info/image/{id} | POST {gateway}/ai/info/image/{id} |
| Video info | POST api…/ai/info/video/{id} | POST {gateway}/gateway/info/video/{id} | POST {gateway}/ai/info/video/{id} |
| Music info | POST api…/ai/info/music/{id} | POST {gateway}/gateway/info/music/{id} | POST {gateway}/ai/info/music/{id} |
Mode B JSON body optional: projectId. Path {id} is job id / id_base. Bearer required.
Auth (platform host — Mode A recommended)
| Operation | Mode A (Direct) | Mode B/C (optional gateway) |
|---|---|---|
| Login | POST https://api.gommo.net/api/apps/go-mmo/auth/login | POST {gateway}/api/apps/go-mmo/auth/login or POST {gateway}/gateway/auth/login (JSON) |
| Register | Merchant POST …/auth/register (server only) | POST {gateway}/gateway/auth/register (JSON; merchant env on server) |
| Change password | POST https://api.gommo.net/api/apps/go-mmo/auth/change-password | POST {gateway}/gateway/auth/change-password only (JSON + Bearer) |
| Transfer credits | POST https://api.gommo.net/api/apps/go-mmo/users/sendBalances | POST {gateway}/gateway/credits/transfer only (JSON + Bearer) |
| Transaction history | POST https://api.gommo.net/api/apps/go-mmo/users/paymentsHistory | POST {gateway}/gateway/credits/transactions only (JSON + Bearer) |
| Session devices | POST https://api.gommo.net/api/v2/devices | POST {gateway}/gateway/devices only (JSON + Bearer) |
| Support tickets | POST https://api.gommo.net/api/apps/go-mmo/support/* | POST {gateway}/gateway/support/tickets (+ /create, /detail, /reply) (JSON + Bearer) |
| Partner program | POST https://api.gommo.net/api/apps/go-mmo/users/partner_program | POST {gateway}/gateway/partner-program (JSON + Bearer) |
| Creator Rewards | POST https://api.gommo.net/api/apps/go-mmo/users/creator_rewards | POST {gateway}/gateway/creator-rewards (JSON + Bearer) |
| Profile | POST https://api.gommo.net/ai/me | POST {gateway}/ai/me |
Mode A (integrators): call api.gommo.net directly for login, change password, P2P transfer (users/sendBalances), wallet ledger (users/paymentsHistory), session devices (/api/v2/devices), and /ai/me. User registration uses merchant-backed auth/register on your server, not a public user Bearer flow — see Sign up.
Mode B self-host: typed JSON at /gateway/auth/login, /gateway/auth/register, /gateway/auth/change-password, /gateway/credits/transfer, /gateway/credits/transactions, /gateway/devices, /gateway/support/tickets (+ create/detail/reply), /gateway/partner-program, and /gateway/creator-rewards (Bearer + JSON). Login may also use auth proxy POST {gateway}/api/apps/go-mmo/auth/login. Profile: POST {gateway}/ai/me. See Sign up, Change password, Transfer credits, Transaction history, Session devices, Support tickets, Partner program, Creator rewards.
Domain field
| Mode | Who sends domain |
|---|---|
| A Direct | Client in every form body |
| B REST | Optional — gateway uses GOMMO_API_DOMAIN |
| C Proxy | Client in form (required by upstream) |
Polling defaults (Mode B wait: true)
| Setting | Value |
|---|---|
| Interval | 3500 ms |
| Max attempts | 80 (~4.7 min) |
| Webhook | None — Gommo does not push completion |
Detailed API docs
→ Media & jobs · Upload · Chat · Audio · AI projects