Finaliser un upload de modèle
Finalise un modèle préparé après avoir uploadé ses images vers les presigned URLs.
PUT vers les URLs de
POST /models/prepare, appelle ce endpoint
avec les uploaded_keys (les clés R2 que tu as uploadées, dans l’ordre — la première = couverture). Samsa
valide les clés et lance le traitement, en renvoyant 202 Accepted. Interroge
GET /models/{id}/status jusqu’à completed.
Nécessite le scope models.write.
webhook_url ici pour être notifié quand le modèle atteint un statut terminal
au lieu d’interroger. Voir Webhooks.Autorisations
Organization API key as a bearer token: Authorization: Bearer samsa_sk_....
Paramètres de chemin
Corps
POST /models/{id}/complete body — finalize after uploading to presigned URLs.
The R2 keys you uploaded, in order (first = cover).
1 - 10 elementsOptional https webhook notified once on terminal status (signed per the webhook signature scheme; see the webhooks docs).
"https://example.com/webhooks/samsa"
Réponse
Successful Response
202 body for POST /models and POST /models/{id}/complete (ADR §7.1).
The created model's id — poll GET /models/{id}/status.
Initial status: pending (create) or processing (complete).
pending, processing, completed, failed "pending"
Credits the finished job will cost (model creation is free = 0).
0

