Cookbook

Step-by-step recipes for the Gommo public API (v2.api.gommo.net + api.gommo.net). Each page is one complete task with curl + PowerShell.

Operators

Self-host JSON/proxy shortcuts → Deploy → Self-host (advanced). Recipes below use the Gommo public API only.

Try in browser first

Playground — Endpoints tab shows public URLs; Try/Send may use the docs dev proxy when running npm run docs:stack.

Prerequisites (all recipes)

Item	Value
Public API	https://v2.api.gommo.net (jobs) · https://api.gommo.net (auth/chat)
Token	Gommo user access_token — Authentication
Catalog	Never guess ratio / mode / resolution / duration — Models

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

Recipes

Get started

Recipe	What you build
First image job (wait)	Login → models → image → poll until done
Async job + poll loop	Create job → manual / loop poll

Media

Recipe	What you build
Video or music job	Same pattern, different type
Tool jobs (upscale, remove-bg)	Upload → upscale / remove background
Upload image	Multipart upload → public URL

Platform

Recipe	What you build
Home feed app	Login → projects → newfeeds → optional explore & notifications
Chat + stream	Agent chat and SSE
Audio TTS	Search voices → synthesize
Agent HTTP flow	Minimal loop for LLM agents / scripts

Billing (operators)

Credit topup recipes call /billing/* on a self-hosted Gommo Developer instance — not the public Gommo API. See Portal & preview (operator):

Recipe	What you build
Gommo credit top-up	Credit packages → bank transfer → poll sync
PayOS topup (legacy)	Merchant PayOS + sendBalances

Next

• Quickstart — single linear path
• API Reference — full endpoint specs
• OpenAPI