Passer au contenu principal
POST
Finish an image upload (verify the file, get a usable image_id)
Troisième étape du téléversement d’image, après le PUT vers l’upload_url issue de POST /images/uploads/prepare. Appelle-le dans l’heure. Samsa vérifie le fichier — présent, exactement size_bytes, au plus 10 Mo, une image lisible du content_type préparé, au plus 32 mégapixels — et renvoie 200 OK avec l’image_id, status: "completed", et la width et la height mesurées. À partir de là, utilise l’image_id comme source d’une édition, d’une opération d’image ou d’une génération image-to-video.
Complete est idempotent : le rappeler renvoie le même résultat. Un fichier qui échoue à une vérification renvoie 422 et est supprimé — fais un PUT d’un fichier valide vers la même upload_url tant qu’elle est valide et rappelle complete. 409 upload_in_progress signifie qu’un autre appel complete est en cours : réessaie dans quelques secondes. Requiert l’un des scopes images.edit, images.transform ou videos.generate. Gratuit.

Autorisations

Authorization
string
header
requis

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

Paramètres de chemin

image_id
string<uuid>
requis

Réponse

Successful Response

200 body for POST /images/uploads/{image_id}/complete — the usable image.

image_id
string<uuid>
requis

Use as the source image_id in edits, img2img, variations, resizes, upscales, background removals, vectorizations and image-to-video generations.

status
string
requis

Always completed: the file is verified and the image can be used now. Thumbnails are built in the background.

Allowed value: "completed"
filename
string
requis

The filename given at prepare.

content_type
string
requis

The verified MIME type of the bytes.

size_bytes
integer
requis

Size of the uploaded file in bytes.

width
integer
requis

Width in pixels, measured from the bytes.

height
integer
requis

Height in pixels, measured from the bytes.