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

Downloading the master and every sentence

Read a revision's manifest and download the master file and each sentence, or hand out a temporary link.

GET /narrations/{narration_id}/revisions/{revision} lists the master and every sentence with its timing (start_ms, end_ms, gap_after_ms) and download_path. Downloads support Range and an ETag; files of a revision never change.

cURL
curl -s "https://kolimina.com/api/public/v1/narrations/nar_…/revisions/1" \
  -H "Authorization: Bearer $KOLIMINA_API_KEY"
cURL
curl -s -o master.mp3 "https://kolimina.com/api/public/v1/narrations/nar_…/revisions/1/audio" \
  -H "Authorization: Bearer $KOLIMINA_API_KEY"
cURL
curl -s -o s1.mp3 "https://kolimina.com/api/public/v1/narrations/nar_…/revisions/1/sentences/sent_…/audio" \
  -H "Authorization: Bearer $KOLIMINA_API_KEY"

Temporary links (no key)

POST /assets/{asset_id}/download-links returns a URL that works without a key until url_expires_at (15 minutes by default) - for a player or a delivery to a third party. It stops at once if the narration is deleted or the file expires. url_expires_at is the link's expiry, not the file's retention.

cURL
curl -s -X POST "https://kolimina.com/api/public/v1/assets/asset_…/download-links" \
  -H "Authorization: Bearer $KOLIMINA_API_KEY"