Skip to main content

Overview

A Reddit story video opens on a social post card and a voice reads the story over a background. You describe the thread you want in prompt; AI writes the post and its comments, a voice narrates them, and the video plays over gameplay footage (the default), AI images, AI video clips or your own media. The card can imitate a Reddit, Facebook or Instagram post (platform). It only evokes the layout of each network with Hooked’s own shapes and icons, not their logos. Every request needs prompt (up to 4,000 characters) and voiceId (from GET /v1/voice/list). targetDuration is 60 seconds by default (10 to 600).

Quick Example

Without mediaType the story plays over gameplay footage (subway-s / subway-s-1). The create call answers with the projectId; poll GET /v1/project/{projectId} or pass a webhook to get the finished video.

Complete Example

Your Own Card

By default the card shows the post AI wrote. Send card to replace any of its fields with your own values; the ones you leave out are still generated.

Parameters

Fields of card: subreddit, author, title, upvotes, commentCount, and the ones only some cards draw: timeAgo (max 40 characters), shares (Facebook), subtitle (max 80 characters, Instagram) and verified (Instagram). A Facebook card reads upvotes as reactions and an Instagram card as likes. Gameplay clips: minecraft-1 to minecraft-9, subway-s-1 to subway-s-11, temple-run-1 to temple-run-8, gta-1 to gta-12, fortnite-1 to fortnite-5, roblox-1, free-fire-1 (the game is the part before the number). To use your own footage, send selectedGame: 'custom' and a video ID from your library as selectedVideo.
Managed teams are charged an estimate made from targetDuration (the narration) and the media the background needs, when the project is created; it is refunded if the project fails.Teams in bring-your-own-keys mode are not charged credits for generation, but need their own OpenRouter and ElevenLabs keys in Settings → AI keys, plus Gemini when the AI video model is Omni Flash. Without them the call answers 402 with code: "missing_credentials" and the missingProviders list, before anything is created or charged. To retry a create call after a timeout or 5xx, send it with an Idempotency-Key: the same key never creates or charges twice.

Tips for Reddit Stories

Give it a conflict: a clear dilemma (“who was right?”) makes the comments worth reading
Set the length: 60 to 90 seconds suits most stories; comments_only makes a shorter, punchier video
Gameplay keeps attention: the default background works well for long narrations
Short card: cardDurationSeconds hides the card after the opening so the background shows

Use Cases

  • Story channels: AITA-style dilemmas, confessions and drama threads
  • Brand storytelling: A customer story told as a social post
  • Community content: Turn a discussion topic into a narrated thread

Handling the Webhook Response

Webhooks are signed: check the Hooked-Signature header as shown in Webhooks.