Write a narration script
write_scriptWrite a viral voiceover/narration script for a video (url or upload_id — the AI watches it) or rewrite/expand a text, in a genre and language, sized to target_seconds. Instant (up to ~1–2 min for videos). Costs 1 credit(s).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Public video link (YouTube, TikTok, Instagram, Facebook, X, Vimeo…). | |
| text | No | Or a text to rewrite / expand. | |
| genre | Yes | Story genre. | |
| language | Yes | Content language code (list_languages): en, es, pt, fr, de, it, ru, hi, ar. | |
| upload_id | No | Id of a file uploaded with POST /api/v1/uploads. | |
| ending_cta | No | End with "Full video below" (default true). | |
| target_seconds | Yes | Narration length in seconds. | |
| idempotency_key | No | Optional unique key (e.g. a uuid) — repeating the same call with the same key within 24 h returns the first result instead of charging again. |