Passer au contenu principal
GET
List the available image engines
Renvoie les moteurs text-to-image disponibles pour ton organisation, le moteur par défaut en premier. Chaque entrée liste ses aspect_ratios, ses resolutions (avec default_aspect_ratio et default_resolution), max_num_outputs, credits_per_image pour chaque résolution, et indique s’il accepte des modèles entraînés (supports_trained_refs) et une palette de couleurs (supports_color_palette). L’endpoint est gratuit et nécessite le scope images.generate. Lis cet endpoint avant d’appeler POST /images/generations et passe l’id d’une entrée comme engine — un moteur, un ratio ou une résolution hors de la liste renvoie 422 avant qu’aucun credit ne soit facturé. Une requête coûte credits_per_image à la résolution choisie × num_outputs.
Si ton organisation génère uniquement avec ses modèles entraînés, data est vide et unavailable_reason vaut organization_restricted. Omets engine et passe au moins un modèle entraîné (style_id, object_ids, person_ids, setting_ids) ou un color_palette_id — voir Génération d’images. Pour tous les autres appelants, unavailable_reason vaut null.

Autorisations

Authorization
string
header
requis

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

Réponse

Successful Response

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

data
PublicImageEngine · object[]
requis
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"