Article to Video
POST/video1 credit

Article to Video

Turn an article URL or pasted text into a narrated mp4. Async: returns a jobId immediately; poll GET /video/{jobId} until status is done (usually 2 to 4 minutes). API renders are never watermarked. Charges 1 video credit on enqueue.

POSThttps://www.startuphub.ai/api/v1/video

Request

curl -X POST "https://www.startuphub.ai/api/v1/video" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.startuphub.ai/ai-news/example-post","format":"9:16"}'

Parameters

urlstringoptional

Article URL (any site; on-site /ai-news URLs use richer b-roll). Provide url OR text.

textstringoptional

Article text (>= 200 chars). Used when url is omitted.

titlestringoptional

Optional title (auto-generated if omitted).

voicestringoptional

Azure TTS voice id (default en-US-AvaNeural).

formatstringoptional

9:16 (vertical, default) or 16:9 (landscape). Also accepts wide: true.

visual_stylestringoptional

Visual style preset (default gradient).

subtitlesbooleanoptional

Burn in subtitles (default true).

Response

json
{
  "jobId": "uuid",
  "status": "queued",
  "poll_url": "/api/v1/video/uuid",
  "retry_after_seconds": 15,
  "note": "Rendering runs async on our servers (usually 2 to 4 minutes). GET the poll_url until status is done for the mp4 URL.",
  "cost": 1,
  "credits_remaining": 9
}

Errors

400Invalid or too-short input
401Invalid or missing API key
402Insufficient video credits
500Enqueue failed (credit refunded)
PreviousAI Text HumanizerNext Poll Video Job