API reference · v2

Video

Generate videos from text or images.

Get video options

GEThttps://api.34.181.188.80.sslip.io/v2/video/catalog

Qualities, modes, durations, aspect ratios, styles, camera moves and templates accepted by POST /v2/videos.

Responses

200Success
  • qualitiesarray of objectsrequired
    ShowHide child attributes
    • idstringrequired
      One ofeconomystandard
    • namestringrequired
    • descriptionstringrequired
    • resolutionsarray of stringsrequired
    • supports_referencebooleanrequired
  • modesarray of objectsrequired
    ShowHide child attributes
    • idstringrequired
      One oftextimagefirst_last_framereference
    • namestringrequired
    • descriptionstringrequired
  • durationsarray of integersrequired

    Allowed duration_seconds values

  • aspect_ratiosarray of objectsrequired
    ShowHide child attributes
    • idstringrequired
      One of16:99:161:1
    • notestring | nullrequired
  • stylesarray of objectsrequired
    ShowHide child attributes
    • idstringrequired
    • namestringrequired
  • camera_movesarray of objectsrequired
    ShowHide child attributes
    • idstringrequired
    • namestringrequired
  • max_camera_movesintegerrequired
  • variationsobjectrequired
    ShowHide child attributes
    • minintegerrequired
    • maxintegerrequired
  • extendobjectrequired
    ShowHide child attributes
    • secondsintegerrequired
    • max_total_secondsintegerrequired
  • templatesarray of objectsrequired
    ShowHide child attributes
    • idstringrequired
    • namestringrequired
    • typestringrequired

      effect animates an uploaded photo; scene is a prompt template filled with your subject

      One ofeffectscene
    • modestringrequired
      One oftextimage
    • aspect_ratiostring | nullrequired

      Fixed aspect ratio, if any

    • duration_secondsinteger | nullrequired

      Fixed duration, if any

    • subject_requiredbooleanrequired

      prompt is required (it is the template's subject)

  • free_planobjectrequired
    ShowHide child attributes
    • qualitystringrequired
    • resolutionstringrequired
    • max_variationsintegerrequired
    • watermarkbooleanrequired
4XXClient errorerror object
  • errorobjectrequired
    ShowHide child attributes
    • codestringrequired

      Stable machine-readable error code

    • messagestringrequired
    • detailsmaprequired
    • request_idstring | nullrequired

      Quote this when contacting support

5XXServer errorerror object
  • errorobjectrequired
    ShowHide child attributes
    • codestringrequired

      Stable machine-readable error code

    • messagestringrequired
    • detailsmaprequired
    • request_idstring | nullrequired

      Quote this when contacting support

GET /v2/video/catalog
curl https://api.34.181.188.80.sslip.io/v2/video/catalog \
  -H "Authorization: Bearer $VOISER_API_KEY"
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
  }
}

List videos

GEThttps://api.34.181.188.80.sslip.io/v2/videos

Videos of the account, newest first (including ones made in the studio).

Query parameters

  • cursorstring
    1–200 characters
  • limitinteger
    Default201 to 100
  • favoritestring
    One oftruefalse

Responses

200Success
  • dataarray of objectsrequired
    ShowHide child attributes
    • idstringrequired
    • objectstringrequired
      Always "video"
    • job_idstringrequired
    • typestringrequired
      One ofgenerationextensionmerge
    • modestring | nullrequired

      Generation mode; null for extensions and merges

      One oftextimagefirst_last_framereference
    • promptstring | nullrequired
    • qualitystring | nullrequired
      One ofeconomyfaststandard
    • duration_secondsinteger | nullrequired
    • total_duration_secondsinteger | nullrequired

      Extensions: length of the whole chain

    • resolutionstring | nullrequired
    • aspect_ratiostring | nullrequired
    • stylestring | nullrequired
    • camera_movesarray of stringsrequired
    • audiobooleanrequired
    • seedinteger | nullrequired
    • variationsintegerrequired
    • template_idstring | nullrequired
    • inputsobjectrequired
      ShowHide child attributes
      • first_frame_file_idstring | nullrequired
      • last_frame_file_idstring | nullrequired
      • reference_file_idsarray of stringsrequired
      • source_video_idstring | nullrequired

        Extensions: the video that was extended

      • source_output_indexinteger | nullrequired
    • statusstringrequired
      One ofqueuedrunningsucceededfailedcanceled
    • progressintegerrequired
    • error_codestring | nullrequired
    • rejection_reasonstring | nullrequired

      Why the content was rejected (e.g. celebrity, copyright, policy)

    • warningstring | nullrequired

      Moderation warning that did not block the video (e.g. public_figure)

    • outputsarray of objectsrequired
      ShowHide child attributes
      • indexintegerrequired
      • file_idstringrequired

        Video file; get a download URL from GET /v2/files/{id}

      • poster_file_idstring | nullrequired

        JPEG poster frame

      • duration_msinteger | nullrequired
      • widthinteger | nullrequired
      • heightinteger | nullrequired
      • watermarkedbooleanrequired
    • filtered_countintegerrequired

      Variations removed by the safety filter (their credits are refunded)

    • watermarkedbooleanrequired
    • creditsobjectrequired
      ShowHide child attributes
      • estimatedintegerrequired
      • chargedinteger | nullrequired
      • free_trialbooleanrequired
    • favoritebooleanrequired
    • created_atstringrequired
  • next_cursorstring | nullrequired
