Library
Get an upload
GET
https://api.tunio.ai/ v1/ library/ uploads/ {upload_id}Get the state of a library upload. Once completed, track_id (music) or jingle_id (jingle) is the new item of the caller's library.
路径参数
| 名称 | 类型 | 说明 |
|---|---|---|
| upload_idRequired | string | Upload ID |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| success | boolean | Always true. |
| upload | object | The upload. |
| completed_at | string | When it completed or failed. |
| created_at | string | When the upload was accepted. |
| duration | integer | Length in seconds, set once completed. |
| error | string | Machine-readable failure code, set only when state is failed: url_not_allowed, download_failed, file_too_large, not_audio (not an audio file of a supported format), duration_out_of_range, storage_limit_exceeded, processing_failed or processing_timeout. |
| file_name | string | Name of the sent file, or the last segment of the link. |
| jingle_id | string | Jingle: the jingle in the caller's library, set once completed; add it to a bundle with POST /v1/jingle-bundles/{bundle_id}/items. |
| kind | string | music or jingle. |
| size_bytes | integer | Size of the source file in bytes, known once it is downloaded. |
| source | string | file (sent in the request) or url (downloaded from a link). |
| source_url | string | The link the file is downloaded from; null for file uploads. |
| state | string | pending (waiting for a worker), downloading, processing (checking and converting), completed or failed. |
| title | string | Title given in the request, null when none was. |
| track_id | string | Music: the track in the caller's library, set once completed; add it to a static playlist with POST /v1/playlists/{playlist_id}/items. |
| upload_id | string | Upload ID; poll GET /v1/library/uploads/{upload_id} with it. |
| 名称 | 类型 | 说明 |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |
| 名称 | 类型 | 说明 |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |
| 名称 | 类型 | 说明 |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |
| 名称 | 类型 | 说明 |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |