{"info":{"_postman_id":"4b7a5e87-2b6f-4040-8f23-1f7165ad33a9","name":"Revid Public API v3 - Master Collection","description":"<html><head></head><body><p><strong>Interactive docs with a parameter explorer: <a href=\"https://www.revid.ai/docs\">https://www.revid.ai/docs</a></strong></p>\n<p>Revid MCP for AI agents is available at <code>POST https://www.revid.ai/api/mcp</code>. Authenticate with <code>Authorization: Bearer YOUR_REVID_API_KEY</code>, <code>x-revid-api-key</code>, <code>x-api-key</code>, or <code>key</code>. Guide: <a href=\"https://www.revid.ai/mcp\">https://www.revid.ai/mcp</a></p>\n<p>Send a descriptive <code>User-Agent</code> header identifying your integration, for example <code>my-app/1.0</code>. Requests sent with the default signature of some HTTP libraries (known examples, not an exhaustive list: Python's standard-library client <code>Python-urllib/*</code> and <code>libwww-perl/*</code>) are rejected by our edge protection in front of the API with HTTP 403 and the plain-text body <code>error code: 1010</code>; they never reach the API. The same applies when downloading the media URLs the API returns (cdn.revid.ai).</p>\n<p>Recommended for background music: <code>music: { generateMusic: true }</code>. Revid generates an original instrumental track from this video's script, so it fits the topic and mood (20 credits per started minute of video). Add <code>music.generationMusicPrompt</code> to steer the mood, tempo and instruments. Use <code>music.trackName</code> only when the user asks for a specific library track: an agent cannot listen to the library, so a track picked by name rarely fits the video. With music on and no track, file or generated music, the neutral <code>Presentation</code> track plays. To make the music quieter or louder, set <code>music.volume</code> to <code>low</code>, <code>normal</code> or <code>high</code>, or to an exact level from 0 to 100.</p>\n<p>Master collection for <code>POST /api/public/v3/render</code> with one request per workflow plus curated recipes. Open <code>Field Definitions (v3)</code> for a condensed parameter reference.</p>\n<p>Highly recommended workflow:</p>\n<ul>\n<li>Configure your video on <a href=\"https://www.revid.ai/create\">https://www.revid.ai/create</a></li>\n<li>Click <code>Get API code</code></li>\n<li>Use that exact JSON payload in this API</li>\n</ul>\n<p>Related docs:</p>\n<ul>\n<li>Interactive docs: <a href=\"https://www.revid.ai/docs\">https://www.revid.ai/docs</a></li>\n<li>Live JSON docs: <code>GET https://www.revid.ai/api/public/v3/render</code></li>\n<li>OpenAPI spec: <code>https://www.revid.ai/postman/revid-public-v3-render.openapi.json</code></li>\n<li>Revid MCP guide: <a href=\"https://www.revid.ai/mcp\">https://www.revid.ai/mcp</a></li>\n<li>Legacy V2 API: <a href=\"https://documenter.getpostman.com/view/36975521/2sA3kPo4BR\">https://documenter.getpostman.com/view/36975521/2sA3kPo4BR</a></li>\n</ul>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"36975521","collectionId":"4b7a5e87-2b6f-4040-8f23-1f7165ad33a9","publishedId":"2sBXcGEfaB","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-02-25T13:57:15.000Z"},"item":[{"name":"Get v3 Master Docs","id":"f60a2b20-b772-425d-b16b-2787ee06da0a","request":{"method":"GET","header":[],"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"f60a2b20-b772-425d-b16b-2787ee06da0a"},{"name":"Get v3 OpenAPI Spec","id":"9457b5f7-d651-48df-add4-87c16a9807a4","request":{"method":"GET","header":[],"url":"https://www.revid.ai/postman/revid-public-v3-render.openapi.json","urlObject":{"path":["postman","revid-public-v3-render.openapi.json"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"9457b5f7-d651-48df-add4-87c16a9807a4"},{"name":"Field Definitions (v3)","id":"11b35d48-2e80-43a9-81cf-d84f795b68c3","request":{"method":"GET","header":[],"url":"https://www.revid.ai/api/public/v3/render","description":"<h2 id=\"revid-v3-field-definitions-condensed\">Revid v3 Field Definitions (Condensed)</h2>\n<p>Canonical shape:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"webhookUrl\": \"https://your-webhook.com/revid\",\n  \"workflow\": \"script-to-video\",\n  \"source\": {},\n  \"media\": {},\n  \"voice\": {},\n  \"captions\": {},\n  \"music\": {},\n  \"avatar\": {},\n  \"options\": {},\n  \"render\": {},\n  \"advanced\": {\n    \"customCreationParams\": {}\n  }\n}\n</code></pre>\n<p>Workflow requirements:</p>\n<ul>\n<li><code>script-to-video</code>: source.text (alias: voiceover-to-video)</li>\n<li><code>prompt-to-video</code>: source.prompt</li>\n<li><code>audio-to-video</code>: source.url</li>\n<li><code>music-to-video</code>: source.url</li>\n<li><code>article-to-video</code>: source.url</li>\n<li><code>avatar-to-video</code>: source.text + avatar.url</li>\n<li><code>static-background-video</code>: source.text or source.url</li>\n<li><code>motion-transfer</code>: source.url + media.provided[] with 1 image (the target character)</li>\n<li><code>caption-video</code>: source.url</li>\n<li><code>video-to-clips</code>: source.url</li>\n<li><code>ad-generator</code>: source.prompt or media.provided[]</li>\n</ul>\n<p>Core enums:</p>\n<ul>\n<li><code>aspectRatio</code>: <code>9:16</code>, <code>16:9</code>, <code>1:1</code>, <code>4:5</code>, <code>auto</code></li>\n<li><code>source.recordingType</code>: <code>video</code>, <code>audio</code></li>\n<li><code>media.type</code>: <code>moving-image</code>, <code>ai-video</code>, <code>motion-graphics</code>, <code>stock-video</code>, <code>custom</code></li>\n<li><code>media.quality</code>: <code>standard</code>, <code>pro</code>, <code>ultra</code></li>\n<li><code>media.imageModel</code>: <code>cheap</code>, <code>good</code>, <code>ultra</code></li>\n<li><code>media.videoModel</code>: <code>base</code>, <code>pro</code>, <code>ultra</code>, <code>veo3</code>, <code>sora2</code>, <code>seedance-25-1080p</code>, <code>seedance-1080p</code>, <code>seedance-4k</code>, <code>minimax-h3-768p</code>, <code>minimax-h3-2k</code>, <code>wan-3-1080p</code></li>\n<li><code>media.density</code>: <code>low</code>, <code>medium</code>, <code>high</code></li>\n<li><code>media.animation</code>: <code>none</code>, <code>soft</code>, <code>dynamic</code>, <code>depth</code>, <code>overlay</code>, <code>parallax</code>, <code>multiplane</code>, <code>cinemagraph</code>, <code>dust</code>, <code>hook</code>, <code>eco</code></li>\n<li><code>captions.position</code>: <code>top</code>, <code>middle</code>, <code>bottom</code></li>\n<li><code>music.volume</code>: <code>low</code>, <code>normal</code>, <code>high</code>, or a number from 0 to 100</li>\n<li><code>music.syncWith</code>: <code>beats</code>, <code>lyrics</code></li>\n<li><code>options.summarizationPreference</code>: <code>summarize</code>, <code>summarizeIfLong</code>, <code>no-summarization</code></li>\n<li><code>options.coverStyle</code>: <code>depth</code>, <code>editorial</code>, <code>magazine</code>, <code>journal</code>, <code>scrapbook</code>, <code>viral</code></li>\n<li><code>render.resolution</code>: <code>720p</code>, <code>1080p</code>, <code>4k</code></li>\n</ul>\n<p>Key rules:</p>\n<ul>\n<li><code>media.animation</code> applies only when <code>media.type</code> is <code>moving-image</code>.</li>\n<li><code>media.quality</code> picks image/video models; explicit <code>media.imageModel</code>/<code>media.videoModel</code> override it.</li>\n<li><code>media.type = custom</code> requires at least one <code>media.provided[]</code> item.</li>\n<li>For <code>audio-to-video</code>, <code>options.useWholeAudio</code> defaults to <code>true</code>.</li>\n<li>URLs must be public http(s). <code>music.audioUrl</code> is reachability-checked.</li>\n<li>Invalid enum/range returns <code>400</code> with a field-specific error message.</li>\n</ul>\n<p>Backward compatibility aliases:</p>\n<ul>\n<li>webhook (alias of webhookUrl)</li>\n<li>pid (alias of projectId)</li>\n<li>ratio (alias of aspectRatio)</li>\n<li>inputText / prompt / input (legacy aliases of source.text / source.prompt)</li>\n<li>inputMedias (legacy alias of media.provided)</li>\n<li>audio.* (legacy alias of music.*)</li>\n<li>selectedCharacters (alias of characterIds)</li>\n<li>media.generationPreset / options.generationPreset (legacy aliases of media.mediaPreset)</li>\n<li>options.durationSeconds / options.stylePrompt (legacy aliases of source.durationSeconds / source.stylePrompt)</li>\n<li>options.generateMusic / options.generationMusicPrompt (legacy aliases of music.generateMusic / music.generationMusicPrompt)</li>\n<li>options.targetDuration acts as options.promptTargetDuration in prompt workflows</li>\n<li>voiceover-to-video (alias of the script-to-video workflow)</li>\n<li>media.type \"video\" (alias of \"ai-video\")</li>\n<li>media.type \"motion-graphics\" maps to legacy \"motionGraphics\"</li>\n</ul>\n<p>Full reference: <a href=\"https://www.revid.ai/docs\">https://www.revid.ai/docs</a> — machine-readable spec: <a href=\"https://www.revid.ai/postman/revid-public-v3-render.openapi.json\">https://www.revid.ai/postman/revid-public-v3-render.openapi.json</a></p>\n","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"11b35d48-2e80-43a9-81cf-d84f795b68c3"},{"name":"from Script To Video","id":"f5c3410f-9bd0-46ca-a975-5df544430769","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"webhookUrl\": \"https://your-server.com/revid/webhook\",\n  \"workflow\": \"script-to-video\",\n  \"source\": {\n    \"text\": \"this is my video text\"\n  },\n  \"media\": {\n    \"type\": \"moving-image\",\n    \"quality\": \"pro\",\n    \"density\": \"high\",\n    \"animation\": \"soft\"\n  },\n  \"voice\": {\n    \"enabled\": true,\n    \"voiceId\": \"cgSgspJ2msm6clMCkdW9\",\n    \"stability\": 0.2,\n    \"speed\": 1\n  },\n  \"captions\": {\n    \"enabled\": true,\n    \"preset\": \"Wrap 1\",\n    \"position\": \"bottom\"\n  },\n  \"music\": {\n    \"generateMusic\": true,\n    \"generationMusicPrompt\": \"upbeat and curious, light plucked synths, soft percussion\"\n  },\n  \"render\": {\n    \"resolution\": \"1080p\",\n    \"compression\": 18,\n    \"frameRate\": 30\n  },\n  \"aspectRatio\": \"9:16\"\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"f5c3410f-9bd0-46ca-a975-5df544430769"},{"name":"from Prompt To Video","id":"86c9ca91-8120-40a8-a1df-aa17f27de8b6","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"webhookUrl\": \"https://your-server.com/revid/webhook\",\n  \"workflow\": \"prompt-to-video\",\n  \"source\": {\n    \"prompt\": \"this is my prompt\",\n    \"stylePrompt\": \"dark mood\",\n    \"durationSeconds\": 40\n  },\n  \"media\": {\n    \"type\": \"ai-video\",\n    \"quality\": \"ultra\",\n    \"density\": \"high\"\n  },\n  \"music\": {\n    \"generateMusic\": true\n  },\n  \"options\": {\n    \"promptTargetDuration\": 30\n  },\n  \"characterIds\": [\n    \"ac873ae7-aec1-4261-b8ef-bbd85547652e\"\n  ]\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"86c9ca91-8120-40a8-a1df-aa17f27de8b6"},{"name":"from Audio To Video","id":"9c213499-5404-4327-ba59-f87b2224f32e","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"webhookUrl\": \"https://your-server.com/revid/webhook\",\n  \"workflow\": \"audio-to-video\",\n  \"source\": {\n    \"url\": \"https://www.youtube.com/watch?v=ip30oRP9BP0\"\n  },\n  \"media\": {\n    \"type\": \"ai-video\",\n    \"density\": \"medium\",\n    \"imageModel\": \"good\",\n    \"videoModel\": \"ultra\",\n    \"mediaPreset\": \"DEFAULT\",\n    \"bRollType\": \"split-screen\"\n  },\n  \"captions\": {\n    \"enabled\": true,\n    \"preset\": \"Wrap 1\",\n    \"position\": \"bottom\",\n    \"autoCrop\": true\n  },\n  \"options\": {\n    \"useWholeAudio\": true,\n    \"hasToTranscript\": true,\n    \"disableAudio\": true\n  },\n  \"aspectRatio\": \"16:9\"\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"9c213499-5404-4327-ba59-f87b2224f32e"},{"name":"from Music To Video","id":"0b506d78-a68b-4138-990a-85e8d5fc9078","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"webhookUrl\": \"https://your-server.com/revid/webhook\",\n  \"workflow\": \"music-to-video\",\n  \"source\": {\n    \"url\": \"https://www.youtube.com/watch?v=ip30oRP9BP0\",\n    \"prompt\": \"A neon noir chase through rainy streets that becomes a rooftop performance by the final chorus.\",\n    \"recordingType\": \"video\"\n  },\n  \"media\": {\n    \"type\": \"moving-image\",\n    \"imageModel\": \"good\",\n    \"videoModel\": \"ultra\",\n    \"provided\": [\n      {\n        \"url\": \"https://cdn.revid.ai/uploads/music-video-reference.jpg\",\n        \"type\": \"image\",\n        \"title\": \"Reference for the neon rooftop look\"\n      }\n    ]\n  },\n  \"captions\": {\n    \"enabled\": true,\n    \"preset\": \"Wrap 1\",\n    \"position\": \"bottom\"\n  },\n  \"music\": {\n    \"soundWave\": true,\n    \"syncWith\": \"lyrics\"\n  },\n  \"aspectRatio\": \"16:9\"\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"0b506d78-a68b-4138-990a-85e8d5fc9078"},{"name":"from Article To Video","id":"8a98eeda-f0c2-4791-8526-f5f7adcb7c64","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"webhookUrl\": \"https://your-server.com/revid/webhook\",\n  \"workflow\": \"article-to-video\",\n  \"source\": {\n    \"url\": \"https://open.spotify.com/track/5Cp75TUMrHF6c8xbhdligS\"\n  },\n  \"media\": {\n    \"type\": \"moving-image\",\n    \"quality\": \"ultra\"\n  },\n  \"options\": {\n    \"summarizationPreference\": \"summarize\",\n    \"targetDuration\": 30\n  },\n  \"metadata\": {\n    \"urlType\": \"spotify\",\n    \"duration\": 194\n  }\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"8a98eeda-f0c2-4791-8526-f5f7adcb7c64"},{"name":"from Avatar To Video","id":"963c8920-b243-4c0f-b530-b99b66492aeb","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"webhookUrl\": \"https://your-server.com/revid/webhook\",\n  \"workflow\": \"avatar-to-video\",\n  \"source\": {\n    \"text\": \"this is my text\"\n  },\n  \"media\": {\n    \"type\": \"moving-image\",\n    \"bRollType\": \"split-screen\",\n    \"placeAvatarInContext\": true\n  },\n  \"avatar\": {\n    \"enabled\": true,\n    \"url\": \"https://cdn.revid.ai/ai-gen/chSmd-WtE.jpg\",\n    \"mimeType\": \"image/jpeg\"\n  }\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"963c8920-b243-4c0f-b530-b99b66492aeb"},{"name":"from Static BG Video","id":"255d3e3f-47cd-46de-9e80-bfbb3584d534","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"webhookUrl\": \"https://your-server.com/revid/webhook\",\n  \"workflow\": \"static-background-video\",\n  \"source\": {\n    \"text\": \"this is my text\"\n  },\n  \"media\": {\n    \"type\": \"moving-image\",\n    \"backgroundVideo\": {\n      \"type\": \"video\",\n      \"url\": \"https://cdn.revid.ai/backgrounds/minecraft/color-upscaled.mp4\",\n      \"urlLowRes\": \"https://cdn.revid.ai/backgrounds/minecraft/color_low.mp4\",\n      \"imagePreview\": \"https://cdn.revid.ai/backgrounds/minecraft/color_poster.webp\",\n      \"noReencode\": true\n    }\n  }\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"255d3e3f-47cd-46de-9e80-bfbb3584d534"},{"name":"from Motion Transfer","id":"7674f881-a9f6-4bba-8feb-6f2c6d2c9407","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"webhookUrl\": \"https://your-server.com/revid/webhook\",\n  \"workflow\": \"motion-transfer\",\n  \"source\": {\n    \"url\": \"https://cdn.revid.ai/uploads/1772035872439-video.mp4\"\n  },\n  \"media\": {\n    \"type\": \"moving-image\",\n    \"density\": \"medium\",\n    \"animation\": \"dynamic\",\n    \"imageModel\": \"good\",\n    \"videoModel\": \"ultra\",\n    \"mediaPreset\": \"DEFAULT\",\n    \"useOnlyProvided\": true,\n    \"provided\": [\n      {\n        \"url\": \"https://cdn.revid.ai/uploads/1772035882827-image.jpg\",\n        \"type\": \"image\",\n        \"title\": \"\"\n      }\n    ]\n  },\n  \"captions\": {\n    \"enabled\": true,\n    \"preset\": \"Wrap 1\",\n    \"position\": \"bottom\"\n  },\n  \"metadata\": {\n    \"duration\": 25.32\n  },\n  \"aspectRatio\": \"9:16\"\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"7674f881-a9f6-4bba-8feb-6f2c6d2c9407"},{"name":"from Caption Video","id":"184ddd48-72a1-4f55-9e3f-b534886d176d","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"webhookUrl\": \"https://your-server.com/revid/webhook\",\n  \"workflow\": \"caption-video\",\n  \"source\": {\n    \"url\": \"https://cdn.revid.ai/uploads/1771944925512-video.mp4\",\n    \"recordingType\": \"video\"\n  },\n  \"media\": {\n    \"type\": \"moving-image\",\n    \"bRollType\": \"split-screen\"\n  },\n  \"captions\": {\n    \"enabled\": true,\n    \"autoCrop\": true\n  },\n  \"metadata\": {\n    \"duration\": 8.04\n  }\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"184ddd48-72a1-4f55-9e3f-b534886d176d"},{"name":"from Video to clips","id":"04838777-d3cc-4025-8c4c-c5d761bdc203","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"webhookUrl\": \"https://your-server.com/revid/webhook\",\n  \"workflow\": \"video-to-clips\",\n  \"source\": {\n    \"url\": \"https://www.youtube.com/watch?v=ip30oRP9BP0\"\n  },\n  \"captions\": {\n    \"enabled\": true,\n    \"preset\": \"Wrap 1\",\n    \"position\": \"bottom\",\n    \"autoCrop\": true\n  },\n  \"options\": {\n    \"outputCount\": 3,\n    \"clipDuration\": 45,\n    \"searchQuery\": \"the most surprising moments\"\n  },\n  \"aspectRatio\": \"9:16\"\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"04838777-d3cc-4025-8c4c-c5d761bdc203"},{"name":"from AI Ad Generator","id":"70c668c3-aac4-461c-b2e1-e36e2b98738d","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"webhookUrl\": \"https://your-server.com/revid/webhook\",\n  \"workflow\": \"ad-generator\",\n  \"source\": {\n    \"prompt\": \"my ad prompt\"\n  },\n  \"media\": {\n    \"type\": \"moving-image\",\n    \"quality\": \"ultra\",\n    \"useOnlyProvided\": true,\n    \"provided\": [\n      {\n        \"url\": \"https://cdn.revid.ai/uploads/1771944959344-image.png\",\n        \"type\": \"image\",\n        \"title\": \"\"\n      }\n    ]\n  },\n  \"options\": {\n    \"promptTargetDuration\": 30\n  }\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"70c668c3-aac4-461c-b2e1-e36e2b98738d"},{"name":"from Script with Custom Media","id":"deebd581-9323-452f-9f13-07ce0448588a","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"webhookUrl\": \"https://your-server.com/revid/webhook\",\n  \"workflow\": \"script-to-video\",\n  \"source\": {\n    \"text\": \"this is a test\"\n  },\n  \"media\": {\n    \"type\": \"custom\",\n    \"density\": \"medium\",\n    \"imageModel\": \"cheap\",\n    \"videoModel\": \"base\",\n    \"useOnlyProvided\": true,\n    \"useProvidedInOrder\": true,\n    \"turnImagesIntoVideos\": true,\n    \"provided\": [\n      {\n        \"url\": \"https://cdn.revid.ai/ai-gen/TAINdpjKn.jpg\",\n        \"title\": \"An abstract, beautiful shot of three distinct beams of light merging into a single radiant golden source.\",\n        \"type\": \"image\"\n      },\n      {\n        \"url\": \"https://cdn.revid.ai/ai-gen/OZxUbirp4.jpg\",\n        \"title\": \"Three women appear as silhouettes in front of a giant glowing sun in a dark indigo sky.\",\n        \"type\": \"image\"\n      },\n      {\n        \"url\": \"https://cdn.revid.ai/ai-gen/xA1PjFVGorg.jpg\",\n        \"title\": \"A woman with a sleek black bob stands in a neon-lit glass hallway with rain outside.\",\n        \"type\": \"image\"\n      }\n    ]\n  },\n  \"voice\": {\n    \"enabled\": true,\n    \"voiceId\": \"nPczCjzI2devNBz1zQrb\",\n    \"speed\": 1\n  },\n  \"captions\": {\n    \"enabled\": true,\n    \"position\": \"bottom\"\n  },\n  \"aspectRatio\": \"9:16\"\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"deebd581-9323-452f-9f13-07ce0448588a"},{"name":"from Prompt with Reference Image","id":"c420db0b-84e4-42e2-81ff-7008ae7b7b10","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"webhookUrl\": \"https://your-server.com/revid/webhook\",\n  \"workflow\": \"prompt-to-video\",\n  \"source\": {\n    \"prompt\": \"this is an example\",\n    \"durationSeconds\": 40\n  },\n  \"media\": {\n    \"type\": \"ai-video\",\n    \"imageModel\": \"ultra\",\n    \"videoModel\": \"ultra\",\n    \"mediaPreset\": \"ANIME\",\n    \"addAudioToVideos\": true,\n    \"provided\": [\n      {\n        \"url\": \"https://cdn.revid.ai/uploads/1777872884798-image.png\",\n        \"title\": \"\",\n        \"type\": \"image\"\n      }\n    ]\n  },\n  \"voice\": {\n    \"enabled\": true,\n    \"voiceId\": \"nPczCjzI2devNBz1zQrb\",\n    \"stability\": 0.2,\n    \"speed\": 1\n  },\n  \"captions\": {\n    \"enabled\": true,\n    \"preset\": \"Ali\",\n    \"position\": \"bottom\"\n  },\n  \"options\": {\n    \"promptTargetDuration\": 30\n  },\n  \"aspectRatio\": \"9:16\"\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"c420db0b-84e4-42e2-81ff-7008ae7b7b10"},{"name":"from with Stock Video","id":"be4799c9-fbae-4268-9654-877925333888","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"webhookUrl\": \"https://your-server.com/revid/webhook\",\n  \"workflow\": \"script-to-video\",\n  \"source\": {\n    \"text\": \"this is my video text\"\n  },\n  \"media\": {\n    \"type\": \"stock-video\",\n    \"density\": \"high\"\n  },\n  \"voice\": {\n    \"enabled\": true,\n    \"voiceId\": \"cgSgspJ2msm6clMCkdW9\",\n    \"stability\": 0.2,\n    \"speed\": 1\n  },\n  \"captions\": {\n    \"enabled\": true,\n    \"preset\": \"Wrap 1\",\n    \"position\": \"bottom\"\n  },\n  \"music\": {\n    \"generateMusic\": true\n  }\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"be4799c9-fbae-4268-9654-877925333888"},{"name":"from X/Linkedin To Video","id":"1ef38f4e-9cb9-4c36-8f6a-afe8b188aef4","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"webhookUrl\": \"https://your-server.com/revid/webhook\",\n  \"workflow\": \"script-to-video\",\n  \"source\": {\n    \"text\": \"https://x.com/tibo_maker/status/1848647301998284964\"\n  },\n  \"media\": {\n    \"type\": \"moving-image\",\n    \"density\": \"medium\",\n    \"animation\": \"dynamic\",\n    \"imageModel\": \"good\",\n    \"videoModel\": \"ultra\"\n  },\n  \"voice\": {\n    \"enabled\": true,\n    \"voiceId\": \"cgSgspJ2msm6clMCkdW9\",\n    \"speed\": 1\n  },\n  \"captions\": {\n    \"enabled\": true,\n    \"preset\": \"Wrap 1\",\n    \"position\": \"bottom\"\n  },\n  \"options\": {\n    \"summarizationPreference\": \"summarize\"\n  },\n  \"aspectRatio\": \"9:16\"\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"1ef38f4e-9cb9-4c36-8f6a-afe8b188aef4"},{"name":"from Video Quiz","id":"3561b6d2-3dc0-4cc4-87dc-182f3fa163c1","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"webhookUrl\": \"https://your-server.com/revid/webhook\",\n  \"workflow\": \"script-to-video\",\n  \"source\": {\n    \"text\": \"https://x.com/tibo_maker/status/1848647301998284964\"\n  },\n  \"media\": {\n    \"type\": \"moving-image\",\n    \"density\": \"medium\",\n    \"animation\": \"dynamic\"\n  },\n  \"voice\": {\n    \"enabled\": true,\n    \"voiceId\": \"cgSgspJ2msm6clMCkdW9\",\n    \"speed\": 1\n  },\n  \"captions\": {\n    \"enabled\": true,\n    \"preset\": \"Wrap 1\",\n    \"position\": \"bottom\"\n  },\n  \"advanced\": {\n    \"customCreationParams\": {\n      \"quizzData\": {\n        \"title\": \"France\",\n        \"questions\": [\n          {\n            \"id\": \"82e14b8f-07ce-4489-9c35-6d9c10872b4e\",\n            \"question\": \"What is France\",\n            \"answers\": [\n              {\n                \"id\": \"a62c6e91-da4b-491a-8f36-ba67caa5838a\",\n                \"answer\": \"a country\",\n                \"isCorrect\": true\n              },\n              {\n                \"id\": \"10c89812-22f8-47df-88ef-f11e318fdb1c\",\n                \"answer\": \"a city\",\n                \"isCorrect\": false\n              }\n            ]\n          }\n        ]\n      }\n    }\n  },\n  \"aspectRatio\": \"9:16\"\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"3561b6d2-3dc0-4cc4-87dc-182f3fa163c1"},{"name":"from PDF to Video","id":"592ff2bf-bdda-41ba-9add-f02337dffb9a","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"webhookUrl\": \"https://your-server.com/revid/webhook\",\n  \"workflow\": \"caption-video\",\n  \"source\": {\n    \"url\": \"https://cdn.revid.ai/uploads/1772035824673-application.pdf\"\n  },\n  \"media\": {\n    \"type\": \"moving-image\",\n    \"density\": \"medium\",\n    \"animation\": \"dynamic\",\n    \"imageModel\": \"cheap\",\n    \"videoModel\": \"base\"\n  },\n  \"voice\": {\n    \"enabled\": true,\n    \"voiceId\": \"nPczCjzI2devNBz1zQrb\",\n    \"speed\": 1\n  },\n  \"captions\": {\n    \"enabled\": true,\n    \"position\": \"bottom\"\n  },\n  \"aspectRatio\": \"9:16\"\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"592ff2bf-bdda-41ba-9add-f02337dffb9a"},{"name":"Motion graphics with the pro director","id":"6c09ba5c-8ad6-407a-aa77-ec7799ae51ad","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"webhookUrl\": \"https://your-server.com/revid/webhook\",\n  \"workflow\": \"prompt-to-video\",\n  \"source\": {\n    \"prompt\": \"Explain how compound interest works\",\n    \"durationSeconds\": 40\n  },\n  \"media\": {\n    \"type\": \"motion-graphics\",\n    \"videoModel\": \"pro\",\n    \"mediaPreset\": \"MOTION_INSPIRATION_DARK_SAAS\"\n  },\n  \"voice\": {\n    \"enabled\": true,\n    \"voiceId\": \"cgSgspJ2msm6clMCkdW9\",\n    \"speed\": 1\n  },\n  \"captions\": {\n    \"enabled\": true,\n    \"preset\": \"Wrap 1\",\n    \"position\": \"bottom\"\n  },\n  \"aspectRatio\": \"16:9\"\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"6c09ba5c-8ad6-407a-aa77-ec7799ae51ad"},{"name":"from News to video","id":"c6578266-eefe-4a62-a2d0-d21c5208e93b","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"webhookUrl\": \"https://your-server.com/revid/webhook\",\n  \"workflow\": \"prompt-to-video\",\n  \"source\": {\n    \"prompt\": \"news about France\",\n    \"durationSeconds\": 40\n  },\n  \"media\": {\n    \"type\": \"moving-image\",\n    \"density\": \"medium\",\n    \"animation\": \"dynamic\",\n    \"imageModel\": \"good\",\n    \"videoModel\": \"ultra\"\n  },\n  \"voice\": {\n    \"enabled\": true,\n    \"voiceId\": \"cgSgspJ2msm6clMCkdW9\",\n    \"speed\": 1\n  },\n  \"captions\": {\n    \"enabled\": true,\n    \"preset\": \"Wrap 1\",\n    \"position\": \"bottom\"\n  },\n  \"options\": {\n    \"promptTargetDuration\": 30,\n    \"fetchNews\": true\n  },\n  \"advanced\": {\n    \"customCreationParams\": {\n      \"promptCustomRules\": \"Use recent factual sources and structure as a professional news report.\"\n    }\n  },\n  \"aspectRatio\": \"9:16\"\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/render","urlObject":{"path":["api","public","v3","render"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"c6578266-eefe-4a62-a2d0-d21c5208e93b"},{"name":"Get Account Info","id":"64e3562a-e056-4f3c-9823-e579bdc8c77d","request":{"method":"GET","header":[{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"url":"https://www.revid.ai/api/public/v3/me","description":"<p>Account, credits, subscription, and workspace info for the API key.</p>\n<p><strong>Response:</strong> { success, email, totalCredits, user, workspace, credits: { regular, nonExpiring, total }, subscription, usage }.</p>\n","urlObject":{"path":["api","public","v3","me"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"64e3562a-e056-4f3c-9823-e579bdc8c77d"},{"name":"Get Projects","id":"1bb92a53-413d-4148-9ba0-136df5e3e04b","request":{"method":"GET","header":[{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"url":"https://www.revid.ai/api/public/v3/projects?limit=10","description":"<p>List projects owned by the API key's workspace.</p>\n<h3 id=\"query-parameters\">Query parameters</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Type</th>\n<th>Required</th>\n<th>Allowed</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>limit</code></td>\n<td>integer</td>\n<td>No</td>\n<td></td>\n<td>Maximum number of projects to return.</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Response:</strong> Array of projects with ids, names, statuses, and output URLs.</p>\n","urlObject":{"path":["api","public","v3","projects"],"host":["https://www.revid.ai"],"query":[{"key":"limit","value":"10"}],"variable":[]}},"response":[],"_postman_id":"1bb92a53-413d-4148-9ba0-136df5e3e04b"},{"name":"Get Video Status","id":"f6edb0fa-7dd6-4aa4-b19c-d6976507dda8","request":{"method":"GET","header":[{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"url":"https://www.revid.ai/api/public/v3/status?pid=REPLACE_WITH_PROJECT_ID","description":"<p>Poll the status of a project created by POST /render.</p>\n<h3 id=\"query-parameters\">Query parameters</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Type</th>\n<th>Required</th>\n<th>Allowed</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>pid</code></td>\n<td>string</td>\n<td>Yes</td>\n<td></td>\n<td>Project id returned by POST /render.</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Response:</strong> Project status (building/rendering/ready/error), progress, and the output video URL when ready.</p>\n","urlObject":{"path":["api","public","v3","status"],"host":["https://www.revid.ai"],"query":[{"key":"pid","value":"REPLACE_WITH_PROJECT_ID"}],"variable":[]}},"response":[],"_postman_id":"f6edb0fa-7dd6-4aa4-b19c-d6976507dda8"},{"name":"Estimate Credits","id":"2684a784-194a-433a-95b0-089bfdbda1d3","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"workflow\": \"script-to-video\",\n  \"source\": {\n    \"text\": \"this is a test\"\n  },\n  \"media\": {\n    \"type\": \"moving-image\",\n    \"quality\": \"pro\",\n    \"density\": \"high\",\n    \"animation\": \"soft\"\n  },\n  \"voice\": {\n    \"enabled\": true,\n    \"voiceId\": \"cgSgspJ2msm6clMCkdW9\"\n  },\n  \"captions\": {\n    \"enabled\": true,\n    \"preset\": \"Wrap 1\",\n    \"position\": \"bottom\"\n  }\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/calculate-credits","description":"<p>Estimate the credit cost of a render without starting it. Accepts the exact same body as POST /render (legacy { creationParams } also accepted). No auth required. The estimate covers all generation costs (voice, AI media, music, sound effects) but not the flat per-call render fee, and the actual charge can differ slightly since media counts and durations are decided at build time.</p>\n<p><strong>Response:</strong> { creditsToConsume: integer (estimated total credits for the render), creditsToConsumeString: string (human-readable cost formula), warningMessage: string (empty when there is nothing to warn about), isEstimationReliable: boolean (false when the cost depends on inputs only known at build time, e.g. URL or file sources — treat the number as a lower bound and warn users) }.</p>\n","urlObject":{"path":["api","public","v3","calculate-credits"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"2684a784-194a-433a-95b0-089bfdbda1d3"},{"name":"List Connected Social Accounts","id":"2943deda-d848-471e-be16-88a83db6eb5f","request":{"method":"GET","header":[{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"url":"https://www.revid.ai/api/public/v3/social-accounts","description":"<p>List the social accounts (TikTok, YouTube, Instagram, X, Facebook Pages, webhooks) and channels connected to the API key's active workspace. Use the returned ids or handles as the <code>&lt;platform&gt;.id</code> / <code>&lt;platform&gt;.username</code> (or <code>facebook.name</code>) values of /publish-now and /add-to-queue. Tokens are never returned. Accounts with tokenInvalid: true must be reconnected in Revid settings before publishing.</p>\n<p><strong>Response:</strong> { success, workspace: { id, type }, platforms: string[], accounts: [{ platform, id, label, username?, name?, image?, workspaceId?, tokenInvalid? }], channels: [{ id, name, accounts: [{ platform, id, name? }] }] }.</p>\n","urlObject":{"path":["api","public","v3","social-accounts"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"2943deda-d848-471e-be16-88a83db6eb5f"},{"name":"Add To Queue","id":"15e94e54-d0b9-43db-9508-84be3513de97","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"videoUrl\": \"https://cdn.revid.ai/uploads/your-video.mp4\",\n  \"channelName\": \"Main Channel\"\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/add-to-queue","description":"<p>Add a rendered video to your publishing queue. Pass scheduledTime to publish at an exact date and time; otherwise it is scheduled at the next open slot of the channel's posting schedule.</p>\n<h3 id=\"request-body\">Request body</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Type</th>\n<th>Required</th>\n<th>Allowed</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>videoUrl</code></td>\n<td>string</td>\n<td>Yes</td>\n<td></td>\n<td>Public URL of the video to publish: a Revid render or your own mp4 (e.g. a signed storage link). Revid fetches it when the post goes out, so a link hosted outside Revid must stay valid until then (for /add-to-queue, until the scheduled time).</td>\n</tr>\n<tr>\n<td><code>channelName</code></td>\n<td>string</td>\n<td>either channelName/channelId or at least one platform account</td>\n<td></td>\n<td>Name of a channel configured in your Revid account settings. Mutually exclusive with platform accounts.</td>\n</tr>\n<tr>\n<td><code>channelId</code></td>\n<td>string</td>\n<td>No</td>\n<td></td>\n<td>Channel id, alternative to channelName.</td>\n</tr>\n<tr>\n<td><code>tiktok</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>TikTok target: { username or id, title?, privacy_level?, video_cover_timestamp_ms? }. privacy_level: PUBLIC_TO_EVERYONE, FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS, SELF_ONLY. video_cover_timestamp_ms selects the video frame used as the post cover (milliseconds; when the video's project has a generated cover — baked into the first 0.5 s — it defaults to 100 so the cover image is used, else 1000).</td>\n</tr>\n<tr>\n<td><code>youtube</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>YouTube target: { username or id, title?, description? }.</td>\n</tr>\n<tr>\n<td><code>instagram</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>Instagram target: { username or id, caption? }.</td>\n</tr>\n<tr>\n<td><code>webhook</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>Webhook target: { username or id }. Posts the video to your configured webhook.</td>\n</tr>\n<tr>\n<td><code>x</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>X (Twitter) target: { username or id, text?, replySettings? }. username is the connected X handle (with or without the leading @); id is the connected account id from GET /social-accounts. text is the post body (defaults to extraParams.title + extraParams.description); it is limited to 280 characters unless the connected account is X Premium. replySettings: everyone (default), following, mentionedUsers, subscribers. X accepts videos up to 2:20 (10 min on Premium), max 512 MB. Beta.</td>\n</tr>\n<tr>\n<td><code>facebook</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>Facebook Page target: { name or id, text?, title?, postAs? }. name is the connected Page name; id is the Page id from GET /social-accounts. Only Facebook Pages can be posted to (not personal profiles). text is the post body (defaults to extraParams.description, then extraParams.title); title is the optional video title (defaults to extraParams.title). postAs: auto (default: Reel when the video is 9:16 and 90 s or shorter, otherwise a Page video), reel, video. Beta.</td>\n</tr>\n<tr>\n<td><code>extraParams</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>Extra fields stored on the scheduled content. extraParams.title and extraParams.description are used as the default title/description for every destination (TikTok, YouTube, Instagram, webhook, X, Facebook); on TikTok, Instagram and X, which have a single caption field, the description is appended to the caption. extraParams.thumbnailUrl (image URL) is used as the default video cover for YouTube, Instagram, webhook and Facebook; when omitted, the generated thumbnail of the project that rendered the videoUrl is used automatically. Per-platform values override these defaults. TikTok privacy_level defaults to PUBLIC_TO_EVERYONE. TikTok, YouTube, Instagram and webhook targets accept the same fields as before; X and Facebook targets are resolved by account id or handle, and the connected account must not need reconnecting. Use GET /api/public/v3/social-accounts to list the ids and handles you can target.</td>\n</tr>\n<tr>\n<td><code>scheduledTime</code></td>\n<td>string</td>\n<td>No</td>\n<td></td>\n<td>Optional exact publish time. Accepts ISO 8601 with Z or an offset (2026-10-04T18:00:00Z, 2026-10-04T18:00:00+02:00), ISO 8601 without offset (2026-10-04T18:00, read in your account timezone, the same clock as the queue page, UTC if none is set), or a unix timestamp in seconds. Must be in the future and within 365 days, otherwise the request fails with 400. When omitted, the video takes the next open slot of the channel's posting schedule (only posts already queued on that channel count as taken; per-platform accounts without a channel use the account-wide schedule and every queued post). An exact time does not need a posting schedule and does not move other queued posts.</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Response:</strong> { success: 1, contentId, scheduledTime: ISO 8601 UTC publish time, scheduleSource: \"requested\" (from scheduledTime) or \"queue\" (next open slot) }. Pass contentId to /publish-status to follow the post. Invalid scheduledTime returns 400 { success: 0, error }.</p>\n","urlObject":{"path":["api","public","v3","add-to-queue"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"15e94e54-d0b9-43db-9508-84be3513de97"},{"name":"Publish Now","id":"b2f4a6fb-7867-4726-9044-396639342630","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"videoUrl\": \"https://cdn.revid.ai/uploads/your-video.mp4\",\n  \"channelName\": \"Main Channel\"\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/publish-now","description":"<p>Publish a rendered video right now to a channel or specific platform accounts.</p>\n<h3 id=\"request-body\">Request body</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Type</th>\n<th>Required</th>\n<th>Allowed</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>videoUrl</code></td>\n<td>string</td>\n<td>Yes</td>\n<td></td>\n<td>Public URL of the video to publish: a Revid render or your own mp4 (e.g. a signed storage link). Revid fetches it when the post goes out, so a link hosted outside Revid must stay valid until then (for /add-to-queue, until the scheduled time).</td>\n</tr>\n<tr>\n<td><code>channelName</code></td>\n<td>string</td>\n<td>either channelName/channelId or at least one platform account</td>\n<td></td>\n<td>Name of a channel configured in your Revid account settings. Mutually exclusive with platform accounts.</td>\n</tr>\n<tr>\n<td><code>channelId</code></td>\n<td>string</td>\n<td>No</td>\n<td></td>\n<td>Channel id, alternative to channelName.</td>\n</tr>\n<tr>\n<td><code>tiktok</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>TikTok target: { username or id, title?, privacy_level?, video_cover_timestamp_ms? }. privacy_level: PUBLIC_TO_EVERYONE, FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS, SELF_ONLY. video_cover_timestamp_ms selects the video frame used as the post cover (milliseconds; when the video's project has a generated cover — baked into the first 0.5 s — it defaults to 100 so the cover image is used, else 1000).</td>\n</tr>\n<tr>\n<td><code>youtube</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>YouTube target: { username or id, title?, description? }.</td>\n</tr>\n<tr>\n<td><code>instagram</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>Instagram target: { username or id, caption? }.</td>\n</tr>\n<tr>\n<td><code>webhook</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>Webhook target: { username or id }. Posts the video to your configured webhook.</td>\n</tr>\n<tr>\n<td><code>x</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>X (Twitter) target: { username or id, text?, replySettings? }. username is the connected X handle (with or without the leading @); id is the connected account id from GET /social-accounts. text is the post body (defaults to extraParams.title + extraParams.description); it is limited to 280 characters unless the connected account is X Premium. replySettings: everyone (default), following, mentionedUsers, subscribers. X accepts videos up to 2:20 (10 min on Premium), max 512 MB. Beta.</td>\n</tr>\n<tr>\n<td><code>facebook</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>Facebook Page target: { name or id, text?, title?, postAs? }. name is the connected Page name; id is the Page id from GET /social-accounts. Only Facebook Pages can be posted to (not personal profiles). text is the post body (defaults to extraParams.description, then extraParams.title); title is the optional video title (defaults to extraParams.title). postAs: auto (default: Reel when the video is 9:16 and 90 s or shorter, otherwise a Page video), reel, video. Beta.</td>\n</tr>\n<tr>\n<td><code>extraParams</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>Extra fields stored on the scheduled content. extraParams.title and extraParams.description are used as the default title/description for every destination (TikTok, YouTube, Instagram, webhook, X, Facebook); on TikTok, Instagram and X, which have a single caption field, the description is appended to the caption. extraParams.thumbnailUrl (image URL) is used as the default video cover for YouTube, Instagram, webhook and Facebook; when omitted, the generated thumbnail of the project that rendered the videoUrl is used automatically. Per-platform values override these defaults. TikTok privacy_level defaults to PUBLIC_TO_EVERYONE. TikTok, YouTube, Instagram and webhook targets accept the same fields as before; X and Facebook targets are resolved by account id or handle, and the connected account must not need reconnecting. Use GET /api/public/v3/social-accounts to list the ids and handles you can target.</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Response:</strong> { success: 1, contentId, message }. The video is queued for immediate posting and may take a few minutes to show up on the selected platforms. Pass contentId to /publish-status to check the outcome per platform.</p>\n","urlObject":{"path":["api","public","v3","publish-now"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"b2f4a6fb-7867-4726-9044-396639342630"},{"name":"Publish Now To X And Facebook","id":"c135a0cf-2b37-478a-9622-9ee8d98bdee8","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"videoUrl\": \"https://cdn.revid.ai/uploads/your-video.mp4\",\n  \"x\": {\n    \"username\": \"@your_handle\",\n    \"text\": \"New video is live\",\n    \"replySettings\": \"everyone\"\n  },\n  \"facebook\": {\n    \"name\": \"Your Page name\",\n    \"text\": \"New video is live\",\n    \"postAs\": \"auto\"\n  },\n  \"extraParams\": {\n    \"title\": \"New video is live\",\n    \"description\": \"Made with Revid\"\n  }\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/publish-now","description":"<p>Publish a rendered video right now to a channel or specific platform accounts.</p>\n<h3 id=\"request-body\">Request body</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Type</th>\n<th>Required</th>\n<th>Allowed</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>videoUrl</code></td>\n<td>string</td>\n<td>Yes</td>\n<td></td>\n<td>Public URL of the video to publish: a Revid render or your own mp4 (e.g. a signed storage link). Revid fetches it when the post goes out, so a link hosted outside Revid must stay valid until then (for /add-to-queue, until the scheduled time).</td>\n</tr>\n<tr>\n<td><code>channelName</code></td>\n<td>string</td>\n<td>either channelName/channelId or at least one platform account</td>\n<td></td>\n<td>Name of a channel configured in your Revid account settings. Mutually exclusive with platform accounts.</td>\n</tr>\n<tr>\n<td><code>channelId</code></td>\n<td>string</td>\n<td>No</td>\n<td></td>\n<td>Channel id, alternative to channelName.</td>\n</tr>\n<tr>\n<td><code>tiktok</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>TikTok target: { username or id, title?, privacy_level?, video_cover_timestamp_ms? }. privacy_level: PUBLIC_TO_EVERYONE, FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS, SELF_ONLY. video_cover_timestamp_ms selects the video frame used as the post cover (milliseconds; when the video's project has a generated cover — baked into the first 0.5 s — it defaults to 100 so the cover image is used, else 1000).</td>\n</tr>\n<tr>\n<td><code>youtube</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>YouTube target: { username or id, title?, description? }.</td>\n</tr>\n<tr>\n<td><code>instagram</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>Instagram target: { username or id, caption? }.</td>\n</tr>\n<tr>\n<td><code>webhook</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>Webhook target: { username or id }. Posts the video to your configured webhook.</td>\n</tr>\n<tr>\n<td><code>x</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>X (Twitter) target: { username or id, text?, replySettings? }. username is the connected X handle (with or without the leading @); id is the connected account id from GET /social-accounts. text is the post body (defaults to extraParams.title + extraParams.description); it is limited to 280 characters unless the connected account is X Premium. replySettings: everyone (default), following, mentionedUsers, subscribers. X accepts videos up to 2:20 (10 min on Premium), max 512 MB. Beta.</td>\n</tr>\n<tr>\n<td><code>facebook</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>Facebook Page target: { name or id, text?, title?, postAs? }. name is the connected Page name; id is the Page id from GET /social-accounts. Only Facebook Pages can be posted to (not personal profiles). text is the post body (defaults to extraParams.description, then extraParams.title); title is the optional video title (defaults to extraParams.title). postAs: auto (default: Reel when the video is 9:16 and 90 s or shorter, otherwise a Page video), reel, video. Beta.</td>\n</tr>\n<tr>\n<td><code>extraParams</code></td>\n<td>object</td>\n<td>No</td>\n<td></td>\n<td>Extra fields stored on the scheduled content. extraParams.title and extraParams.description are used as the default title/description for every destination (TikTok, YouTube, Instagram, webhook, X, Facebook); on TikTok, Instagram and X, which have a single caption field, the description is appended to the caption. extraParams.thumbnailUrl (image URL) is used as the default video cover for YouTube, Instagram, webhook and Facebook; when omitted, the generated thumbnail of the project that rendered the videoUrl is used automatically. Per-platform values override these defaults. TikTok privacy_level defaults to PUBLIC_TO_EVERYONE. TikTok, YouTube, Instagram and webhook targets accept the same fields as before; X and Facebook targets are resolved by account id or handle, and the connected account must not need reconnecting. Use GET /api/public/v3/social-accounts to list the ids and handles you can target.</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Response:</strong> { success: 1, contentId, message }. The video is queued for immediate posting and may take a few minutes to show up on the selected platforms. Pass contentId to /publish-status to check the outcome per platform.</p>\n","urlObject":{"path":["api","public","v3","publish-now"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"c135a0cf-2b37-478a-9622-9ee8d98bdee8"},{"name":"Export Project","id":"af10b934-c403-4e2c-8861-ab83a9531e91","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"pid\": \"REPLACE_WITH_PROJECT_ID\"\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/export-video","description":"<p>Render an mp4 export of an existing project.</p>\n<p><strong>Cost:</strong> 10 credits.</p>\n<h3 id=\"request-body\">Request body</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Type</th>\n<th>Required</th>\n<th>Allowed</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>pid</code></td>\n<td>string</td>\n<td>Yes</td>\n<td></td>\n<td>Project id to export. Must belong to the API key user.</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Response:</strong> Export result with the video file URL.</p>\n","urlObject":{"path":["api","public","v3","export-video"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"af10b934-c403-4e2c-8861-ab83a9531e91"},{"name":"Rename Project","id":"e6d114ef-e444-4ce3-8731-b57de89df820","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"pid\": \"REPLACE_WITH_PROJECT_ID\",\n  \"name\": \"My New Project Name\"\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/rename-project","description":"<p>Rename a project owned by the API key user.</p>\n<h3 id=\"request-body\">Request body</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Type</th>\n<th>Required</th>\n<th>Allowed</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>pid</code></td>\n<td>string</td>\n<td>Yes</td>\n<td></td>\n<td>Project id.</td>\n</tr>\n<tr>\n<td><code>name</code></td>\n<td>string</td>\n<td>Yes</td>\n<td></td>\n<td>New project name.</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Response:</strong> { success: 1 } on success.</p>\n","urlObject":{"path":["api","public","v3","rename-project"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"e6d114ef-e444-4ce3-8731-b57de89df820"},{"name":"Get All Consistent Characters","id":"6b46603e-7f1a-4a02-8cc1-e78d8452a2f2","request":{"method":"GET","header":[{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"url":"https://www.revid.ai/api/public/v3/consistent-characters","description":"<p>List saved consistent characters (avatar-based and LoRA-trained), newest first.</p>\n<p><strong>Response:</strong> Array of { id, name, description, imageUrl, contentType, source: avatar|lora, createdAt }.</p>\n","urlObject":{"path":["api","public","v3","consistent-characters"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"6b46603e-7f1a-4a02-8cc1-e78d8452a2f2"},{"name":"Create Consistent Character","id":"7461b070-32f7-4a99-b8f9-72fd20c86e8e","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"name\": \"Sarah\",\n  \"description\": \"A friendly teacher who explains complex topics simply\",\n  \"imageUrl\": \"https://cdn.revid.ai/ai-gen/chSmd-WtE.jpg\"\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/consistent-characters","description":"<p>Save a consistent character usable in renders (characterIds) and as a talking avatar.</p>\n<h3 id=\"request-body\">Request body</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Type</th>\n<th>Required</th>\n<th>Allowed</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>name</code></td>\n<td>string</td>\n<td>Yes</td>\n<td></td>\n<td>Character name (min 3 characters).</td>\n</tr>\n<tr>\n<td><code>description</code></td>\n<td>string</td>\n<td>Yes</td>\n<td></td>\n<td>Character description (min 10 characters) — used by the AI to decide when/how to use the character.</td>\n</tr>\n<tr>\n<td><code>imageUrl</code></td>\n<td>string</td>\n<td>Yes</td>\n<td></td>\n<td>Public URL of the character image.</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Response:</strong> Created character with its id.</p>\n","urlObject":{"path":["api","public","v3","consistent-characters"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"7461b070-32f7-4a99-b8f9-72fd20c86e8e"},{"name":"Delete Consistent Character","id":"af0aac4c-07a2-4269-8ed1-65ed88fabb8a","request":{"method":"DELETE","header":[{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"url":"https://www.revid.ai/api/public/v3/consistent-characters?id=REPLACE_WITH_CHARACTER_ID","description":"<p>Delete a character by id (works for avatar-based and LoRA characters).</p>\n<h3 id=\"query-parameters\">Query parameters</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Type</th>\n<th>Required</th>\n<th>Allowed</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>id</code></td>\n<td>string</td>\n<td>Yes</td>\n<td></td>\n<td>Character id (also accepted in the body).</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Response:</strong> { success, deleted: id, source: avatar|lora }.</p>\n","urlObject":{"path":["api","public","v3","consistent-characters"],"host":["https://www.revid.ai"],"query":[{"key":"id","value":"REPLACE_WITH_CHARACTER_ID"}],"variable":[]}},"response":[],"_postman_id":"af0aac4c-07a2-4269-8ed1-65ed88fabb8a"},{"name":"Clone Voice","id":"3daa34af-422e-4bcf-939e-eac9abca02df","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"name\": \"My Cloned Voice\",\n  \"description\": \"A friendly voice for tutorials\",\n  \"voiceUrl\": \"https://cdn.revid.ai/uploads/sample-voice.mp3\"\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/voice-clone","description":"<p>Clone a custom voice from a public audio sample. Requires the Elite plan or above (10 voices on Elite, 100 on Enterprise).</p>\n<h3 id=\"request-body\">Request body</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Type</th>\n<th>Required</th>\n<th>Allowed</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>name</code></td>\n<td>string</td>\n<td>Yes</td>\n<td></td>\n<td>Voice name (min 3 characters).</td>\n</tr>\n<tr>\n<td><code>description</code></td>\n<td>string</td>\n<td>No</td>\n<td></td>\n<td>Voice description.</td>\n</tr>\n<tr>\n<td><code>voiceUrl</code></td>\n<td>string</td>\n<td>Yes</td>\n<td></td>\n<td>Public URL of the audio sample (mp3, wav, ...).</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Response:</strong> { success, voiceId, voice } — use voiceId as voice.voiceId in renders.</p>\n","urlObject":{"path":["api","public","v3","voice-clone"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"3daa34af-422e-4bcf-939e-eac9abca02df"},{"name":"Generate Media","id":"d13e375d-c415-47c6-bec4-3885d47492ff","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"mediaType\": \"image\",\n  \"prompt\": \"a sunrise over snowy alps, cinematic\",\n  \"ratio\": \"9:16\",\n  \"imageQuality\": \"good\",\n  \"count\": 1\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/generate-media","description":"<p>Generate images or video clips without creating a video project (same engine as the Revid media generator).</p>\n<h3 id=\"request-body\">Request body</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Type</th>\n<th>Required</th>\n<th>Allowed</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>mediaType</code></td>\n<td>string</td>\n<td>No</td>\n<td><code>image</code>, <code>video</code></td>\n<td>What to generate.</td>\n</tr>\n<tr>\n<td><code>prompt</code></td>\n<td>string</td>\n<td>yes, unless mediaType = video with firstFrame</td>\n<td></td>\n<td>Generation prompt. Aliases: source.prompt, input.</td>\n</tr>\n<tr>\n<td><code>ratio</code></td>\n<td>string</td>\n<td>No</td>\n<td></td>\n<td>Aspect ratio: 1:1, 9:16, 16:9, 4:5 (aliases square/portrait/landscape/feed/linkedin; portrait maps to 9:16, feed and linkedin map to 4:5). Alias: aspectRatio.</td>\n</tr>\n<tr>\n<td><code>imageQuality</code></td>\n<td>string</td>\n<td>No</td>\n<td><code>cheap</code>, <code>good</code>, <code>ultra</code></td>\n<td>Image model: cheap, good, ultra. Alias: media.imageModel.</td>\n</tr>\n<tr>\n<td><code>videoQuality</code></td>\n<td>string</td>\n<td>No</td>\n<td><code>base</code>, <code>pro</code>, <code>ultra</code>, <code>veo3</code>, <code>sora2</code>, <code>seedance-25-1080p</code>, <code>seedance-1080p</code>, <code>seedance-4k</code>, <code>minimax-h3-768p</code>, <code>minimax-h3-2k</code>, <code>wan-3-1080p</code></td>\n<td>Video model: base, pro, ultra, veo3, or an Ultra variant such as seedance-1080p / seedance-4k. Alias: media.videoModel.</td>\n</tr>\n<tr>\n<td><code>count</code></td>\n<td>integer</td>\n<td>No</td>\n<td></td>\n<td>Number of images (videos: always 1). Aliases: imageCount, options.outputCount.</td>\n</tr>\n<tr>\n<td><code>duration</code></td>\n<td>integer</td>\n<td>No</td>\n<td></td>\n<td>Video duration in seconds (video only).</td>\n</tr>\n<tr>\n<td><code>generationPreset</code></td>\n<td>string</td>\n<td>No</td>\n<td></td>\n<td>Visual style preset slug (same list as media.mediaPreset).</td>\n</tr>\n<tr>\n<td><code>firstFrame</code></td>\n<td>string</td>\n<td>No</td>\n<td></td>\n<td>URL of the first frame to animate from (video only).</td>\n</tr>\n<tr>\n<td><code>lastFrame</code></td>\n<td>string</td>\n<td>No</td>\n<td></td>\n<td>URL of the last frame to animate to (video only).</td>\n</tr>\n<tr>\n<td><code>referenceImages</code></td>\n<td>string[]</td>\n<td>No</td>\n<td></td>\n<td>Reference image URLs (max 4 for images, 9 for videos).</td>\n</tr>\n<tr>\n<td><code>referenceVideos</code></td>\n<td>string[]</td>\n<td>No</td>\n<td></td>\n<td>Reference video URLs (max 3).</td>\n</tr>\n<tr>\n<td><code>referenceAudios</code></td>\n<td>string[]</td>\n<td>No</td>\n<td></td>\n<td>Reference audio URLs (max 3).</td>\n</tr>\n<tr>\n<td><code>enableAudio</code></td>\n<td>boolean</td>\n<td>No</td>\n<td></td>\n<td>Generate ambient audio with the video clip. Defaults to true for videos; pass false for a silent clip. Ignored for images.</td>\n</tr>\n<tr>\n<td><code>selectedCharacters</code></td>\n<td>string[]</td>\n<td>No</td>\n<td></td>\n<td>Consistent character ids to feature (max 12). Alias: characterIds.</td>\n</tr>\n<tr>\n<td><code>improvePrompt</code></td>\n<td>boolean</td>\n<td>No</td>\n<td></td>\n<td>Let the AI rewrite/improve the prompt before generation.</td>\n</tr>\n<tr>\n<td><code>withTranscript</code></td>\n<td>boolean</td>\n<td>No</td>\n<td></td>\n<td>Return a transcript with the generated media.</td>\n</tr>\n<tr>\n<td><code>voiceId</code></td>\n<td>string</td>\n<td>No</td>\n<td></td>\n<td>Voice id when generating media with speech.</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Response:</strong> { success, mediaType, generationOptions, ...generation result with media URLs }.</p>\n","urlObject":{"path":["api","public","v3","generate-media"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"d13e375d-c415-47c6-bec4-3885d47492ff"},{"name":"Buy Credit Pack","id":"45b52a0e-88e9-4850-beeb-b6be7db54cbe","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"key","value":"YOUR_REVID_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"source\": \"auto_topup\"\n}","options":{"raw":{"language":"json"}}},"url":"https://www.revid.ai/api/public/v3/buy-credit-pack","description":"<p>Charge the saved payment method for a credit pack. Used for automated top-up flows.</p>\n<h3 id=\"request-body\">Request body</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Type</th>\n<th>Required</th>\n<th>Allowed</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>source</code></td>\n<td>string</td>\n<td>Yes</td>\n<td><code>auto_topup</code></td>\n<td>Must be \"auto_topup\".</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Response:</strong> Invoice metadata for the purchase.</p>\n","urlObject":{"path":["api","public","v3","buy-credit-pack"],"host":["https://www.revid.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"45b52a0e-88e9-4850-beeb-b6be7db54cbe"}],"variable":[{"key":"baseUrl","value":"https://www.revid.ai"},{"key":"apiKey","value":"YOUR_REVID_API_KEY"},{"key":"webhookUrl","value":"https://your-server.com/revid/webhook"},{"key":"spotifyTrackUrl","value":"https://open.spotify.com/track/5Cp75TUMrHF6c8xbhdligS?si=215888ce8b784bc9"},{"key":"sourceUrl","value":"https://cdn.revid.ai/uploads/1771944925512-video.mp4"},{"key":"audioToVideoSourceUrl","value":"https://www.youtube.com/watch?v=ip30oRP9BP0"},{"key":"avatarUrl","value":"https://cdn.revid.ai/ai-gen/chSmd-WtE.jpg"},{"key":"backgroundVideoUrl","value":"https://cdn.revid.ai/backgrounds/minecraft/color-upscaled.mp4"},{"key":"productImageUrl","value":"https://cdn.revid.ai/uploads/1771944959344-image.png"},{"key":"projectId","value":"REPLACE_WITH_PROJECT_ID"},{"key":"videoUrl","value":"https://cdn.revid.ai/uploads/your-video.mp4"},{"key":"channelName","value":"Main Channel"},{"key":"characterId","value":"REPLACE_WITH_CHARACTER_ID"}]}