Request presigned upload URLs for a new model's images
Addestramento di modelli
Prepara l'upload di un modello
Richiedi presigned PUT URL per le immagini di riferimento di un nuovo modello (upload in due passaggi).
POST
Request presigned upload URLs for a new model's images
Passo uno del flusso di upload con presigned URL per file di grandi dimensioni. Invia il
name del modello,
la category e i metadati per gli 1–10 files che caricherai (il primo file è
la copertina). La risposta restituisce un id del modello e un presigned PUT upload_url per
file. Esegui PUT di ogni file al suo URL, quindi chiama
POST /models/{id}/complete con le
chiavi caricate per avviare l’elaborazione. Richiede lo scope models.write.
Usa questo flusso in due passaggi quando le immagini sono troppo grandi per essere inviate inline. Per immagini piccole
o URL remoti,
POST /models è più semplice.
Il content_type di ogni file è uno tra image/jpeg, image/png, image/webp;
fornisci size (≤ 10 MB) quando lo conosci.Autorizzazioni
Organization API key as a bearer token: Authorization: Bearer samsa_sk_....
Corpo
application/json
POST /models/prepare body — request presigned PUT URLs for large files.
Required string length:
1 - 100Esempio:
"Acme Brand Style"
Model category — one of style, object, person, setting.
Opzioni disponibili:
style, object, person, setting Esempio:
"style"
Metadata for the 1-10 files you will upload (first = cover).
Required array length:
1 - 10 elementsOptional free-text guidance for how to use the model.
Maximum string length:
8000
