Skip to main content
Crea un modello personalizzato in una di quattro categorie — style, object, person o setting — a partire da 1–10 immagini di riferimento. Una volta completed, il modello può essere composto nella generazione di immagini, in Magic Edit e nei video con stile.

​
Due modi per inviare le immagini di riferimento

  • Inline — POST /models con ogni immagine come url https oppure base64 inline + mime_type. Il modo più semplice per immagini piccole e URL remoti.
  • Upload con presigned URL — per file di grandi dimensioni, chiama POST /models/prepare per ottenere presigned PUT URL, esegui PUT di ogni file, quindi chiama POST /models/{id}/complete per avviare l’elaborazione.
Entrambi i percorsi richiedono lo scope models.write.

​
Istruzione sempre applicata

Ogni modello porta una instruction facoltativa — una guida sempre applicata (max. 8000 caratteri). A differenza di un prompt per singola richiesta, viene iniettata come direttiva obbligatoria (“MUST FOLLOW”) in ogni generazione di immagini e video che compone il modello, così le regole di brand (“sempre uno sfondo bianco uniforme”) valgono senza ripeterle a ogni chiamata. È distinta dal default_prompt del modello — una descrizione delle capacità generata dall’IA che viene anch’essa aggiunta alla generazione. Impostala alla creazione e modificala in qualsiasi momento con PATCH /models/{id}; in lettura viene restituita come user_instruction.

​
Pattern asincrono

La creazione restituisce 202 Accepted con un id del modello; interroga GET /models/{id}/status finché status non è completed (o failed). Un webhook_url ti fornisce una callback push — vedi Webhook. La creazione di un modello è gratuita — il suo estimated_credits è 0 — ma richiede comunque un abbonamento dell’organizzazione attivo; un’organizzazione senza un abbonamento utilizzabile restituisce 402. Vedi Prezzi.