4XXClient errorerror object
  • errorobjectrequired
    ShowHide child attributes
    • codestringrequired

      Stable machine-readable error code

    • messagestringrequired
    • detailsmaprequired
    • request_idstring | nullrequired

      Quote this when contacting support

5XXServer errorerror object
  • errorobjectrequired
    ShowHide child attributes
    • codestringrequired

      Stable machine-readable error code

    • messagestringrequired
    • detailsmaprequired
    • request_idstring | nullrequired

      Quote this when contacting support

GET /v2/videos
curl https://api.34.181.188.80.sslip.io/v2/videos \
  -H "Authorization: Bearer $VOISER_API_KEY"
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
}

Generate a video

POSThttps://api.34.181.188.80.sslip.io/v2/videos

Starts 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-Keystring

    Retrying with the same key returns the original job instead of creating a new one (8–100 chars).

    8–100 characters

Request body application/json

  • modestring

    image: starts from first_frame_file_id; first_last_frame: also ends on last_frame_file_id; reference: keeps subjects consistent with reference_file_ids

    One oftextimagefirst_last_framereference
    Default"text"
  • promptstring

    Scene description. Required for text and reference modes and for templates with subject_required

    Default""up to 2,000 characters
  • negative_promptstring

    Things you don't want to see

    up to 500 characters
  • qualitystring

    See GET /v2/video/catalog

    One ofeconomystandard
    Default"economy"
  • duration_secondsnumber | number | number
    Default8
  • resolutionstring

    4k requires standard quality

    One of720p1080p4k
    Default"720p"
  • aspect_ratiostring
    One of16:99:161:1
    Default"16:9"
  • stylestring
    One ofcinematicanime3dclayrealisticvintage
  • camera_movesarray of strings
    Default[]max 2 items
  • audioboolean

    Generate sound with the video

    Defaulttrue
  • seedinteger
    0 to 2,147,483,647
  • variationsinteger

    Number of videos to generate from the same input; each is charged

    Default11 to 4
  • first_frame_file_idstring (uuid)

    Image file (POST /v2/files, purpose first_frame)

    pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
  • last_frame_file_idstring (uuid)

    Image file (POST /v2/files, purpose last_frame); first_last_frame mode only

    pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
  • reference_file_idsarray of strings

    1–3 image files (purpose reference); reference mode only

    Default[]max 3 items
  • template_idstring

    Template from the catalog; its mode must match mode

    One ofeffect_old_photoeffect_smileeffect_hugproduct_promotionstreet_interviewnature_documentary
  • webhook_urlstring

    Public https URL notified when the job finishes (see Webhooks)

    up to 2,000 characters

Responses

202Success
  • idstringrequired

    Job id

  • objectstringrequired
    Always "job"
  • operationstringrequired

    Operation that created the job (e.g. text_to_speech)

  • statusstringrequired
    One ofqueuedrunningsucceededfailedcanceled
  • progressintegerrequired
    0 to 100
  • creditsobjectrequired
    ShowHide child attributes
    • estimatedintegerrequired
    • chargedinteger | nullrequired
  • resultmap | nullrequired

    Operation-specific result; null until the job succeeds

  • filesarray of objectsrequired

    Files produced by the job; get a download URL from GET /v2/files/{id}

    ShowHide child attributes
    • idstringrequired
    • rolestringrequired
    • indexintegerrequired
  • errorobject | nullrequired
    ShowHide child attributes
    • codestringrequired
    • messagestringrequired
    • detailsmaprequired
  • created_atstringrequired
  • started_atstring | nullrequired
  • completed_atstring | nullrequired
