Vai al contenuto principale
GET
List the available image engines
Restituisce gli engine text-to-image disponibili per la tua organizzazione, con l’engine predefinito per primo. Ogni voce elenca i suoi aspect_ratios, le resolutions (con default_aspect_ratio e default_resolution), max_num_outputs, i credits_per_image per ogni risoluzione, e se accetta modelli addestrati (supports_trained_refs) e una palette di colori (supports_color_palette). L’endpoint è gratuito e richiede lo scope images.generate. Leggi questo endpoint prima di chiamare POST /images/generations e passa l’id di una voce come engine — un engine, un rapporto d’aspetto o una risoluzione fuori dall’elenco restituisce 422 prima che vengano addebitati credits. Una richiesta costa credits_per_image alla risoluzione scelta × num_outputs.
Se la tua organizzazione genera solo con i suoi modelli addestrati, data è vuoto e unavailable_reason è organization_restricted. Ometti engine e passa almeno un modello addestrato (style_id, object_ids, person_ids, setting_ids) o un color_palette_id — vedi Generazione di immagini. Per tutti gli altri chiamanti, unavailable_reason è null.

Autorizzazioni

Authorization
string
header
obbligatorio

Organization API key (Authorization: Bearer samsa_sk_...) or OAuth 2.1 access token (Authorization: Bearer samsa_at_...).

Risposta

Successful Response

GET /images/models response — the public text-to-image engine catalog.

data
PublicImageEngine · object[]
obbligatorio
unavailable_reason
string | null

organization_restricted when your organization generates only with its trained models (data is then empty: omit engine and pass trained models); null otherwise.

Allowed value: "organization_restricted"