Video
Generate videos from text or images.
Get video options
https://api.34.181.188.80.sslip.io/v2/video/catalogQualities, modes, durations, aspect ratios, styles, camera moves and templates accepted by POST /v2/videos.
Responses
200Success
qualitiesarray of objectsrequiredShowHide child attributes
idstringrequirednamestringrequireddescriptionstringrequiredresolutionsarray of stringsrequiredsupports_referencebooleanrequired
modesarray of objectsrequiredShowHide child attributes
idstringrequirednamestringrequireddescriptionstringrequired
durationsarray of integersrequiredAllowed
duration_secondsvaluesaspect_ratiosarray of objectsrequiredShowHide child attributes
idstringrequirednotestring | nullrequired
stylesarray of objectsrequiredShowHide child attributes
idstringrequirednamestringrequired
camera_movesarray of objectsrequiredShowHide child attributes
idstringrequirednamestringrequired
max_camera_movesintegerrequiredvariationsobjectrequiredShowHide child attributes
minintegerrequiredmaxintegerrequired
extendobjectrequiredShowHide child attributes
secondsintegerrequiredmax_total_secondsintegerrequired
templatesarray of objectsrequiredShowHide child attributes
idstringrequirednamestringrequiredtypestringrequiredeffectanimates an uploaded photo;sceneis a prompt template filled with your subjectmodestringrequiredaspect_ratiostring | nullrequiredFixed aspect ratio, if any
duration_secondsinteger | nullrequiredFixed duration, if any
subject_requiredbooleanrequiredpromptis required (it is the template's subject)
free_planobjectrequiredShowHide child attributes
qualitystringrequiredresolutionstringrequiredmax_variationsintegerrequiredwatermarkbooleanrequired
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/video/catalog \
-H "Authorization: Bearer $VOISER_API_KEY"const res = await fetch("https://api.34.181.188.80.sslip.io/v2/video/catalog", {
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/video/catalog",
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/video/catalog');
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);{
"qualities": [
{
"id": "economy",
"name": "Example",
"description": "string",
"resolutions": [
"720p"
],
"supports_reference": false
}
],
"modes": [
{
"id": "text",
"name": "Example",
"description": "string"
}
],
"durations": [
1
],
"aspect_ratios": [
{
"id": "16:9",
"note": "string"
}
],
"styles": [
{
"id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"name": "Example"
}
],
"camera_moves": [
{
"id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"name": "Example"
}
],
"max_camera_moves": 1,
"variations": {
"min": 1,
"max": 1
},
"extend": {
"seconds": 1,
"max_total_seconds": 1
},
"templates": [
{
"id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"name": "Example",
"type": "effect",
"mode": "text",
"aspect_ratio": "string",
"duration_seconds": 1,
"subject_required": false
}
],
"free_plan": {
"quality": "string",
"resolution": "string",
"max_variations": 1,
"watermark": false
}
}{
"error": {
"code": "validation_failed",
"message": "Request validation failed",
"details": {
"issues": [
{
"path": "body.voice_id",
"rule": "invalid_format"
}
]
},
"request_id": "c1f2e3d4-5b6a-4789-9abc-def012345678"
}
}List videos
https://api.34.181.188.80.sslip.io/v2/videosVideos of the account, newest first (including ones made in the studio).
Query parameters
cursorstringlimitintegerfavoritestring
Responses
200Success
dataarray of objectsrequiredShowHide child attributes
idstringrequiredobjectstringrequiredjob_idstringrequiredtypestringrequiredmodestring | nullrequiredGeneration mode; null for extensions and merges
promptstring | nullrequiredqualitystring | nullrequiredduration_secondsinteger | nullrequiredtotal_duration_secondsinteger | nullrequiredExtensions: length of the whole chain
resolutionstring | nullrequiredaspect_ratiostring | nullrequiredstylestring | nullrequiredcamera_movesarray of stringsrequiredaudiobooleanrequiredseedinteger | nullrequiredvariationsintegerrequiredtemplate_idstring | nullrequiredinputsobjectrequiredShowHide child attributes
first_frame_file_idstring | nullrequiredlast_frame_file_idstring | nullrequiredreference_file_idsarray of stringsrequiredsource_video_idstring | nullrequiredExtensions: the video that was extended
source_output_indexinteger | nullrequired
statusstringrequiredprogressintegerrequirederror_codestring | nullrequiredrejection_reasonstring | nullrequiredWhy the content was rejected (e.g.
celebrity,copyright,policy)warningstring | nullrequiredModeration warning that did not block the video (e.g.
public_figure)outputsarray of objectsrequiredShowHide child attributes
indexintegerrequiredfile_idstringrequiredVideo file; get a download URL from
GET /v2/files/{id}poster_file_idstring | nullrequiredJPEG poster frame
duration_msinteger | nullrequiredwidthinteger | nullrequiredheightinteger | nullrequiredwatermarkedbooleanrequired
filtered_countintegerrequiredVariations removed by the safety filter (their credits are refunded)
watermarkedbooleanrequiredcreditsobjectrequiredShowHide child attributes
estimatedintegerrequiredchargedinteger | nullrequiredfree_trialbooleanrequired
favoritebooleanrequiredcreated_atstringrequired
next_cursorstring | 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/videos \
-H "Authorization: Bearer $VOISER_API_KEY"const res = await fetch("https://api.34.181.188.80.sslip.io/v2/videos", {
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/videos",
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/videos');
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);{
"data": [
{
"id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"object": "video",
"job_id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"type": "generation",
"mode": "text",
"prompt": "A cinematic shot of a quiet beach at sunset with gentle waves.",
"quality": "economy",
"duration_seconds": 1,
"total_duration_seconds": 1,
"resolution": "string",
"aspect_ratio": "string",
"style": "string",
"camera_moves": [
"string"
],
"audio": false,
"seed": 1,
"variations": 1,
"template_id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"inputs": {
"first_frame_file_id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"last_frame_file_id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"reference_file_ids": [
"0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50"
],
"source_video_id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"source_output_index": 1
},
"status": "queued",
"progress": 0,
"error_code": "string",
"rejection_reason": "string",
"warning": "string",
"outputs": [
{
"index": 1,
"file_id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"poster_file_id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"duration_ms": 14350,
"width": 1,
"height": 1,
"watermarked": false
}
],
"filtered_count": 1,
"watermarked": false,
"credits": {
"estimated": 120,
"charged": null,
"free_trial": false
},
"favorite": false,
"created_at": "2026-11-17T10:24:31.000Z"
}
],
"next_cursor": 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"
}
}Generate a video
https://api.34.181.188.80.sslip.io/v2/videosStarts a job that generates a video from text, an image, a first and last frame, or reference images. Upload images first with POST /v2/files. Poll GET /v2/jobs/{id} or pass webhook_url; the result has video_id and outputs (one per variation). Videos on the free plan are watermarked.
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
modestringimage: starts fromfirst_frame_file_id;first_last_frame: also ends onlast_frame_file_id;reference: keeps subjects consistent withreference_file_idspromptstringScene description. Required for
textandreferencemodes and for templates withsubject_requirednegative_promptstringThings you don't want to see
qualitystringSee
GET /v2/video/catalogduration_secondsnumber | number | numberresolutionstring4krequiresstandardqualityaspect_ratiostringstylestringcamera_movesarray of stringsaudiobooleanGenerate sound with the video
seedintegervariationsintegerNumber of videos to generate from the same input; each is charged
first_frame_file_idstring (uuid)Image file (
POST /v2/files, purposefirst_frame)last_frame_file_idstring (uuid)Image file (
POST /v2/files, purposelast_frame);first_last_framemode onlyreference_file_idsarray of strings1–3 image files (purpose
reference);referencemode onlytemplate_idstringTemplate from the catalog; its mode must match
modewebhook_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/videos \
-H "Authorization: Bearer $VOISER_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: a8f5f167-0e4c-4bde-9b6e-1c2d3e4f5a6b' \
-d '{
"mode": "text",
"prompt": "",
"negative_prompt": "string"
}'const res = await fetch("https://api.34.181.188.80.sslip.io/v2/videos", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.VOISER_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": "a8f5f167-0e4c-4bde-9b6e-1c2d3e4f5a6b",
},
body: JSON.stringify({
"mode": "text",
"prompt": "",
"negative_prompt": "string"
}),
});
const data = await res.json();
console.log(data);import os
import requests
response = requests.post(
"https://api.34.181.188.80.sslip.io/v2/videos",
headers={
"Authorization": f"Bearer {os.environ['VOISER_API_KEY']}",
"Idempotency-Key": "a8f5f167-0e4c-4bde-9b6e-1c2d3e4f5a6b",
},
json={
"mode": "text",
"prompt": "",
"negative_prompt": "string",
},
)
print(response.json())<?php
$ch = curl_init('https://api.34.181.188.80.sslip.io/v2/videos');
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([
'mode' => 'text',
'prompt' => '',
'negative_prompt' => 'string',
]),
]);
$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"
}
}Estimate credits for a video
https://api.34.181.188.80.sslip.io/v2/videos/quoteSame body as POST /v2/videos (without webhook_url). Nothing is charged.
Request body application/json
modestringimage: starts fromfirst_frame_file_id;first_last_frame: also ends onlast_frame_file_id;reference: keeps subjects consistent withreference_file_idspromptstringScene description. Required for
textandreferencemodes and for templates withsubject_requirednegative_promptstringThings you don't want to see
qualitystringSee
GET /v2/video/catalogduration_secondsnumber | number | numberresolutionstring4krequiresstandardqualityaspect_ratiostringstylestringcamera_movesarray of stringsaudiobooleanGenerate sound with the video
seedintegervariationsintegerNumber of videos to generate from the same input; each is charged
first_frame_file_idstring (uuid)Image file (
POST /v2/files, purposefirst_frame)last_frame_file_idstring (uuid)Image file (
POST /v2/files, purposelast_frame);first_last_framemode onlyreference_file_idsarray of strings1–3 image files (purpose
reference);referencemode onlytemplate_idstringTemplate from the catalog; its mode must match
mode
Responses
200Success
creditsintegerrequiredCredits the job will hold (upper bound; unused credits are released)
affordablebooleanrequiredbalanceintegerrequireddetailsobjectrequiredShowHide child attributes
secondsinteger | nullrequiredSeconds of video per output
variationsintegerrequiredqualitystring | nullrequiredchain_secondsinteger | nullrequiredExtension only: total length of the video after this extension
free_trialbooleanrequiredCovered by the plan's free trial (no credits held)
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/videos/quote \
-H "Authorization: Bearer $VOISER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"mode": "text",
"prompt": "",
"negative_prompt": "string"
}'const res = await fetch("https://api.34.181.188.80.sslip.io/v2/videos/quote", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.VOISER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"mode": "text",
"prompt": "",
"negative_prompt": "string"
}),
});
const data = await res.json();
console.log(data);import os
import requests
response = requests.post(
"https://api.34.181.188.80.sslip.io/v2/videos/quote",
headers={
"Authorization": f"Bearer {os.environ['VOISER_API_KEY']}",
},
json={
"mode": "text",
"prompt": "",
"negative_prompt": "string",
},
)
print(response.json())<?php
$ch = curl_init('https://api.34.181.188.80.sslip.io/v2/videos/quote');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('VOISER_API_KEY'),
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'mode' => 'text',
'prompt' => '',
'negative_prompt' => 'string',
]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);{
"credits": 120,
"affordable": false,
"balance": 120,
"details": {
"seconds": 1,
"variations": 1,
"quality": "string",
"chain_seconds": 1,
"free_trial": false
}
}{
"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 video
https://api.34.181.188.80.sslip.io/v2/videos/{video_id}Path parameters
video_idstringrequired
Responses
200Success
idstringrequiredobjectstringrequiredjob_idstringrequiredtypestringrequiredmodestring | nullrequiredGeneration mode; null for extensions and merges
promptstring | nullrequiredqualitystring | nullrequiredduration_secondsinteger | nullrequiredtotal_duration_secondsinteger | nullrequiredExtensions: length of the whole chain
resolutionstring | nullrequiredaspect_ratiostring | nullrequiredstylestring | nullrequiredcamera_movesarray of stringsrequiredaudiobooleanrequiredseedinteger | nullrequiredvariationsintegerrequiredtemplate_idstring | nullrequiredinputsobjectrequiredShowHide child attributes
first_frame_file_idstring | nullrequiredlast_frame_file_idstring | nullrequiredreference_file_idsarray of stringsrequiredsource_video_idstring | nullrequiredExtensions: the video that was extended
source_output_indexinteger | nullrequired
statusstringrequiredprogressintegerrequirederror_codestring | nullrequiredrejection_reasonstring | nullrequiredWhy the content was rejected (e.g.
celebrity,copyright,policy)warningstring | nullrequiredModeration warning that did not block the video (e.g.
public_figure)outputsarray of objectsrequiredShowHide child attributes
indexintegerrequiredfile_idstringrequiredVideo file; get a download URL from
GET /v2/files/{id}poster_file_idstring | nullrequiredJPEG poster frame
duration_msinteger | nullrequiredwidthinteger | nullrequiredheightinteger | nullrequiredwatermarkedbooleanrequired
filtered_countintegerrequiredVariations removed by the safety filter (their credits are refunded)
watermarkedbooleanrequiredcreditsobjectrequiredShowHide child attributes
estimatedintegerrequiredchargedinteger | nullrequiredfree_trialbooleanrequired
favoritebooleanrequiredcreated_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 https://api.34.181.188.80.sslip.io/v2/videos/0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50 \
-H "Authorization: Bearer $VOISER_API_KEY"const res = await fetch("https://api.34.181.188.80.sslip.io/v2/videos/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/videos/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/videos/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": "video",
"job_id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"type": "generation",
"mode": "text",
"prompt": "A cinematic shot of a quiet beach at sunset with gentle waves.",
"quality": "economy",
"duration_seconds": 1,
"total_duration_seconds": 1,
"resolution": "string",
"aspect_ratio": "string",
"style": "string",
"camera_moves": [
"string"
],
"audio": false,
"seed": 1,
"variations": 1,
"template_id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"inputs": {
"first_frame_file_id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"last_frame_file_id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"reference_file_ids": [
"0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50"
],
"source_video_id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"source_output_index": 1
},
"status": "queued",
"progress": 0,
"error_code": "string",
"rejection_reason": "string",
"warning": "string",
"outputs": [
{
"index": 1,
"file_id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"poster_file_id": "0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50",
"duration_ms": 14350,
"width": 1,
"height": 1,
"watermarked": false
}
],
"filtered_count": 1,
"watermarked": false,
"credits": {
"estimated": 120,
"charged": null,
"free_trial": false
},
"favorite": false,
"created_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"
}
}Extend a video
https://api.34.181.188.80.sslip.io/v2/videos/{video_id}/extendContinues a finished video by 7 seconds and creates a new video. A chain can be up to 29 seconds long. Square (1:1) videos and merges can't be extended; paid plans only. The result has video_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.
Path parameters
video_idstringrequired
Headers
Idempotency-KeystringRetrying with the same key returns the original job instead of creating a new one (8–100 chars).
Request body application/json
output_indexintegerWhich output (variation) of the video to extend
promptstringWhat happens next; empty continues the scene
webhook_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/videos/0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50/extend \
-H "Authorization: Bearer $VOISER_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: a8f5f167-0e4c-4bde-9b6e-1c2d3e4f5a6b' \
-d '{
"output_index": 0,
"prompt": "",
"webhook_url": "https://example.com/webhooks/voiser"
}'const res = await fetch("https://api.34.181.188.80.sslip.io/v2/videos/0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50/extend", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.VOISER_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": "a8f5f167-0e4c-4bde-9b6e-1c2d3e4f5a6b",
},
body: JSON.stringify({
"output_index": 0,
"prompt": "",
"webhook_url": "https://example.com/webhooks/voiser"
}),
});
const data = await res.json();
console.log(data);import os
import requests
response = requests.post(
"https://api.34.181.188.80.sslip.io/v2/videos/0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50/extend",
headers={
"Authorization": f"Bearer {os.environ['VOISER_API_KEY']}",
"Idempotency-Key": "a8f5f167-0e4c-4bde-9b6e-1c2d3e4f5a6b",
},
json={
"output_index": 0,
"prompt": "",
"webhook_url": "https://example.com/webhooks/voiser",
},
)
print(response.json())<?php
$ch = curl_init('https://api.34.181.188.80.sslip.io/v2/videos/0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50/extend');
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([
'output_index' => 0,
'prompt' => '',
'webhook_url' => 'https://example.com/webhooks/voiser',
]),
]);
$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"
}
}Estimate credits for extending a video
https://api.34.181.188.80.sslip.io/v2/videos/{video_id}/extend/quotePath parameters
video_idstringrequired
Request body application/json
output_indexintegerWhich output (variation) of the video to extend
promptstringWhat happens next; empty continues the scene
Responses
200Success
creditsintegerrequiredCredits the job will hold (upper bound; unused credits are released)
affordablebooleanrequiredbalanceintegerrequireddetailsobjectrequiredShowHide child attributes
secondsinteger | nullrequiredSeconds of video per output
variationsintegerrequiredqualitystring | nullrequiredchain_secondsinteger | nullrequiredExtension only: total length of the video after this extension
free_trialbooleanrequiredCovered by the plan's free trial (no credits held)
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/videos/0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50/extend/quote \
-H "Authorization: Bearer $VOISER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"output_index": 0,
"prompt": ""
}'const res = await fetch("https://api.34.181.188.80.sslip.io/v2/videos/0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50/extend/quote", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.VOISER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"output_index": 0,
"prompt": ""
}),
});
const data = await res.json();
console.log(data);import os
import requests
response = requests.post(
"https://api.34.181.188.80.sslip.io/v2/videos/0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50/extend/quote",
headers={
"Authorization": f"Bearer {os.environ['VOISER_API_KEY']}",
},
json={
"output_index": 0,
"prompt": "",
},
)
print(response.json())<?php
$ch = curl_init('https://api.34.181.188.80.sslip.io/v2/videos/0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50/extend/quote');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('VOISER_API_KEY'),
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'output_index' => 0,
'prompt' => '',
]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);{
"credits": 120,
"affordable": false,
"balance": 120,
"details": {
"seconds": 1,
"variations": 1,
"quality": "string",
"chain_seconds": 1,
"free_trial": false
}
}{
"error": {
"code": "validation_failed",
"message": "Request validation failed",
"details": {
"issues": [
{
"path": "body.voice_id",
"rule": "invalid_format"
}
]
},
"request_id": "c1f2e3d4-5b6a-4789-9abc-def012345678"
}
}Improve a video prompt
https://api.34.181.188.80.sslip.io/v2/videos/enhance-promptStarts a short job that enriches a prompt with scene, lighting and camera details. The result has prompt.
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
promptstringrequiredwebhook_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/videos/enhance-prompt \
-H "Authorization: Bearer $VOISER_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: a8f5f167-0e4c-4bde-9b6e-1c2d3e4f5a6b' \
-d '{
"prompt": "A cinematic shot of a quiet beach at sunset with gentle waves."
}'const res = await fetch("https://api.34.181.188.80.sslip.io/v2/videos/enhance-prompt", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.VOISER_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": "a8f5f167-0e4c-4bde-9b6e-1c2d3e4f5a6b",
},
body: JSON.stringify({
"prompt": "A cinematic shot of a quiet beach at sunset with gentle waves."
}),
});
const data = await res.json();
console.log(data);import os
import requests
response = requests.post(
"https://api.34.181.188.80.sslip.io/v2/videos/enhance-prompt",
headers={
"Authorization": f"Bearer {os.environ['VOISER_API_KEY']}",
"Idempotency-Key": "a8f5f167-0e4c-4bde-9b6e-1c2d3e4f5a6b",
},
json={
"prompt": "A cinematic shot of a quiet beach at sunset with gentle waves.",
},
)
print(response.json())<?php
$ch = curl_init('https://api.34.181.188.80.sslip.io/v2/videos/enhance-prompt');
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([
'prompt' => 'A cinematic shot of a quiet beach at sunset with gentle waves.',
]),
]);
$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"
}
}