Fetch a clip an alignment made
GET /v1/jobs/{id}/files/{name}
Clips exist only for alignments made with clips set to true, once the
job is done. Their names are given in the result, one per section. Clips
are kept for 7 days after the job finishes (a day with a test key); then
this returns 404 with
the code api_file_expired.
Authentication
Send Authorization: Bearer $KEY from your server. Create or rotate keys.
Example request
bash
curl https://play.fellowverse.app/v1/jobs/job_Hk3vQ9xTmP2a/files/1.mp3 \
-H "Authorization: Bearer $KEY" --output verse-1.mp3
Example IDs are placeholders. Use the upload or job ID returned by your own request.
Parameters
| Name | In | Required | Type | Description and constraints |
|---|---|---|---|---|
id |
path | Yes | string | The job id returned when the alignment was started. |
name |
path | Yes | string | The clip's name from the job result, such as 1.mp3. Pattern: ^\d{1,5}\.mp3$. |
Responses
| Status | Meaning |
|---|---|
| 200 | The clip, as MP3. |
| 400 | The request could not be used. invalid_request when a field is missing or has the wrong type; bad_request when the audio or a value could not be read. |
| 401 | The key is missing, wrong, revoked, or past the end of its grace period after a roll. The code is api_unauthorized, and the reason says which. |
| 403 | The account is suspended (api_suspended), or a live key was used on an account that has test keys only (api_live_locked). |
| 404 | The upload, job or clip does not exist, or belongs to another account. The codes are api_upload_missing, api_job_missing and api_file_missing. api_off means the request went to an address that does not serve the API; use https://play.fellowverse.app. |
| 500 | Something went wrong on our side. The code is internal. |
200: audio/mpeg
The response body is the MP3 clip. Save or stream it from your backend.
Errors and limits
JSON errors contain error.code, error.problem, error.reason and error.fix. Handle errors and retries and check test and live limits.
Need the contract? Download OpenAPI. Manage keys and account access in the developer console.