Vòng đời request (job media)

Job ảnh, video, nhạc, tool trên https://v2.api.gommo.net là bất đồng bộ. Create thành công trả id ngay; app của bạn poll đến khi có URL kết quả hoặc hết số lần thử.

Cùng flow với Quickstart bước 3 — gom lại một chỗ.

Mặc định Tier A

Poll trên public API. Webhook job trong UI Observability của repo này chỉ là preview gateway self-host — không phải contract integrator Gommo public. Xem roadmap nền tảng Gommo.

Luồng

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 Mỗi 3.5s, tối đa 80
    App->>V2: POST /ai/jobs/{id}?media=...
    V2-->>App: đang chờ hoặc result_url
  end

Bước	Việc cần làm
1	`POST /ai/models?type=…` — đọc slug, ratio, mode, … từ catalog
2	`POST /ai/jobs/{type}/{model_id}` — form có `domain`, `prompt`, field catalog
3	Lưu `id_base` từ response create
4	`POST /ai/jobs/{id_base}?media={image\|video\|music}` — lặp đến trạng thái cuối
5	Tải hoặc lưu `result_url` / `file_url` từ JSON poll

media khi poll phải khớp loại job (image, video, music).

Thời gian (mặc định trong docs)

Tham số	Giá trị
Khoảng cách	3500 ms giữa các lần poll
Số lần tối đa	80 (~4.7 phút)
Auth poll	Bearer và/hoặc `access_token` + `domain` trong form (cùng domain đăng ký như create)

Self-host gateway có wait: true trên POST /gateway/jobs/* — Mode B, không bắt buộc Tier A. Deploy → Self-host nâng cao.

Khi nào job “xong”?

Thành công khi poll có URL kết quả, ví dụ imageInfo.result_url / resultUrl (ảnh); video/nhạc — shape khác theo type.

Kiểm tra success và chuỗi status trong JSON upstream. Log một response poll đầy đủ khi tích hợp.

Thất bại khi JSON báo lỗi/moderation, hoặc sau 80 lần không có result URL (timeout phía app).

Chi tiết field: Media & jobs.

Lấy job id từ create

id_base có thể nằm trong imageInfo, data, hoặc top level.

Poll tối thiểu

Cookbook: Job async + poll. TypeScript: createAndWait trên @ai-gateway/client. Image job (wait) dùng wait trong Playground; production dùng loop hoặc SDK.

Credit

Job thành công trừ credit user Gommo. POST https://api.gommo.net/ai/me — Authentication.

Lỗi thường gặp

Lỗi	Cách sửa
`domain` sai	Cùng domain đăng ký — Authentication
Đoán ratio / mode	Chỉ từ `POST /ai/models`
`media` poll sai	`image` vs `video` vs `music`
Không poll sau create	Server không có kết quả nếu không `wait` / loop
Token trên browser/mobile	API credentials — chỉ server

Vòng đời request (job media) ​

Luồng ​

Thời gian (mặc định trong docs) ​

Khi nào job “xong”? ​

Lấy job id từ create ​

Poll tối thiểu ​

Credit ​

Lỗi thường gặp ​

Tiếp theo ​