AI Slideshow Video API
Send a category or your own brief. AutoFeed writes the script, generates the images, records the voiceover, burns in the captions and returns a finished faceless video.
What the AI Slideshow API returns
- 28 story categories, or "Write Your Own Story" with a brief of up to 4,000 characters
- 7 image styles and 39 narration languages
- Three length bands: 15 to 30 seconds, 45 to 60 seconds, 60 to 90 seconds
- Aspect ratios 9:16, 16:9, 1:1, with optional animated images
One Request
This exact body passes the live API schema and costs 1,200 credits, the same as making it in the dashboard.
curl -X POST https://www.autofeed.ai/api/v1/videos \
-H "Authorization: Bearer $AUTOFEED_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "ai_slideshow",
"input": {
"category": "History Facts",
"topic": "How the Romans built roads that still exist today",
"duration": "45 to 60 seconds",
"substyle": "Painting",
"format": "9:16"
},
"webhookUrl": "https://example.com/webhooks/autofeed",
"idempotencyKey": "order-1042-ai-slideshow"
}'{
"id": "1c9d6c3e-1f5b-4d2e-9c31-2b8b0f0f9a11",
"type": "ai_slideshow",
"status": "processing",
"costInCredits": 1200,
"createdAt": "2026-11-02T12:00:00.000Z"
}{
"id": "1c9d6c3e-1f5b-4d2e-9c31-2b8b0f0f9a11",
"type": "ai_slideshow",
"status": "completed",
"error": null,
"costInCredits": 1200,
"createdAt": "2026-11-02T12:00:00.000Z",
"completedAt": "2026-11-02T12:03:41.000Z",
"url": "https://.../1c9d6c3e-1f5b-4d2e-9c31-2b8b0f0f9a11.mp4"
}Every Input Field
Read from the API's own schema. Unknown fields are rejected with a 400, never silently dropped.
| Field | Type | Default | Notes |
|---|---|---|---|
category | one of 28 values | "Write Your Own Story" | The story type. "Write Your Own Story" makes topic the whole brief, paragraph breaks kept. |
topic | string (max 4000) | - | Optional steer for the script, or the whole brief under "Write Your Own Story". |
substyle | one of 7 values | "Realistic" | |
language | one of 39 values | "English (USA)" | A display name such as "English (USA)", not a language code. |
music | string (max 255) | "none" | |
voice | string | "pNInz6obpgDQGcFmaJgB" | |
captionStyle | one of 14 values | "YouTuber" | |
customCaptions | object | - | Required when captionStyle is "Custom". Any field you leave out comes from the preset. |
captionSize | "Small" | "Medium" | "Large" | "Medium" | |
captionPosition | "Top" | "Center" | "Bottom" | "Bottom" | |
particles | one of 8 values | "None" | |
duration | "15 to 30 seconds" | "45 to 60 seconds" | "60 to 90 seconds" | "15 to 30 seconds" | Price-bearing: longer bands cost more credits. |
format | "9:16" | "16:9" | "1:1" | "9:16" | |
cameraShake | boolean | true | |
animatedImages | boolean | false | Animates each image. Price-bearing and much slower, so it is off by default. |
What It Costs
The API is included with Ultimate and spends the same credits as the dashboard. Ultimate's 180k monthly credits cover about 150 requests like the one above. Rendered files are kept for 14 days.
See every Ultimate size →AI Slideshow API Questions
Can I send my own script?
Use the "Write Your Own Story" category and put your brief or script in topic. The script step works from it instead of from a category prompt.
What changes the price?
The length band and animatedImages. Everything else, such as style, language, captions and music, is free to change. The exact cost of every request comes back in the 202 response.
How is an AI slideshow billed?
From the same credit balance as the dashboard, at the same price per video. The cost is in the 202 response before any work starts, and a failed render refunds it.