4XXClient errorerror object
  • errorobjectrequired
    ShowHide child attributes
    • codestringrequired

      Stable machine-readable error code

    • messagestringrequired
    • detailsmaprequired
    • request_idstring | nullrequired

      Quote this when contacting support

5XXServer errorerror object
  • errorobjectrequired
    ShowHide child attributes
    • codestringrequired

      Stable machine-readable error code

    • messagestringrequired
    • detailsmaprequired
    • request_idstring | nullrequired

      Quote this when contacting support

POST /v2/videos
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"
  }'
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
}

Estimate credits for a video

POSThttps://api.34.181.188.80.sslip.io/v2/videos/quote

Same body as POST /v2/videos (without webhook_url). Nothing is charged.

Request body application/json

  • modestring

    image: starts from first_frame_file_id; first_last_frame: also ends on last_frame_file_id; reference: keeps subjects consistent with reference_file_ids

    One oftextimagefirst_last_framereference
    Default"text"
  • promptstring

    Scene description. Required for text and reference modes and for templates with subject_required

    Default""up to 2,000 characters
  • negative_promptstring

    Things you don't want to see

    up to 500 characters
  • qualitystring

    See GET /v2/video/catalog

    One ofeconomystandard
    Default"economy"
  • duration_secondsnumber | number | number
    Default8
  • resolutionstring

    4k requires standard quality

    One of720p1080p4k
    Default"720p"
  • aspect_ratiostring
    One of16:99:161:1
    Default"16:9"
  • stylestring
    One ofcinematicanime3dclayrealisticvintage
  • camera_movesarray of strings
    Default[]max 2 items
  • audioboolean

    Generate sound with the video

    Defaulttrue
  • seedinteger
    0 to 2,147,483,647
  • variationsinteger

    Number of videos to generate from the same input; each is charged

    Default11 to 4
  • first_frame_file_idstring (uuid)

    Image file (POST /v2/files, purpose first_frame)

    pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
  • last_frame_file_idstring (uuid)

    Image file (POST /v2/files, purpose last_frame); first_last_frame mode only

    pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
  • reference_file_idsarray of strings

    1–3 image files (purpose reference); reference mode only

    Default[]max 3 items
  • template_idstring

    Template from the catalog; its mode must match mode

    One ofeffect_old_photoeffect_smileeffect_hugproduct_promotionstreet_interviewnature_documentary

Responses

200Success
  • creditsintegerrequired

    Credits the job will hold (upper bound; unused credits are released)

  • affordablebooleanrequired
  • balanceintegerrequired
  • detailsobjectrequired
    ShowHide child attributes
    • secondsinteger | nullrequired

      Seconds of video per output

    • variationsintegerrequired
    • qualitystring | nullrequired
    • chain_secondsinteger | nullrequired

      Extension only: total length of the video after this extension

    • free_trialbooleanrequired

      Covered by the plan's free trial (no credits held)

4XXClient errorerror object
  • errorobjectrequired
    ShowHide child attributes
    • codestringrequired

      Stable machine-readable error code

    • messagestringrequired
    • detailsmaprequired
    • request_idstring | nullrequired

      Quote this when contacting support

5XXServer errorerror object
  • errorobjectrequired
    ShowHide child attributes
    • codestringrequired

      Stable machine-readable error code

    • messagestringrequired
    • detailsmaprequired
    • request_idstring | nullrequired

      Quote this when contacting support

POST /v2/videos/quote
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"
  }'
Response
{
  "credits": 120,
  "affordable": false,
  "balance": 120,
  "details": {
    "seconds": 1,
    "variations": 1,
    "quality": "string",
    "chain_seconds": 1,
    "free_trial": false
  }
}

Get a video

GEThttps://api.34.181.188.80.sslip.io/v2/videos/{video_id}

Path parameters

  • video_idstringrequired

Responses

