Skip to main content
GET
Retrieve one of your models
Renvoie le détail complet d’un seul modèle appartenant à ton organisation, y compris les presigned URLs des images de référence, le prompt par défaut, les trigger words et le user_instruction du modèle. Ce user_instruction est la guidance toujours appliquée du modèle : il est injecté comme directive obligatoire (“MUST FOLLOW”) dans chaque génération d’image et de vidéo qui compose le modèle — ce ne sont pas des métadonnées passives. Il contraste avec le default_prompt, une description de capacités générée par IA qui est elle aussi ajoutée à la génération. Définis-le ou modifie-le via PATCH /models/{model_id}. Les ids inconnus, appartenant à une autre organisation ou supprimés renvoient 404 not_found. Nécessite le scope models.read.

Autorisations

Authorization
string
header
requis

Organization API key as a bearer token: Authorization: Bearer samsa_sk_....

Paramètres de chemin

model_id
string<uuid>
requis

Réponse

Successful Response

A single model with full detail — the GET /models/{id} body (ADR §10).

id
string<uuid>
requis
name
string
requis
Exemple:

"Acme Brand Style"

status
enum<string>
requis

Creation status: pending, processing, completed, or failed.

Options disponibles:
pending,
processing,
completed,
failed
Exemple:

"completed"

is_ready
boolean
requis

True when the model is completed AND active — usable for generation.

Exemple:

true

created_at
string<date-time>
requis
updated_at
string<date-time>
requis
category
enum<string> | null

Model category — one of style, object, person, setting.

Options disponibles:
style,
object,
person,
setting
Exemple:

"style"

thumbnail_url
string | null

Presigned, time-limited HTTPS thumbnail URL (null when the model has none).

Exemple:

"https://cdn.samsa.ai/models/…/thumbnail.webp?X-Amz-Signature=…"

reference_image_urls
string[]

Presigned, time-limited HTTPS URLs of the reference images used to create the model.

Exemple:
user_instruction
string | null

Free-text guidance for how to use the model.

Exemple:

"Use for hero banners and social posts."

default_prompt
string | null

The model's default prompt / capability description.

Exemple:

"A bold flat-design illustration in the Acme brand palette."

trigger_words
string[]

Trigger words associated with the model.

Exemple: