เริ่มต้นใช้งาน

จาก ศูนย์ถึงงานรูปภาพแรก บน Gommo public API (v2.api.gommo.net + api.gommo.net) แผนที่ host ทั้งหมด: Gommo public API

งาน async

หลัง create ต้อง poll จนได้ URL ผลลัพธ์ อ่าน วงจร request ครั้งหนึ่ง — แล้วทำขั้น 1–3 ด้านล่าง

เลือกเส้นทางของคุณ

เส้นทาง	เริ่มที่นี่
Integrator (Tier A)	คู่มือ integrator — public API เท่านั้น ไม่ self-host
HTTP client	ทำตามด้านล่าง — curl หรือ PowerShell
แอปฟีด home	Cookbook home feed — newfeeds, projects (ไม่รวม mini-app/chat ของ dealer)
เบราว์เซอร์	API Playground — แท็บ Request แสดง URL สาธารณะ
AI agents	MCP — 10 เครื่องมือ gommo_* ใช้ token จาก /th/app/token/
Self-host (operator)	Deploy → Self-host ขั้นสูง

สิ่งที่ต้องมี

รายการ	ค่า
บัญชี Gommo	อีเมล + รหัสผ่าน + โดเมนลงทะเบียน (ดู การยืนยันตัวตน)
HTTPS client	curl, PowerShell หรือ Playground

ตั้ง GOMMO_API_DOMAIN (PowerShell) หรือ REGISTRATION_DOMAIN (curl.exe) ก่อนรันตัวอย่าง — ต้องตรงโดเมน signup ของ user

Playground

ลอง flow เดียวกันในเบราว์เซอร์: Playground — แท็บ Endpoints แสดง URL สาธารณะครบทุก operation

1. เข้าสู่ระบบ (api.gommo.net)

curl

curl.exe -X POST "https://api.gommo.net/api/apps/go-mmo/auth/login" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "[email protected]&password=YOUR_PASSWORD&domain=%REGISTRATION_DOMAIN%"

PowerShell

$domain = $env:GOMMO_API_DOMAIN; if (-not $domain) { throw 'Set GOMMO_API_DOMAIN to the user registration domain (dealer)' }
$loginBody = "[email protected]&password=YOUR_PASSWORD&domain=$domain"
$login = Invoke-RestMethod -Method POST `
  -Uri "https://api.gommo.net/api/apps/go-mmo/auth/login" `
  -ContentType "application/x-www-form-urlencoded" `
  -Body $loginBody
$env:TOKEN = $login.access_token

2. ดูรายการโมเดล (v2.api.gommo.net)

ห้ามเดา ratio — อ่านจาก catalog เท่านั้น

curl

curl.exe "https://v2.api.gommo.net/ai/models?type=image" ^
  -H "Authorization: Bearer %TOKEN%"

PowerShell

$h = @{ Authorization = "Bearer $env:TOKEN" }
$models = Invoke-RestMethod `
  -Uri "https://v2.api.gommo.net/ai/models?type=image" `
  -Headers $h
$m = $models.data[0]
$slug = $m.model
if (-not $slug) { $slug = $m.slug }
$ratio = $m.ratios[0]
if ($ratio -is [pscustomobject]) { $ratio = $ratio.value }
Write-Host "model=$slug ratio=$ratio"

ห้ามเดา ratio

ดู โมเดล และ หลักการ

3. สร้างงานรูปภาพ (form body)

curl

curl.exe -X POST "https://v2.api.gommo.net/ai/jobs/image/MODEL_SLUG" ^
  -H "Authorization: Bearer %TOKEN%" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "domain=%REGISTRATION_DOMAIN%&prompt=A cute cat, studio photo&ratio=RATIO_FROM_MODELS"

PowerShell

$domain = $env:GOMMO_API_DOMAIN; if (-not $domain) { throw 'Set GOMMO_API_DOMAIN to the user registration domain (dealer)' }
$body = "domain=$domain&prompt=A cute cat, studio photo&ratio=$ratio"
$job = Invoke-RestMethod -Method POST `
  -Uri "https://v2.api.gommo.net/ai/jobs/image/$slug" `
  -Headers @{ Authorization = "Bearer $env:TOKEN" } `
  -ContentType "application/x-www-form-urlencoded" `
  -Body $body

4. Poll จนเสร็จ

POST https://v2.api.gommo.net/ai/jobs/{id_base}?media=image ทุก 3.5 วินาที สูงสุด 80 ครั้ง — ดู วงจร request และ Cookbook: งาน async + poll

Self-host (ทางเลือก)

Operator ที่ deploy repo — ดู Deploy → Self-host ขั้นสูง ไม่จำเป็นสำหรับการเชื่อมต่อ Gommo

สคริปต์

• scripts/test-image-job.ps1 — smoke test Gommo public API
• scripts/test-gateway.ps1 — operator เท่านั้น (self-host REST/proxy) ดู Deploy → Self-host ขั้นสูง

ถัดไป

• วงจร request — create → poll → ผลลัพธ์
• อ่านแคตตาล็อก — parse ratio / mode จาก POST /ai/models
• OpenAPI · TypeScript SDK
• แอปฟีด home
• Gommo public API
• หลักการ
• การยืนยันตัวตน
• อ้างอิงมีเดีย