200Success
  • idstringrequired
  • objectstringrequired
    Always "video"
  • job_idstringrequired
  • typestringrequired
    One ofgenerationextensionmerge
  • modestring | nullrequired

    Generation mode; null for extensions and merges

    One oftextimagefirst_last_framereference
  • promptstring | nullrequired
  • qualitystring | nullrequired
    One ofeconomyfaststandard
  • duration_secondsinteger | nullrequired
  • total_duration_secondsinteger | nullrequired

    Extensions: length of the whole chain

  • resolutionstring | nullrequired
  • aspect_ratiostring | nullrequired
  • stylestring | nullrequired
  • camera_movesarray of stringsrequired
  • audiobooleanrequired
  • seedinteger | nullrequired
  • variationsintegerrequired
  • template_idstring | nullrequired
  • inputsobjectrequired
    ShowHide child attributes
    • first_frame_file_idstring | nullrequired
    • last_frame_file_idstring | nullrequired
    • reference_file_idsarray of stringsrequired
    • source_video_idstring | nullrequired

      Extensions: the video that was extended

    • source_output_indexinteger | nullrequired
  • statusstringrequired
    One ofqueuedrunningsucceededfailedcanceled
  • progressintegerrequired
  • error_codestring | nullrequired
  • rejection_reasonstring | nullrequired

    Why the content was rejected (e.g. celebrity, copyright, policy)

  • warningstring | nullrequired

    Moderation warning that did not block the video (e.g. public_figure)

  • outputsarray of objectsrequired
    ShowHide child attributes
    • indexintegerrequired
    • file_idstringrequired

      Video file; get a download URL from GET /v2/files/{id}

    • poster_file_idstring | nullrequired

      JPEG poster frame

    • duration_msinteger | nullrequired
    • widthinteger | nullrequired
    • heightinteger | nullrequired
    • watermarkedbooleanrequired
  • filtered_countintegerrequired

    Variations removed by the safety filter (their credits are refunded)

  • watermarkedbooleanrequired
  • creditsobjectrequired
    ShowHide child attributes
    • estimatedintegerrequired
    • chargedinteger | nullrequired
    • free_trialbooleanrequired
  • favoritebooleanrequired
  • created_atstringrequired
4XXClient errorerror object
  • errorobjectrequired
    ShowHide child attributes
    • codestringrequired

      Stable machine-readable error code

    • messagestringrequired
    • detailsmaprequired
    • request_idstring | nullrequired

      Quote this when contacting support

5XXServer errorerror object
  • errorobjectrequired
    ShowHide child attributes
    • codestringrequired

      Stable machine-readable error code

    • messagestringrequired
    • detailsmaprequired
    • request_idstring | nullrequired

      Quote this when contacting support

GET /v2/videos/{video_id}
curl https://api.34.181.188.80.sslip.io/v2/videos/0193a5b2-7c41-7d2e-9f3a-6b8c1d2e4f50 \
  -H "Authorization: Bearer $VOISER_API_KEY"
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"
}

Extend a video

POSThttps://api.34.181.188.80.sslip.io/v2/videos/{video_id}/extend

Continues 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-Keystring

    Retrying with the same key returns the original job instead of creating a new one (8–100 chars).

    8–100 characters

Request body application/json

  • output_indexinteger

    Which output (variation) of the video to extend

    Default00 to 3
  • promptstring

    What happens next; empty continues the scene

    Default""up to 2,000 characters
  • webhook_urlstring

    Public https URL notified when the job finishes (see Webhooks)

    up to 2,000 characters

Responses

202Success
  • idstringrequired

    Job id

  • objectstringrequired
    Always "job"
  • operationstringrequired

    Operation that created the job (e.g. text_to_speech)

  • statusstringrequired
    One ofqueuedrunningsucceededfailedcanceled
  • progressintegerrequired
    0 to 100
  • creditsobjectrequired
    ShowHide child attributes
    • estimatedintegerrequired
    • chargedinteger | nullrequired
  • resultmap | nullrequired

    Operation-specific result; null until the job succeeds

  • filesarray of objectsrequired

    Files produced by the job; get a download URL from GET /v2/files/{id}

    ShowHide child attributes
    • idstringrequired
    • rolestringrequired
    • indexintegerrequired
  • errorobject | nullrequired
    ShowHide child attributes
    • codestringrequired
    • messagestringrequired
    • detailsmaprequired
  • created_atstringrequired
  • started_atstring | nullrequired
  • completed_atstring | nullrequired
