Idempotency
Retry safely: the same Idempotency-Key never creates a second job or a second charge.
Creation, corrections and regenerations require an Idempotency-Key header (1–255 printable characters). Reuse the same key and the same body for every retry of one operation.
- Same key, same body: the original 202 answer (same narration_id and job_id), with Idempotent-Replayed: true - even if the first response was lost or the job has since failed.
- Same key, another body: 409 idempotency_conflict.
- 409 idempotency_in_progress: an identical request is still being accepted - wait Retry-After and resend the same request.
- A request refused before acceptance (400/422) creates nothing; its key can be used again.
- Keys are kept for at least 7 days, and never before their job ended.
cURL
curl -s -i -X POST "https://kolimina.com/api/public/v1/narrations" \
-H "Authorization: Bearer $KOLIMINA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-1001-narration" \
-d '{"voice_id": "voice_…", "text": "שלום."}'