Endpoint map
So sánh thao tác phổ biến.
Tích hợp public (khuyến nghị): gọi thẳng Gommo — Gommo public API.
Dev tùy chọn: {gateway} = Gommo Developer local (vd. http://localhost:3001).
Media & jobs
| Thao tác | 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, …
Poll media: image | video | music
Body Mode B (JSON):
{ "modelSlug": "flux-dev", "wait": false, "fields": { "prompt": "…", "ratio": "16:9" } }Mode A/C: form domain, project_id, prompt, ratio, …
Upload
| Thao tác | Mode A | Mode B | Mode C |
|---|---|---|---|
| Image | POST v2…/ai/upload/image | POST {gateway}/gateway/upload/image | POST {gateway}/v2/ai/upload/image |
| Video | POST v2…/ai/upload/video | POST {gateway}/gateway/upload/video | POST {gateway}/v2/ai/upload/video |
Chat
| Thao tác | Mode A | Mode B | Mode C |
|---|---|---|---|
| Chat | POST api…/api/v2/chat | POST {gateway}/gateway/chat | POST {gateway}/api/v2/chat |
| Stream | SSE upstream | Gateway pipe | Proxy pipe |
| Models | POST api…/api/v2/chat action=models | GET {gateway}/gateway/chat-models | POST api…/api/v2/chat |
| Sessions | POST api…/api/v2/ai-chat-sessions | POST {gateway}/gateway/chat-sessions | POST api…/api/v2/ai-chat-sessions |
Audio
| Thao tác | 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 | qua platform paths |
Library (album & danh sách)
| Thao tác | Mode A | Mode B | Mode C |
|---|---|---|---|
| Album ảnh | POST v2…/ai/library/album-images | POST {gateway}/gateway/library/album-images | POST {gateway}/v2/ai/library/album-images |
| Album video | POST v2…/ai/library/album-videos | POST {gateway}/gateway/library/album-videos | POST {gateway}/v2/ai/library/album-videos |
| Danh sách music / audio / image / video | POST v2…/ai/library/{musics|audios|images|videos} | POST {gateway}/gateway/library/{resource} | POST {gateway}/v2/ai/library/{resource} |
Mode B (JSON): projectId, limit, order_by, sort_by, tùy chọn device_id / device_name / device_info. Gateway điền domain và access_token upstream từ Bearer.
Explore cộng đồng
| Thao tác | Mode A | Mode B | Mode C |
|---|---|---|---|
| Video công khai | POST api…/api/apps/go-mmo/ai/public-videos | POST {gateway}/gateway/explore/public-videos | POST {gateway}/api/apps/go-mmo/ai/public-videos |
| Ảnh công khai | POST api…/api/apps/go-mmo/ai/images | POST {gateway}/gateway/explore/images | POST {gateway}/api/apps/go-mmo/ai/images |
Mode B (JSON): video — type, publicPrompt, language, tùy chọn model; ảnh — projectId, afterId, feedType (upstream feed_type), tùy chọn search, category, model, type, language. Bearer tùy chọn (browse công khai).
Bảng tin home (newfeeds)
| Thao tác | 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, alias public / mine), limit, projectId, afterVideoId, afterImageId, language, tùy chọn privacy. Bearer bắt buộc.
Auth
| Thao tác | Mode A | Mode B/C |
|---|---|---|
| Login | POST api…/api/apps/go-mmo/auth/login | POST {gateway}/api/apps/go-mmo/auth/login hoặc POST {gateway}/gateway/auth/login (JSON) |
| Đăng ký | Merchant POST …/auth/register (chỉ server) | POST {gateway}/gateway/auth/register (JSON; env merchant trên server) |
| Đổi mật khẩu | POST api…/api/apps/go-mmo/auth/change-password | POST {gateway}/gateway/auth/change-password only (JSON + Bearer) |
| Chuyển credit | POST api…/users/sendBalances | POST {gateway}/gateway/credits/transfer only (JSON + Bearer) |
| Lịch sử giao dịch | POST api…/users/paymentsHistory | POST {gateway}/gateway/credits/transactions only (JSON + Bearer) |
| Thiết bị đăng nhập | POST api…/api/v2/devices | POST {gateway}/gateway/devices only (JSON + Bearer) |
| Ticket hỗ trợ | POST api…/support/* | POST {gateway}/gateway/support/tickets (+ /create, /detail, /reply) |
| Chương trình đối tác | POST api…/users/partner_program | POST {gateway}/gateway/partner-program |
| Creator Rewards | POST api…/users/creator_rewards | POST {gateway}/gateway/creator-rewards |
| Profile | POST api…/…/ai/me | POST {gateway}/ai/me hoặc proxy POST {gateway}/api/apps/go-mmo/ai/me |
Mode A: gọi trực tiếp api.gommo.net (login, đổi mật khẩu, chuyển credit, ledger paymentsHistory, devices, support, partner, creator rewards, /ai/me). Mode B self-host: JSON typed login/register/change-password/transfer, /gateway/credits/transactions, /gateway/devices, /gateway/support/tickets, /gateway/partner-program, /gateway/creator-rewards. Chi tiết: Đăng ký · Đổi mật khẩu · Chuyển credit · Lịch sử giao dịch · Thiết bị đăng nhập · Ticket hỗ trợ · Chương trình đối tác · Creator Rewards.
Field domain
| Mode | Ai gửi domain |
|---|---|
| A | Client mọi form |
| B | Tùy chọn — gateway dùng env |
| C | Client (bắt buộc) |
Poll mặc định (wait: true)
| Interval | 3500 ms |
| Max | 80 (~4.7 phút) |
| Webhook | Không |
Home app shell
| Thao tác | 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 + password, invite, member_kick, stats, activity_list, … | POST {gateway}/gateway/ai-projects JSON { action, id_base?, password?, … } | POST {gateway}/api/v2/ai-projects |
| Media dự án | files-manager list; /ai/audio get.list; ai_musics/getAll | /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 — list, ledger, create, deposit, delete, set_share_credit; scope_type, scope_id, pool_id | POST {gateway}/gateway/credit-pools JSON | POST {gateway}/api/v2/credit-pools |
| Notifications | POST api…/ai/notifications | POST {gateway}/gateway/notifications | POST {gateway}/ai/notifications |
| Tin tức & cập nhật | POST api…/api/apps/go-mmo/news/getAll | POST {gateway}/gateway/news | POST {gateway}/api/apps/go-mmo/news/getAll |
| Changelogs (recent updates) | POST api…/api/apps/go-mmo/app/changelogs | POST {gateway}/gateway/changelogs | POST {gateway}/api/apps/go-mmo/app/changelogs |
| Devices | POST api…/api/v2/devices | POST {gateway}/gateway/devices | POST {gateway}/api/v2/devices |
| Support | POST api…/support/myTickets (+ create/detail/reply) | POST {gateway}/gateway/support/tickets (+ subpaths) | 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; tùy chọn current_device_id, language, device_id / device_name / device_info. Bearer bắt buộc. Rename/disable dùng device_id (UUID). Xem Thiết bị đăng nhập. Support: ticket_id_base (SUP-…) — Ticket hỗ trợ. Partner: action_type status | apply — Chương trình đối tác. Creator Rewards: action_type status | pool | apply — Creator Rewards. Notifications: tùy chọn limit, page trên /gateway/notifications.
Chi tiết media (info)
| Thao tác | 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 tùy chọn: projectId. Path {id} là job id / id_base. Bearer bắt buộc.
API chi tiết
→ Media · Upload · Chat · AI projects