Aituber API

AITuber API

Create AI videos from a script or idea. From 15-second Shorts to 20-minute long-form content. The API handles voice narration (1,300+ voices, any language), AI-generated visuals, word-synced captions, MP4 export, and publishing to YouTube, TikTok, Instagram, Facebook, Threads, and X.

Base URL: https://app.aituber.app/api/v1 OpenAPI spec: https://app.aituber.app/api/v1/openapi.json API docs: https://aituber.app/api

Tip: The endpoint reference and credit costs below are generated from the live API definition, so they match the current API. For interactive exploration and response schemas, use the OpenAPI spec or the docs page.

Authentication

All endpoints except GET /voices require a Bearer token. Create an API key in the AITuber dashboard at https://app.aituber.app/dashboard/api-keys. Keys start with ak_.

Authorization: Bearer <AITUBER_API_KEY>

Store the key in the AITUBER_API_KEY environment variable.

Complete Workflow

AITuber supports two common flows after generation:

• Export flow: pick voice, generate video, poll status, export, download
• Publish flow: pick voice, generate video, poll status, list channels, publish, poll publication status

Step 1: Pick a voice

curl "https://app.aituber.app/api/v1/voices?gender=male&accent=American"

No auth required. Returns an array of voice objects. Use the id field as voiceId when generating, or omit voiceId to use the default voice.

Step 2: Generate a video

From a script (you write the narration):

curl -X POST "https://app.aituber.app/api/v1/videos/generate" \
  -H "Authorization: Bearer $AITUBER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "script": "The human brain contains roughly 86 billion neurons. Every thought, memory, and emotion is the result of electrical signals racing through this incredible network.",
    "voiceId": "VOICE_ID_FROM_STEP_1",
    "imageStyleId": "cinematic",
    "aspectRatio": "9:16"
  }'

From an idea (AI writes the script):

curl -X POST "https://app.aituber.app/api/v1/videos/generate" \
  -H "Authorization: Bearer $AITUBER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "script": "5 mind-blowing facts about black holes",
    "inputType": "idea",
    "expectedDurationSeconds": 60
  }'

Returns { "videoId": "uuid", "status": "pending" }.

Video types (all use this same endpoint):

1. Faceless narration (images) - Default. AI images with Ken Burns animation. Just send a script or idea.
2. Faceless narration (video clips) - AI video clips. Set mediaType: "video".
3. Stock footage - Real stock footage matched to narration. Set mediaType: "stock".
4. Skeleton template - Viral "what happens if..." X-ray style. Set templateId: "skeleton". The template handles mediaType and style.
5. Character template - Character-driven stories. Set templateId: "character", inputType: "idea". Only idea mode (AI writes the script for character consistency).

For visual control in script mode, add instructions in brackets: [A dark forest at night] The wind howled through the trees. Each [bracket] tells the AI what to show for that scene.

Step 3: Poll for completion

curl "https://app.aituber.app/api/v1/videos/VIDEO_ID" \
  -H "Authorization: Bearer $AITUBER_API_KEY"

Poll every 5-10 seconds. Generation typically takes 1-3 minutes. Wait until status is completed (or failed).

Step 4: Export to MP4

curl -X POST "https://app.aituber.app/api/v1/exports" \
  -H "Authorization: Bearer $AITUBER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "videoId": "VIDEO_ID", "resolution": "1080p" }'

Exporting is free. Requires an active paid subscription. Poll GET /videos/VIDEO_ID and check exportStatus until it is completed (typically 30 seconds to 5 minutes).

Step 5: Download the MP4

curl "https://app.aituber.app/api/v1/exports/download?videoId=VIDEO_ID" \
  -H "Authorization: Bearer $AITUBER_API_KEY"

Returns { "url": "https://...", "videoId": "..." }. The URL is a signed temporary link that expires in 2 minutes. Download immediately.

Step 6: Publish to connected channels

Publishing requires channels to already be connected in the AITuber dashboard and an active paid subscription with the Publish feature. If the video is not exported yet, the API starts the export automatically (no need to call POST /exports first).

List channels:

curl "https://app.aituber.app/api/v1/channels" \
  -H "Authorization: Bearer $AITUBER_API_KEY"

Publish to YouTube, TikTok, Instagram, Facebook, Threads, and X in one call:

