---
title: "Narration script from a video or text."
method: POST
path: "/script"
tags: ["Tools"]
---

# Narration script from a video or text.

`POST /script`

## Request

- Base URL: `https://wowreveal.com/api/v1`
- URL: `https://wowreveal.com/api/v1/script`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `source` object
    - `url` string
    - `uploadId` string, uuid
    - `name` string
  - `text` string
  - `genre` 'talent' | 'transformation' | 'animals' | 'sports' | 'satisfying' | 'wholesome' | 'food' | 'kids' | 'general', required
  - `language` 'en' | 'es' | 'pt' | 'fr' | 'de' | 'it' | 'ru' | 'hi' | 'ar', required
  - `targetSeconds` integer, required
  - `endingCta` boolean, required

## Response `200`

Success

- object
  - `creditsCharged` integer
  - `balance` integer

## Other responses

- `400`: Invalid request (VALIDATION_ERROR and other 400 codes).
- `401`: Missing or revoked API key (INVALID_API_KEY).
- `403`: The plan has no API access, or the account is blocked.
- `429`: Rate limit (RATE_LIMITED) — see the Retry-After header.

---

[API](https://skmtc.dev/wowreveal/apis/wowreveal-rest-api.md) · [All operations](https://skmtc.dev/wowreveal/apis/wowreveal-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wowreveal/apis/wowreveal-rest-api/revisions/cb44d779f713?raw)