Files
Upload inputs and download outputs.
Create an upload
https://api.34.181.188.80.sslip.io/v2/filesRegisters a file and returns an upload URL. Send the bytes with PUT to upload.url (with upload.headers), then call POST /v2/files/{id}/complete. Large files can be sent in chunks with Content-Range.
Supports the Idempotency-Key header: retrying with the same key returns the original result.
Headers
Idempotency-KeystringRetrying with the same key returns the original job instead of creating a new one (8–100 chars).
Request body application/json
mimestringrequiredMIME type of the file (e.g.
audio/mpeg,video/mp4,image/png)bytesintegerrequiredExact file size in bytes
namestringpurposestring
Responses
201Success
fileobjectrequiredShowHide child attributes
idstringrequiredobjectstringrequiredkindstringrequiredstatusstringrequirednamestring | nullrequiredmimestringrequiredbytesintegerrequiredduration_msinteger | nullrequiredwidthinteger | nullrequiredheightinteger | nullrequiredsourcestringrequiredjob_idstring | nullrequiredcreated_atstringrequiredexpires_atstring | nullrequireddownload_urlstring | nullrequiredSigned URL valid for 15 minutes; null unless the file is ready
download_expires_atstring | nullrequired
uploadobjectrequiredShowHide child attributes
urlstringrequiredmethodstringrequiredheadersmaprequiredresumablebooleanrequiredchunk_bytesinteger | nullrequiredexpires_atstringrequired
4XXClient errorerror object
errorobjectrequiredShowHide child attributes
codestringrequiredStable machine-readable error code
messagestringrequireddetailsmaprequiredrequest_idstring | nullrequiredQuote this when contacting support
5XXServer errorerror object
errorobjectrequiredShowHide child attributes
codestringrequiredStable machine-readable error code
messagestringrequireddetailsmaprequiredrequest_idstring | nullrequiredQuote this when contacting support
curl -X POST https://api.34.181.188.80.sslip.io/v2/files \
-H "Authorization: Bearer $VOISER_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: a8f5f167-0e4c-4bde-9b6e-1c2d3e4f5a6b' \
-d '{
"mime": "audio/mpeg",
"bytes": 482133
}'const res = await fetch("https://api.34.181.188.80.sslip.io/v2/files", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.VOISER_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": "a8f5f167-0e4c-4bde-9b6e-1c2d3e4f5a6b",
},
body: JSON.stringify({
"mime": "audio/mpeg",
"bytes": 482133
}),
});
const data = await res.json();
console.log(data);import os
import requests
response = requests.post(
"https://api.34.181.188.80.sslip.io/v2/files",
headers={
"Authorization": f"Bearer {os.environ['VOISER_API_KEY']}",
"Idempotency-Key": "a8f5f167-0e4c-4bde-9b6e-1c2d3e4f5a6b",
},
json={
"mime": "audio/mpeg",
"bytes": 482133,
},
)
print(response.json())<?php
$ch = curl_init('https://api.34.181.188.80.sslip.io/v2/files');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('VOISER_API_KEY'),
'Content-Type: application/json',
'Idempotency-Key: a8f5f167-0e4c-4bde-9b6e-1c2d3e4f5a6b',
],
CURLOPT_POSTFIELDS => json_encode([
'mime' => 'audio/mpeg',
'bytes' => 482133,
]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);{
"file": {
"id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"object": "file",
"kind": "audio",
"status": "pending",
"name": "Example",
"mime": "audio/mpeg",
"bytes": 482133,
"duration_ms": 14350,
"width": 1,
"height": 1,
"source": "upload",
"job_id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"created_at": "2026-11-17T10:24:31.000Z",
"expires_at": "2026-11-17T10:24:31.000Z",
"download_url": "https://files.example.com/output.mp3?expires=1763375071&signature=…",
"download_expires_at": null
},
"upload": {
"url": "https://files.example.com/output.mp3?expires=1763375071&signature=…",
"method": "PUT",
"headers": {},
"resumable": false,
"chunk_bytes": 1,
"expires_at": "2026-11-17T10:24:31.000Z"
}
}{
"error": {
"code": "validation_failed",
"message": "Request validation failed",
"details": {
"issues": [
{
"path": "body.voice_id",
"rule": "invalid_format"
}
]
},
"request_id": "c1f2e3d4-5b6a-4789-9abc-def012345678"
}
}Complete an upload
https://api.34.181.188.80.sslip.io/v2/files/{file_id}/completeVerifies the uploaded bytes (type, size, duration). The file becomes ready or rejected.
Path parameters
file_idstringrequired
Responses
200Success
idstringrequiredobjectstringrequiredkindstringrequiredstatusstringrequirednamestring | nullrequiredmimestringrequiredbytesintegerrequiredduration_msinteger | nullrequiredwidthinteger | nullrequiredheightinteger | nullrequiredsourcestringrequiredjob_idstring | nullrequiredcreated_atstringrequiredexpires_atstring | nullrequireddownload_urlstring | nullrequiredSigned URL valid for 15 minutes; null unless the file is ready
download_expires_atstring | nullrequired
4XXClient errorerror object
errorobjectrequiredShowHide child attributes
codestringrequiredStable machine-readable error code
messagestringrequireddetailsmaprequiredrequest_idstring | nullrequiredQuote this when contacting support
5XXServer errorerror object
errorobjectrequiredShowHide child attributes
codestringrequiredStable machine-readable error code
messagestringrequireddetailsmaprequiredrequest_idstring | nullrequiredQuote this when contacting support
curl -X POST https://api.34.181.188.80.sslip.io/v2/files/0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50/complete \
-H "Authorization: Bearer $VOISER_API_KEY"const res = await fetch("https://api.34.181.188.80.sslip.io/v2/files/0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50/complete", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.VOISER_API_KEY}`,
},
});
const data = await res.json();
console.log(data);import os
import requests
response = requests.post(
"https://api.34.181.188.80.sslip.io/v2/files/0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50/complete",
headers={
"Authorization": f"Bearer {os.environ['VOISER_API_KEY']}",
},
)
print(response.json())<?php
$ch = curl_init('https://api.34.181.188.80.sslip.io/v2/files/0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50/complete');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('VOISER_API_KEY'),
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);{
"id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"object": "file",
"kind": "audio",
"status": "pending",
"name": "Example",
"mime": "audio/mpeg",
"bytes": 482133,
"duration_ms": 14350,
"width": 1,
"height": 1,
"source": "upload",
"job_id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"created_at": "2026-11-17T10:24:31.000Z",
"expires_at": "2026-11-17T10:24:31.000Z",
"download_url": "https://files.example.com/output.mp3?expires=1763375071&signature=…",
"download_expires_at": null
}{
"error": {
"code": "validation_failed",
"message": "Request validation failed",
"details": {
"issues": [
{
"path": "body.voice_id",
"rule": "invalid_format"
}
]
},
"request_id": "c1f2e3d4-5b6a-4789-9abc-def012345678"
}
}Import a file from a URL
https://api.34.181.188.80.sslip.io/v2/files/importDownloads audio or video from a public link (direct file, YouTube, social media). Free; runs as a job whose result has file_id.
Supports the Idempotency-Key header: retrying with the same key returns the original result.
Returns 202 with a job. Poll it or pass webhook_url to get a webhook when it finishes.
Headers
Idempotency-KeystringRetrying with the same key returns the original job instead of creating a new one (8–100 chars).
Request body application/json
urlstring (uri)requirednamestringwebhook_urlstringPublic https URL notified when the job finishes (see Webhooks)
Responses
202Success
idstringrequiredJob id
objectstringrequiredoperationstringrequiredOperation that created the job (e.g.
text_to_speech)statusstringrequiredprogressintegerrequiredcreditsobjectrequiredShowHide child attributes
estimatedintegerrequiredchargedinteger | nullrequired
resultmap | nullrequiredOperation-specific result; null until the job succeeds
filesarray of objectsrequiredFiles produced by the job; get a download URL from
GET /v2/files/{id}ShowHide child attributes
idstringrequiredrolestringrequiredindexintegerrequired
errorobject | nullrequiredShowHide child attributes
codestringrequiredmessagestringrequireddetailsmaprequired
created_atstringrequiredstarted_atstring | nullrequiredcompleted_atstring | nullrequired
4XXClient errorerror object
errorobjectrequiredShowHide child attributes
codestringrequiredStable machine-readable error code
messagestringrequireddetailsmaprequiredrequest_idstring | nullrequiredQuote this when contacting support
5XXServer errorerror object
errorobjectrequiredShowHide child attributes
codestringrequiredStable machine-readable error code
messagestringrequireddetailsmaprequiredrequest_idstring | nullrequiredQuote this when contacting support
curl -X POST https://api.34.181.188.80.sslip.io/v2/files/import \
-H "Authorization: Bearer $VOISER_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: a8f5f167-0e4c-4bde-9b6e-1c2d3e4f5a6b' \
-d '{
"url": "https://files.example.com/output.mp3?expires=1763375071&signature=…"
}'const res = await fetch("https://api.34.181.188.80.sslip.io/v2/files/import", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.VOISER_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": "a8f5f167-0e4c-4bde-9b6e-1c2d3e4f5a6b",
},
body: JSON.stringify({
"url": "https://files.example.com/output.mp3?expires=1763375071&signature=…"
}),
});
const data = await res.json();
console.log(data);import os
import requests
response = requests.post(
"https://api.34.181.188.80.sslip.io/v2/files/import",
headers={
"Authorization": f"Bearer {os.environ['VOISER_API_KEY']}",
"Idempotency-Key": "a8f5f167-0e4c-4bde-9b6e-1c2d3e4f5a6b",
},
json={
"url": "https://files.example.com/output.mp3?expires=1763375071&signature=…",
},
)
print(response.json())<?php
$ch = curl_init('https://api.34.181.188.80.sslip.io/v2/files/import');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('VOISER_API_KEY'),
'Content-Type: application/json',
'Idempotency-Key: a8f5f167-0e4c-4bde-9b6e-1c2d3e4f5a6b',
],
CURLOPT_POSTFIELDS => json_encode([
'url' => 'https://files.example.com/output.mp3?expires=1763375071&signature=…',
]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);{
"id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"object": "job",
"operation": "text_to_speech",
"status": "queued",
"progress": 0,
"credits": {
"estimated": 120,
"charged": null
},
"result": null,
"files": [
{
"id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"role": "output",
"index": 1
}
],
"error": null,
"created_at": "2026-11-17T10:24:31.000Z",
"started_at": null,
"completed_at": null
}{
"error": {
"code": "validation_failed",
"message": "Request validation failed",
"details": {
"issues": [
{
"path": "body.voice_id",
"rule": "invalid_format"
}
]
},
"request_id": "c1f2e3d4-5b6a-4789-9abc-def012345678"
}
}Get a file and its download URL
https://api.34.181.188.80.sslip.io/v2/files/{file_id}Path parameters
file_idstringrequired
Responses
200Success
idstringrequiredobjectstringrequiredkindstringrequiredstatusstringrequirednamestring | nullrequiredmimestringrequiredbytesintegerrequiredduration_msinteger | nullrequiredwidthinteger | nullrequiredheightinteger | nullrequiredsourcestringrequiredjob_idstring | nullrequiredcreated_atstringrequiredexpires_atstring | nullrequireddownload_urlstring | nullrequiredSigned URL valid for 15 minutes; null unless the file is ready
download_expires_atstring | nullrequired
4XXClient errorerror object
errorobjectrequiredShowHide child attributes
codestringrequiredStable machine-readable error code
messagestringrequireddetailsmaprequiredrequest_idstring | nullrequiredQuote this when contacting support
5XXServer errorerror object
errorobjectrequiredShowHide child attributes
codestringrequiredStable machine-readable error code
messagestringrequireddetailsmaprequiredrequest_idstring | nullrequiredQuote this when contacting support
curl https://api.34.181.188.80.sslip.io/v2/files/0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50 \
-H "Authorization: Bearer $VOISER_API_KEY"const res = await fetch("https://api.34.181.188.80.sslip.io/v2/files/0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.VOISER_API_KEY}`,
},
});
const data = await res.json();
console.log(data);import os
import requests
response = requests.get(
"https://api.34.181.188.80.sslip.io/v2/files/0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
headers={
"Authorization": f"Bearer {os.environ['VOISER_API_KEY']}",
},
)
print(response.json())<?php
$ch = curl_init('https://api.34.181.188.80.sslip.io/v2/files/0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('VOISER_API_KEY'),
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);{
"id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"object": "file",
"kind": "audio",
"status": "pending",
"name": "Example",
"mime": "audio/mpeg",
"bytes": 482133,
"duration_ms": 14350,
"width": 1,
"height": 1,
"source": "upload",
"job_id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"created_at": "2026-11-17T10:24:31.000Z",
"expires_at": "2026-11-17T10:24:31.000Z",
"download_url": "https://files.example.com/output.mp3?expires=1763375071&signature=…",
"download_expires_at": null
}{
"error": {
"code": "validation_failed",
"message": "Request validation failed",
"details": {
"issues": [
{
"path": "body.voice_id",
"rule": "invalid_format"
}
]
},
"request_id": "c1f2e3d4-5b6a-4789-9abc-def012345678"
}
}