วงจร request (งานมีเดีย)

งาน ภาพ วิดีโอ เพลง เครื่องมือ บน https://v2.api.gommo.net เป็น แบบ async Create สำเร็จได้ id ทันที แอปของคุณ poll จนได้ URL ผลลัพธ์หรือครบจำนวนครั้ง

flow เดียวกับ Quickstart ขั้นที่ 3 — รวมไว้ที่นี่

ค่าเริ่มต้น Tier A

Poll บน public API Webhook งาน ใน UI Observability ของ repo นี้เป็น preview gateway self-host เท่านั้น — ไม่ใช่สัญญา integrator Gommo public ดู roadmap แพลตฟอร์ม Gommo

ลำดับ

mermaid

sequenceDiagram
  participant App
  participant V2 as v2.api.gommo.net
  App->>V2: POST /ai/jobs/{type}/{model}
  V2-->>App: job id (id_base)
  loop ทุก 3.5s สูงสุด 80
    App->>V2: POST /ai/jobs/{id}?media=...
    V2-->>App: รอหรือ result_url
  end

ขั้น	สิ่งที่ทำ
1	`POST /ai/models?type=…` — อ่าน slug, ratio, mode จากแคตตาล็อก
2	`POST /ai/jobs/{type}/{model_id}` — form มี `domain`, `prompt`, ฟิลด์แคตตาล็อก
3	เก็บ `id_base` จาก create
4	`POST /ai/jobs/{id_base}?media={image\|video\|music}` — ทำซ้ำจน จบ
5	ดาวน์โหลดหรือเก็บ `result_url` / `file_url`

media ตอน poll ต้องตรงประเภทงาน

จังหวะเวลา (ค่าเริ่มต้นในเอกสาร)

พารามิเตอร์	ค่า
ช่วงห่าง	3500 ms ระหว่าง poll
ครั้งสูงสุด	80 (~4.7 นาที)
Auth poll	Bearer และ/หรือ `access_token` + `domain` ใน form (domain ลงทะเบียนเดียวกับ create)

Gateway self-host มี wait: true บน POST /gateway/jobs/* — Mode B ไม่บังคับ Tier A Deploy → Self-host ขั้นสูง

เมื่อไหร่ถือว่า “เสร็จ”?

สำเร็จ เมื่อ poll มี URL ผลลัพธ์ เช่น imageInfo.result_url / resultUrl

ตรวจ success และ status ใน JSON upstream

ล้มเหลว เมื่อ JSON บอก error/moderation หรือครบ 80 ครั้งไม่มี result URL

รายละเอียดฟิลด์: Media & jobs

Poll ขั้นต่ำ

Cookbook: งาน async + poll TypeScript: createAndWait · Image job (wait)

เครดิต

งานสำเร็จใช้ เครดิต user Gommo POST https://api.gommo.net/ai/me — การยืนยันตัวตน

ข้อผิดพลาดที่พบบ่อย

ผิด	แก้
`domain` ผิด	domain ลงทะเบียนเดียวกัน — การยืนยันตัวตน
เดา ratio / mode	จาก `POST /ai/models` เท่านั้น
`media` poll ผิด	`image` vs `video` vs `music`
ไม่ poll หลัง create	ไม่มีผลบนเซิร์ฟเวอร์ถ้าไม่ `wait` / loop
Token ใน browser/mobile	API credentials — เฉพาะ server

วงจร request (งานมีเดีย) ​

ลำดับ ​

จังหวะเวลา (ค่าเริ่มต้นในเอกสาร) ​

เมื่อไหร่ถือว่า “เสร็จ”? ​

Poll ขั้นต่ำ ​

เครดิต ​

ข้อผิดพลาดที่พบบ่อย ​

ถัดไป ​