Lỗi thường gặp (integrator)
Tham chiếu nhanh khi tích hợp v2.api.gommo.net + api.gommo.net. Gommo thường trả JSON success, error, message — đôi khi HTTP 200 với error: 1. Luôn parse body, không chỉ status.
Liên quan: Vòng đời request · Authentication · Media & jobs
Triệu chứng → nguyên nhân → sửa
| Triệu chứng | Nguyên nhân | Cách xử lý |
|---|---|---|
| 401 / unauthorized / token invalid | Thiếu Bearer, token hết hạn | Login lại POST …/auth/login; lưu token trên server |
Login OK nhưng credit / ai/me sai | domain ≠ domain đăng ký user | domain từ luồng signup — Domain đăng ký |
| Create job bị từ chối | Đoán ratio, mode, … | POST /ai/models?type=… trước; chỉ dùng giá trị catalog |
Create OK, poll không có result_url | Không poll, media sai, job còn chạy | Vòng đời — 3.5s, max 80; log một JSON poll |
| Poll báo lỗi trong JSON | Moderation, lỗi model, hủy | Đọc message; không retry payload giống hệt |
| Timeout sau 80 lần (~5 phút) | Video nặng / upstream chậm | Báo user; có thể tạo job mới; xem usage-history nếu cần |
| 402 / không đủ credit | User hết credit | POST https://api.gommo.net/ai/me; user nạp trên site dealer |
HTTP 200 + { "error": 1, "message": "…" } | Hay gặp trên route platform | Coi error !== 0 hoặc success: false là lỗi |
| Playground OK, app lỗi | Thiếu domain, gọi sai host | Tier A: host public; khớp tab URL public Playground |
Poll timeout không phải lỗi upstream
Sau 80 lần không có result_url là timeout phía client. Public API không webhook job — Webhooks.
Chỉ self-host gateway (Mode B/C)
{gateway}/gateway/* trả envelope success: false, code, message — khác một số response Gommo thô.
| Tài liệu | Khi nào |
|---|---|
| Deploy → Gateway error responses | UNAUTHORIZED, VALIDATION_ERROR, … |
doc/GATEWAY-ERRORS.md (repo) | Maintainer |
| SDK errors | Client TS gateway (tùy chọn) |
Tier A production không nên phụ thuộc mã lỗi gateway trừ khi chủ đích self-host.