Zum Hauptinhalt springen
GET
List the available image engines
Gibt die Text-to-Image-Engines zurück, die deiner Organisation zur Verfügung stehen, die Standard-Engine zuerst. Jeder Eintrag listet seine aspect_ratios, resolutions (mit default_aspect_ratio und default_resolution), max_num_outputs, credits_per_image pro Auflösung sowie, ob er trainierte Modelle (supports_trained_refs) und eine Farbpalette (supports_color_palette) akzeptiert. Der Endpoint ist kostenlos und braucht den Scope images.generate. Lies diesen Endpoint, bevor du POST /images/generations aufrufst, und übergib die id eines Eintrags als engine — eine Engine, ein Seitenverhältnis oder eine Auflösung außerhalb der Liste liefert 422, bevor Credits berechnet werden. Eine Anfrage kostet credits_per_image bei der gewählten Auflösung × num_outputs.
Generiert deine Organisation nur mit ihren trainierten Modellen, ist data leer und unavailable_reason ist organization_restricted. Lass engine weg und übergib mindestens ein trainiertes Modell (style_id, object_ids, person_ids, setting_ids) oder eine color_palette_id — siehe Bildgenerierung. Für alle anderen Aufrufer ist unavailable_reason gleich null.

Autorisierungen

Authorization
string
header
erforderlich

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

Antwort

Successful Response

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

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