Skip to main content
POST
Create TikTok Slideshow
Try it out! Use the API playground on the right to test the TikTok Slideshow endpoint directly.

Overview

TikTok Slideshow videos combine multiple images or video clips with text overlays, music and, optionally, an avatar that narrates your script on camera over the slides. Perfect for:
  • Storytelling with visual elements
  • Product showcases with descriptions
  • Educational content with slides
  • Social media posts with multiple images
  • Presentation-style videos
Each slide can contain up to 10 text elements with custom positioning, styling, and animations.

Endpoint


Required Fields

array
required
Array of slide objects for the slideshow (1-50 slides). Each slide contains a media ID and optional text overlays.

Optional Fields

string
Project name (1-100 characters). If not provided, a name will be auto-generated.
string
What the avatar says over the slides (max 10,000 characters). Requires avatarId, and avatarId requires it.
string
Avatar ID from /v1/avatar/list (max 30 characters). The avatar narrates the script on camera, keyed over the slides. Its voice is generated together with the picture, so no voice ID is needed. Requires script.
string
deprecated
Deprecated, not used. A voiceover without an avatar is not available: sending voiceId without avatarId returns an error, and with avatarId it is ignored.
object
deprecated
Deprecated, not used. These voice settings applied to the voiceover without an avatar, which is not available. They are ignored.
string
Background music ID from /v1/music/list (max 30 characters)
string
Webhook URL for status notifications (max 500 characters, must be HTTPS)
object
Custom metadata object (max 5KB JSON)

Request Examples

Basic Slideshow

Advanced with Avatar and Music


Response


Webhook Notification

When your video is ready, we’ll POST to your webhook URL (if configured):
Webhook Payload

Best Practices

Text Positioning

Canvas dimensions depend on aspect ratio. For 9:16 (1080x1920), ensure coordinates are within bounds.

Slide Duration

Keep slides between 2-5 seconds for optimal engagement.

Text Readability

Use high contrast colors and appropriate font sizes (24-48px) for mobile viewing.

Image Quality

Use high-resolution images (1080px width minimum) for best results.

Coordinate System

The coordinate system for text positioning varies by aspect ratio: Example: For 9:16 format (1080x1920), a text box with x: 100, y: 150, width: 880, height: 100 creates a full-width text near the top.

Error Handling


Next Steps

List Videos

View all your created videos

Video Details

Check your video processing status

Webhooks Guide

Learn how to handle webhook notifications

UGC Ads

Create UGC-style advertisement videos

Authorizations

x-api-key
string
header
required

Body

application/json
slides
object[]
required

Array of slides (1-50 slides). Each slide contains a media ID and optional text elements.

Required array length: 1 - 50 elements
name
string

Project name (1-100 characters). If not provided, a name will be auto-generated.

Required string length: 1 - 100
script
string

Script the avatar says over the slides (max 10,000 characters). Requires avatarId, and avatarId requires it.

Maximum string length: 10000
avatarId
string

Avatar ID from /v1/avatar/list (max 30 characters). The avatar narrates the script on camera, keyed over the slides; its voice is generated together with the picture. Requires script.

Maximum string length: 30
voiceId
string
deprecated

Deprecated, not used. A voiceover without an avatar is not available: sending voiceId without avatarId returns an error, and with avatarId it is ignored (the avatar's voice comes with its video).

Maximum string length: 30
musicId
string

Music ID from /v1/music/list (max 30 characters)

Maximum string length: 30
audio
object
deprecated

Deprecated, not used: these voice settings applied to the voiceover without an avatar, which is not available. Ignored.

webhook
string

HTTPS URL for status notifications (max 500 characters)

Maximum string length: 500
metadata
object

Custom metadata object (max 5KB)

Response

TikTok Slideshow created successfully

success
boolean
data
object
message
string