Skip to main content
GET
Retrieve a resize job's status and results
Rufe den Status eines Resize-Jobs ab. Solange er pending oder processing ist, frage weiter ab; sobald completed, enthält die Antwort die erzeugten images, jedes mit einer presigned url, 24 Stunden gültig. Nur Jobs, die deine Organisation erstellt hat, sind sichtbar; jede andere id liefert 404 not_found. Erfordert den images.transform-Scope.

Beispiel: abgeschlossener Job

200 OK
Übergib eine webhook_url bei der ursprünglichen Resize-Anfrage, um statt Polling einen signierten Callback zu erhalten. Siehe Webhooks.

Autorisierungen

Authorization
string
header
erforderlich

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

Pfadparameter

resize_id
string<uuid>
erforderlich

Antwort

Successful Response

GET /images/resizes/{id} body — same contract as image generation.

Backed by image_generation_tasks like the other image jobs; a distinct component name for the docs.

id
string<uuid>
erforderlich
status
enum<string>
erforderlich

pending, processing, completed, failed, or cancelled.

Verfügbare Optionen:
pending,
processing,
completed,
failed,
cancelled
Beispiel:

"completed"

created_at
string<date-time>
erforderlich

When the job was submitted.

credits_used
integer | null

Net credits charged for this job, after any refunds.

Beispiel:

5

images
PublicImageAsset · object[]

Produced images (presigned URLs); empty until completed.

error
string | null

Failure detail when status is failed; otherwise null.