4XXClient errorerror object
  • errorobjectrequired
    ShowHide child attributes
    • codestringrequired

      Stable machine-readable error code

    • messagestringrequired
    • detailsmaprequired
    • request_idstring | nullrequired

      Quote this when contacting support

5XXServer errorerror object
  • errorobjectrequired
    ShowHide child attributes
    • codestringrequired

      Stable machine-readable error code

    • messagestringrequired
    • detailsmaprequired
    • request_idstring | nullrequired

      Quote this when contacting support

POST /v2/videos/{video_id}/extend
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"
  }'
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
}

Estimate credits for extending a video

POSThttps://api.34.181.188.80.sslip.io/v2/videos/{video_id}/extend/quote

Path parameters

  • video_idstringrequired

Request body application/json

  • output_indexinteger

    Which output (variation) of the video to extend

    Default00 to 3
  • promptstring

    What happens next; empty continues the scene

    Default""up to 2,000 characters

Responses

200Success
  • creditsintegerrequired

    Credits the job will hold (upper bound; unused credits are released)

  • affordablebooleanrequired
  • balanceintegerrequired
  • detailsobjectrequired
    ShowHide child attributes
    • secondsinteger | nullrequired

      Seconds of video per output

    • variationsintegerrequired
    • qualitystring | nullrequired
    • chain_secondsinteger | nullrequired

      Extension only: total length of the video after this extension

    • free_trialbooleanrequired

      Covered by the plan's free trial (no credits held)

4XXClient errorerror object
  • errorobjectrequired
    ShowHide child attributes
    • codestringrequired

      Stable machine-readable error code

    • messagestringrequired
    • detailsmaprequired
    • request_idstring | nullrequired

      Quote this when contacting support

5XXServer errorerror object
  • errorobjectrequired
    ShowHide child attributes
    • codestringrequired

      Stable machine-readable error code

    • messagestringrequired
    • detailsmaprequired
    • request_idstring | nullrequired

      Quote this when contacting support

POST /v2/videos/{video_id}/extend/quote
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": ""
  }'
Response
{
  "credits": 120,
  "affordable": false,
  "balance": 120,
  "details": {
    "seconds": 1,
    "variations": 1,
    "quality": "string",
    "chain_seconds": 1,
    "free_trial": false
  }
}

Improve a video prompt

POSThttps://api.34.181.188.80.sslip.io/v2/videos/enhance-prompt

Starts 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-Keystring

    Retrying with the same key returns the original job instead of creating a new one (8–100 chars).

    8–100 characters

Request body application/json

  • promptstringrequired
    1–2,000 characters
  • webhook_urlstring

    Public https URL notified when the job finishes (see Webhooks)

    up to 2,000 characters

Responses

202Success
  • idstringrequired

    Job id

  • objectstringrequired
    Always "job"
  • operationstringrequired

    Operation that created the job (e.g. text_to_speech)

  • statusstringrequired
    One ofqueuedrunningsucceededfailedcanceled
  • progressintegerrequired
    0 to 100
  • creditsobjectrequired
    ShowHide child attributes
    • estimatedintegerrequired
    • chargedinteger | nullrequired
  • resultmap | nullrequired

    Operation-specific result; null until the job succeeds

  • filesarray of objectsrequired

    Files produced by the job; get a download URL from GET /v2/files/{id}

    ShowHide child attributes
    • idstringrequired
    • rolestringrequired
    • indexintegerrequired
  • errorobject | nullrequired
    ShowHide child attributes
    • codestringrequired
    • messagestringrequired
    • detailsmaprequired
  • created_atstringrequired
  • started_atstring | nullrequired
  • completed_atstring | nullrequired
4XXClient errorerror object
  • errorobjectrequired
    ShowHide child attributes
    • codestringrequired

      Stable machine-readable error code

    • messagestringrequired
    • detailsmaprequired
    • request_idstring | nullrequired

      Quote this when contacting support

5XXServer errorerror object
  • errorobjectrequired
    ShowHide child attributes
    • codestringrequired

      Stable machine-readable error code

    • messagestringrequired
    • detailsmaprequired
    • request_idstring | nullrequired

      Quote this when contacting support

POST /v2/videos/enhance-prompt
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."
  }'
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
}