Skip to main content
POST
Finalize a prepared model after uploading its images
Schritt zwei des Presigned-Upload-Flows. Nachdem du jede Datei per PUT zu den URLs aus POST /models/prepare hochgeladen hast, rufe diesen Endpoint mit den uploaded_keys auf (die R2-Keys, die du hochgeladen hast, in Reihenfolge — erster = Cover). Samsa validiert die Keys und startet die Verarbeitung und gibt 202 Accepted zurück. Frage GET /models/{id}/status ab, bis completed. Erfordert den models.write Scope.
Übergib hier einen webhook_url, um benachrichtigt zu werden, wenn das Modell einen finalen Status erreicht, statt abzufragen. Siehe Webhooks.

Autorisierungen

Authorization
string
header
erforderlich

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

Pfadparameter

model_id
string<uuid>
erforderlich

Body

application/json

POST /models/{id}/complete body — finalize after uploading to presigned URLs.

uploaded_keys
string[]
erforderlich

The R2 keys you uploaded, in order (first = cover).

Required array length: 1 - 10 elements
webhook_url
string | null

Optional https webhook notified once on terminal status (signed per the webhook signature scheme; see the webhooks docs).

Beispiel:

"https://example.com/webhooks/samsa"

Antwort

Successful Response

202 body for POST /models and POST /models/{id}/complete (ADR §7.1).

id
string<uuid>
erforderlich

The created model's id — poll GET /models/{id}/status.

status
enum<string>
erforderlich

Initial status: pending (create) or processing (complete).

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

"pending"

estimated_credits
integer
erforderlich

Credits the finished job will cost (model creation is free = 0).

Beispiel:

0