Zum Hauptinhalt springen
POST
Finish an image upload (verify the file, get a usable image_id)
Schritt drei des Bild-Uploads, nach dem PUT an die upload_url aus POST /images/uploads/prepare. Rufe ihn innerhalb einer Stunde auf. Samsa prüft die Datei — vorhanden, exakt size_bytes, höchstens 10 MB, ein lesbares Bild des vorbereiteten content_type, höchstens 32 Megapixel — und gibt 200 OK mit der image_id, status: "completed" und der gemessenen width und height zurück. Ab dann nutzt du die image_id als Quelle eines Edits, einer Bildoperation oder einer Image-to-Video-Generierung.
Complete ist idempotent: Ein erneuter Aufruf gibt dasselbe Ergebnis zurück. Eine Datei, die eine Prüfung nicht besteht, liefert 422 und wird verworfen — PUT eine gültige Datei an dieselbe upload_url, solange sie gültig ist, und rufe complete erneut auf. 409 upload_in_progress heißt, dass gerade ein anderer complete-Aufruf läuft: Wiederhole in ein paar Sekunden. Erfordert einen der Scopes images.edit, images.transform oder videos.generate. Kostenlos.

Autorisierungen

Authorization
string
header
erforderlich

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

Pfadparameter

image_id
string<uuid>
erforderlich

Antwort

Successful Response

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

image_id
string<uuid>
erforderlich

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

status
string
erforderlich

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

Allowed value: "completed"
filename
string
erforderlich

The filename given at prepare.

content_type
string
erforderlich

The verified MIME type of the bytes.

size_bytes
integer
erforderlich

Size of the uploaded file in bytes.

width
integer
erforderlich

Width in pixels, measured from the bytes.

height
integer
erforderlich

Height in pixels, measured from the bytes.