Cookbook (công thức tích hợp)

Các công thức từng bước cho Gommo public API (v2.api.gommo.net + api.gommo.net).

Operator

Self-host JSON/proxy → Deploy → Self-host nâng cao. Recipe bên dưới dùng Gommo public API.

Thử trên trình duyệt trước

Playground — tab Endpoints hiện URL public; Try/Send có thể qua dev proxy khi chạy npm run docs:stack.

Chuẩn bị (mọi recipe)

Mục	Giá trị
Public API	`https://v2.api.gommo.net` (jobs) · `https://api.gommo.net` (auth/chat)
Token	Gommo user `access_token` — Authentication
Catalog	Không đoán `ratio` / `mode` / `resolution` / `duration` — Models

powershell

$env:TOKEN = "<access_token>"
$h = @{ Authorization = "Bearer $env:TOKEN"; 'Content-Type' = 'application/x-www-form-urlencoded' }

Recipe	Mục tiêu
Image job đầu tiên	Login → models → image + client poll
Job async + poll loop	`wait: false` → poll thủ công / loop

Recipe	Mục tiêu
Video hoặc music job	Cùng pattern, khác `type`
Tool jobs (upscale, remove-bg)	Upload → upscale / xóa nền
Upload ảnh	Multipart upload → URL công khai

Recipe	Mục tiêu
App bảng tin home	Login → projects → newfeeds → explore / thông báo
Chat + stream	Agent chat và SSE
Audio TTS	Tìm voice → tổng hợp giọng
Agent HTTP flow	Vòng lặp tối thiểu cho agent / script

Recipe nạp credit gọi /vi/billing/* trên Gommo Developer self-host — không phải Gommo public API. Xem Portal & preview (operator):

Recipe	Mục tiêu
Nạp credit Gommo	Gói credit → QR chuyển khoản → poll sync
PayOS nạp credit (legacy)	Merchant PayOS + sendBalances