curl -X POST "https://app.aituber.app/api/v1/publications" \
  -H "Authorization: Bearer $AITUBER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "videoId": "VIDEO_ID",
    "caption": "New short is live",
    "shortCaption": "New short is live. What do you think?",
    "publishNow": true,
    "channels": [
      {
        "channelId": "YOUTUBE_CHANNEL_ID",
        "title": "5 Mind-Blowing Facts",
        "tags": ["facts", "science"],
        "categoryId": "27"
      },
      {
        "channelId": "TIKTOK_CHANNEL_ID",
        "tiktokPrivacyStatus": "public",
        "isAiGenerated": true
      },
      {
        "channelId": "INSTAGRAM_CHANNEL_ID",
        "instagramPlacement": "reels"
      },
      { "channelId": "FACEBOOK_CHANNEL_ID" },
      { "channelId": "THREADS_CHANNEL_ID" },
      { "channelId": "X_CHANNEL_ID" }
    ]
  }'

Per-platform channel settings:

• YouTube: title, tags, categoryId, madeForKids
• TikTok: tiktokPrivacyStatus, allowDuet, allowStitch, isAiGenerated
• Instagram: instagramPlacement, shareToFeed
• TikTok and X: allowComment. No other platform lets us change it.

Poll publication status:

curl "https://app.aituber.app/api/v1/publications/PUBLICATION_ID" \
  -H "Authorization: Bearer $AITUBER_API_KEY"

Poll every 10-15 seconds until the upload reaches a stable state such as published, scheduled, or failed.

Endpoints Reference

GET /voices

Returns all available AI voices for video narration, sorted by popularity. No auth required.

GET /voices/cloned

Returns the voices you cloned in the AITuber dashboard.

GET /avatars

Returns every avatar you can use for talking-head videos: built-in avatars available to everyone, plus your own characters.

GET /elements

Returns your saved elements: people/characters, products/props, and places, plus the built-in ones.

POST /elements

Saves a reusable element (a person/character, product/prop, or place) with a reference photo.

POST /uploads

Gets a media file into your AITuber library and returns an assetId you can pass to other endpoints.

GET /ugc/reactions

Returns short clips of a person reacting to camera, split into system (the built-in library) and custom (reactions you generated).

POST /ugc/reactions

Generates a short clip of your character reacting to camera, using image-to-video AI.

GET /ugc/reactions/{id}

Returns a reaction you generated.

POST /ugc/videos

Builds a finished UGC-style hook video: a person reaction clip with your hook text on top, optionally followed by your product demo video.

POST /music

Generates an original song from a text prompt using AI.

GET /music

Lists tracks in your music library: songs you generated with POST /music and audio you uploaded with POST /uploads (purpose music).

GET /music/{id}

Returns a song you generated.

POST /music-videos

Builds a music video: your song plus AI visuals, synced captions, and an optional waveform.

POST /ideas

Generates a list of specific, viral-style video topic ideas for a niche or audience.

POST /scripts

Generates 2 distinct narration script variations for a topic, sized to your target duration.

GET /image-styles

Returns every image style you can use as imageStyleId in POST /videos/generate (when mediaType is images): the built-in styles, curated template styles (ids like medical-xray, made for templateId: "medical"), plus any custom styles created in the AITuber dashboard.

GET /caption-styles

Returns every caption style you can use as captionStyleId in POST /videos/generate: the built-in styles plus any custom styles created in the AITuber dashboard.

POST /videos/generate

Starts generating a new AI video from a script or idea.

GET /videos

Returns all videos for your organization, sorted newest first.

GET /videos/{id}

Returns details for a single video.

DELETE /videos/{id}

Permanently deletes a video and its generated assets.

GET /clip-models

Returns the AI video models available for standalone clip generation, with their capabilities (text-to-video, image-to-video, reference images), supported aspect ratios, resolutions, duration limits, and credit cost per second by resolution.

POST /clips

Starts generating a single AI video clip (1-30 seconds) from a text prompt, an image, or both.

GET /clips

Returns your standalone AI clips, newest first.

GET /clips/{id}

Returns a clip with its generation status.

POST /exports

Starts rendering a completed video into a downloadable MP4 file.

GET /exports/download

Returns a temporary signed URL to download the rendered MP4 file for a video.

GET /channels

Returns all connected social media channels (YouTube, TikTok, Instagram, Facebook, Threads, and X) for your organization.

POST /publications

Publishes a completed video to one or more connected social media channels (YouTube, TikTok, Instagram, Facebook, Threads, and X).

GET /publications/{publicationId}

Returns the current status of a publication.

DELETE /publications/{publicationId}

Cancels a future scheduled publication before it goes live.

GET /subscription

Returns your current plan and credit balance.

Credit Costs

…(truncated)