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"