355890b6b4cc
Create new content
Generate new content based on resources, topic, feed selections, researches, YouTube channels, or linked podcast episodes. Use video metadata fields (titlePrompt, descriptionPrompt, thumbnailImagePrompt, introImagePrompt, voices, publishTargets, format) when outputType is video. Video requests ignore the generic duration field if it is provided. Set isScheduled or templateMode to create recurring templates instead of immediate processing.
Request body
Topic for content generation (alternative to resources, feedSelections, or researches)
Array of research IDs to include as text resources (max 10)
Array of project IDs to use as context for generation (max 10)
Optional HTTP or HTTPS PNG/JPG image URL for video, infographic, and slide_deck requests. Any source dimensions are accepted, but the image must be fully opaque and no larger than 5 MB; it is normalized to an opaque 200x50 PNG using the same rules as a project image. When supplied, it overrides the project logo for this request while project context and branding colors still apply. When omitted, the project logo and then the default logo are used.
YouTube channel IDs already connected to the account to use as sources
Completed audio request IDs to reuse as podcast episode sources (max 10)
Instructions or query for content generation
Type of output content to generate
Duration preference for audio and slide deck generation. Ignored for video requests.
For video, accepted values are explainer, short, and cinematic (defaults to explainer). cinematic video requests cost 100 credits. For briefing_doc, accepted values are text, html, and pdf (defaults to pdf). Ignored for other output types.
Style of the generated content. For audio/text, use one of: deep dive, brief, critique, debate. For video, any custom style text is accepted (defaults to classic when omitted).
HTTPS URL to optional intro music (.mp3, .wav, or .m4a) mixed at lower volume at the start of the podcast
Whether to include citations (PRO only)
When true, continue processing even if some URL resources fail to import (paywall/restrictions). The request fails only if none of the provided resources are successfully imported.
Infographic orientation (defaults to landscape)
Infographic detail level (defaults to standard)
Slide deck format (defaults to detailed). Length is controlled via the standard duration field (short, default, long). Slide deck prompt uses the main text field.
Difficulty level for quiz outputs (defaults to medium). Quiz prompt uses the main text field.
Optional data to include in webhooks (maximum 500 characters)
Existing request ID to relate this request to (must belong to the same token)
Notebook ID for enterprise clients
Language for content generation
Schedule the content generation for a specific time
Podcast show ID to associate this content with
Optional episode title when attaching to a podcast show
Custom title to use for generated video outputs. When provided, overrides the automatically generated title.
Prompt to guide the generated video title
Prompt to guide the generated video description
Prompt to control the generated thumbnail image for video outputs
Prompt to control the intro image for video outputs
Primary custom voice id from /content/GetVoices. Use the numeric id value, not the voice name.
Secondary custom voice id from /content/GetVoices. Requires voice1.
Create a recurring schedule instead of a single request
Number of times per day to run when isScheduled is true
Optional end date for recurring schedules (requires isScheduled true)
Response
Request accepted