OpenAPI

Tải hoặc xem OpenAPI 3.0 cho Gommo public API (v2.api.gommo.net + api.gommo.net). Cùng file còn liệt kê endpoint Gommo Developer dev tùy chọn cho operator (billing, admin, Mode B REST).

Job media async (Tier A)

Tag Gommo V2: POST /ai/models → POST /ai/jobs/{type}/{modelSlug} → poll POST /ai/jobs/{id} (3.5s, max 80). Không webhook job trên public API — Vòng đời request.

Đọc catalog: Đọc catalog · SDK: /vi/sdk/

File spec

Dev	Production
http://localhost:5173/openapi.yaml	https://docs.yourdomain.com/openapi.yaml

Server mặc định (Swagger)

Server	Mô tả
https://v2.api.gommo.net	Jobs, models, upload, album library
https://api.gommo.net	Auth, chat, audio, info, library list

Mỗi operation có servers khi chỉ áp dụng một host. Xem Gommo public API.

Nhóm path Gommo public

Tag	Host	Ví dụ
Gommo V2	v2.api.gommo.net	/vi/ai/models, /vi/ai/jobs/{type}/{model}, /vi/ai/library/album-images
Gommo Platform	api.gommo.net	/vi/ai/me, /vi/api/v2/chat, /vi/ai/info/image/{id}

Self-host only (operator)

Các tag này khi chạy repo local (localhost:3001) — không phải contract tích hợp mặc định:

Tag	Server	Ví dụ
Gateway Dev	localhost:3001	/gateway/jobs/{type}, /gateway/models
Billing	localhost:3001	/vi/billing/payment/*
Admin	localhost:3001	/vi/admin/*

→ Deploy → Self-host nâng cao

Auth trong spec

Scheme	Dùng cho
bearerAuth	Path Gommo public, /gateway/*, billing
adminKey (x-admin-key)	/vi/admin/*

Tài liệu đọc thêm

→ Gommo public API · Media & jobs · Authentication

Tiếp theo

→ Endpoint map · Integration modes