Content

Create new content

Changed on

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 formats are explainer and short at 50 credits, or cinematic at 100 credits. Supplying voice1 or voice2 adds one 200-credit explicit-voice surcharge to a video request, including when the ID is from the global GetVoices catalogue. Video requests ignore the generic duration field if it is provided. Set isScheduled or templateMode to create recurring templates instead of immediate processing.

post/content/Create

Request

  • Base URL: https://api.autocontentapi.com
  • URL: https://api.autocontentapi.com/content/Create
  • Auth: HTTP bearer

Request body

topicstring

Topic for content generation (alternative to resources, feedSelections, or researches)

researchesstring[]

Array of research IDs to include as text resources (max 10)

projectsstring[]

Array of project IDs to use as context for generation (max 10)

logoUrlstring uri

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.

youtubeChannelsstring[]

YouTube channel IDs already connected to the account to use as sources

podcastEpisodeIdsstring[]

Completed audio request IDs to reuse as podcast episode sources (max 10)

textstring

Instructions or query for content generation. For video, this is the NotebookLM steering prompt and is limited to 5,000 characters.

outputType'audio' | 'text' | 'faq' | 'study_guide' | 'timeline' | 'briefing_doc' | 'quiz' | 'video' | 'infographic' | 'slide_deck' | 'datatable' required

Type of output content to generate

duration'short' | 'default' | 'long'

Duration preference for audio and slide deck generation. Ignored for video requests.

format'explainer' | 'short' | 'cinematic' | 'text' | 'html' | 'pdf'

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.

stylestring

Style of the generated content. For audio/text, use one of: deep dive, brief, critique, debate. For video, NotebookLM preset names (auto-select, classic, whiteboard, kawaii, anime, watercolour, retro print, heritage, or paper-craft) are selected directly; any other value is used as custom style text and is limited to 5,000 characters. Video defaults to classic when omitted.

introMusicUrlstring

HTTPS URL to optional intro music (.mp3, .wav, or .m4a) mixed at lower volume at the start of the podcast

includeCitationsboolean

Whether to include citations (PRO only)

ignorePaywalledResourcesboolean

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.

infographicOrientation'landscape' | 'portrait' | 'square'

Infographic orientation (defaults to landscape)

infographicDetail'concise' | 'standard' | 'detailed'

Infographic detail level (defaults to standard)

slideDeckFormat'detailed' | 'presenter'

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.

quizDifficulty'easy' | 'medium' | 'hard'

Difficulty level for quiz outputs (defaults to medium). Quiz prompt uses the main text field.

callbackDatastring

Optional data to include in webhooks (maximum 500 characters)

relatedIdstring

Existing request ID to relate this request to (must belong to the same token)

notebookIdstring

Owned Private Notebook ID. When present, generation uses that notebook's saved sources and its license's exact dedicated account, follows Private Notebooks capacity instead of content credits, and rejects additional request sources or generic topic/project inputs.

languagestring

Target language for generated content, using an exact value from the supported languages list (for example, Deutsch). For video at the base format price, set language and omit voice1 and voice2. Voice IDs select narration voices but do not translate the generated script.

scheduledOnstring date-time

Schedule the content generation for a specific time

podcastIdstring

Podcast show ID to associate this content with

episodeTitlestring

Optional episode title when attaching to a podcast show

titlestring

Custom title to use for generated video outputs. When provided, overrides the automatically generated title.

titlePromptstring

Prompt to guide the generated video title

descriptionPromptstring

Prompt to guide the generated video description

thumbnailImagePromptstring

Prompt to control the generated thumbnail image for video outputs

introImagePromptstring

Prompt to control the intro image for video outputs

voice1integer

Primary explicit narration voice ID from /content/GetVoices. Use the numeric ID, not the voice name. For video, supplying any catalogue or client-cloned voice ID adds 200 credits once per request to the format base price (50 credits for explainer/short or 100 for cinematic). Omit voice1 and voice2 for base pricing. Voice selection does not translate the generated script.

voice2integer

Optional secondary explicit narration voice ID from /content/GetVoices. Requires voice1. The 200-credit video voice surcharge is per request, not per supplied voice.

isScheduledboolean

Create a recurring schedule instead of a single request

dailyCountinteger

Number of times per day to run when isScheduled is true

scheduleEndDatestring date-time

Optional end date for recurring schedules (requires isScheduled true)

Response

Request accepted

OR
OR

Changes

  • d1ab3e860c4bRevision changes
    • warning

      the request property's maxLength was set to 5000

    • warning

      the request property's maxLength was set to 5000