דלג לתוכן הראשי
Kolimina - עברית שנשמעת נכון

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": "שלום."}'