lowkey viral — AI Social Media Video & Slideshow Creator
Create short-form vertical videos and photo carousel slideshows for TikTok, Instagram Reels, and other social platforms using the lowkey viral REST API.
Prerequisites
You need a lowkey viral API key to use this skill.
- 1. Sign up at https://lowkeyviral.com and subscribe to a PRO or ULTIMATE plan.
- Create an API key from the dashboard: https://lowkeyviral.com/dashboard/api-keys
- Set the key as an environment variable:
CODEBLOCK0
API keys are prefixed with lkv_sk_ and are shown only once at creation time.
What You Can Create
Grid Videos (2x2 grid)
- - 1080x1920 vertical MP4 video, 5 seconds, 30fps
- 4 images arranged in a 2x2 grid with a text hook overlay
- Optional background music from 20 CC0-licensed tracks
- 3 layout designs:
default, withCaptions, INLINECODE3
Photo Slideshows (carousel)
- - 2-10 portrait slides (1080x1920) with text overlays
- 3 caption styles:
classic_bold, background_bar, INLINECODE6 - Ready for Instagram carousel posts or TikTok photo mode
Authentication
All API requests go to https://lowkeyviral.com/api/v1/ and require the API key as a Bearer token:
CODEBLOCK1
Rate Limits
- - PRO plan: 10 requests/minute
- ULTIMATE plan: 30 requests/minute
- Progress polling: 60 requests/minute (all plans)
- 429 responses include a
Retry-After header
Workflow: Create a Grid Video
Step 1 — Generate AI Briefs (2 credits)
CODEBLOCK2
Returns 5 briefs. Pick the best one and note its id.
Step 2 — Generate Images (4-8 credits)
CODEBLOCK3
Image models and costs per image:
- -
z_image_turbo — 1 credit/image (fastest) - INLINECODE11 — 2 credits/image (high quality)
- INLINECODE12 — 2 credits/image (highly detailed)
Grid briefs always have 4 images.
Step 3 — Render Video (1 credit)
CODEBLOCK4
Returns {"render_id": "..."}.
Step 4 — Poll Until Done (0 credits)
CODEBLOCK5
Poll every 2-3 seconds. Responses:
- - In progress: INLINECODE14
- Done: INLINECODE15
- Error: INLINECODE16
Shortcut — One-Call Grid Video
Create a manual brief with render: true to do everything in one request:
CODEBLOCK6
Images with description but no url are AI-generated. The response includes a render_id for polling.
Workflow: Create a Photo Slideshow
Step 1 — Generate AI Briefs (2 credits)
CODEBLOCK7
Parameters:
- -
type: must be INLINECODE22 - INLINECODE23 : 4-10 (default 6)
Step 2 — Generate Images (1-2 credits per slide)
CODEBLOCK8
Images are generated in portrait 9:16 orientation automatically.
Step 3 — Render Slides (1 credit, synchronous)
CODEBLOCK9
Returns finished slides immediately (no polling needed):
CODEBLOCK10
Shortcut — One-Call Slideshow
CODEBLOCK11
Response includes slides array immediately. Note: hook is not accepted for slideshows — it is automatically set to the first slide's title.
Uploading Custom Images
If you have your own images, upload them first:
CODEBLOCK12
Supported types: image/jpeg, image/png, image/webp.
Checking Account & Credits
CODEBLOCK13
Returns: INLINECODE30
Listing & Managing Briefs
CODEBLOCK14
Credit Costs Summary
| Operation | Grid | Slideshow |
|---|
| AI briefs (5 returned) | 2 | 2 |
| Manual brief |
0 | 0 |
| Images (z
imageturbo) | 4 total | 1/image |
| Images (p_image) | 8 total | 2/image |
| Images (flux
2dev) | 8 total | 2/image |
| Render | 1 | 1 |
Full AI grid video: 7-11 credits. Full AI slideshow (6 slides): 9-15 credits. Bring your own images: 1 credit to render.
Valid Options
Grid Designs
- -
default — standard 2x2 layout - INLINECODE32 — adds text captions on each image
- INLINECODE33 — edge-to-edge compact grid
Slideshow Caption Styles
- -
classic_bold — white text with black outline - INLINECODE35 — white text on dark semi-transparent bar
- INLINECODE36 — bright green (#00ff88) text with glow effect
Soundtracks (Grid Only)
Advertime, And Just Like That, Blippy Trance, Brewing Potions, City Sunshine, Funshine, Happy Whistling Ukulele, I Guess What I'm Trying to Say, La Citadelle, Lukewarm Banjo, Magical Transition, Martini Sunset, Meditating Beat, Night in Venice, River Meditation, Soundtrack From the Starcourt Mall, Strength of the Titans, Study and Relax, Sun Up Gunned Down, The Celebrated Minuet
Image Models
- -
z_image_turbo — fastest, 1 credit/image - INLINECODE38 — high quality, 2 credits/image
- INLINECODE39 — highly detailed, 2 credits/image
Error Handling
All errors return:
{"error": {"code": "error_code", "message": "Human-readable description"}}
| Status | Code | Meaning |
|---|
| 401 | unauthorized | Invalid or missing API key |
| 403 |
forbidden | PRO or ULTIMATE plan required |
| 402 | insufficient_credits | Not enough credits |
| 422 | validation_error | Bad parameters |
| 404 | not_found | Resource not found |
| 429 | rate_limited | Too many requests (check Retry-After header) |
| 500 | internal_error | Server error |
Data & Trust
- - All requests go to
https://lowkeyviral.com/api/v1/ only. - Your API key is sent as a Bearer token in the Authorization header.
- Uploaded images are stored on AWS S3 (us-east-1).
- Generated videos and slides are hosted on S3 via CloudFront.
- No data is sent to any third-party service beyond lowkeyviral.com.
lowkey viral — AI社交媒体视频与幻灯片制作工具
使用lowkey viral REST API为TikTok、Instagram Reels及其他社交平台创建竖版短视频和照片轮播幻灯片。
前置条件
使用此技能需要lowkey viral API密钥。
- 1. 在 https://lowkeyviral.com 注册并订阅PRO或ULTIMATE套餐。
- 在控制台创建API密钥:https://lowkeyviral.com/dashboard/api-keys
- 将密钥设置为环境变量:
bash
export LOWKEY
VIRALAPI
KEY=lkvsk
yourkey_here
API密钥以lkvsk为前缀,仅在创建时显示一次。
可创建的内容
网格视频(2x2网格)
- - 1080x1920竖版MP4视频,时长5秒,30fps
- 4张图片以2x2网格排列,带有文字钩子覆盖层
- 可选背景音乐,来自20首CC0许可曲目
- 3种布局设计:default(默认)、withCaptions(带字幕)、noSpaces(无间距)
照片幻灯片(轮播)
- - 2-10张竖版幻灯片(1080x1920),带文字覆盖层
- 3种字幕样式:classicbold(经典粗体)、backgroundbar(背景条)、neon_glow(霓虹发光)
- 适用于Instagram轮播帖子或TikTok照片模式
身份验证
所有API请求发送至https://lowkeyviral.com/api/v1/,需要将API密钥作为Bearer令牌:
Authorization: Bearer $LOWKEYVIRALAPI_KEY
速率限制
- - PRO套餐:每分钟10次请求
- ULTIMATE套餐:每分钟30次请求
- 进度轮询:每分钟60次请求(所有套餐)
- 429响应包含Retry-After头部
工作流程:创建网格视频
步骤1 — 生成AI简报(2积分)
bash
curl -s -X POST https://lowkeyviral.com/api/v1/briefs \
-H Authorization: Bearer $LOWKEYVIRALAPI_KEY \
-H Content-Type: application/json \
-d {prompt: 面向Z世代背包客的旅行应用}
返回5个简报。选择最佳的一个并记录其id。
步骤2 — 生成图片(4-8积分)
bash
curl -s -X POST https://lowkeyviral.com/api/v1/briefs/BRIEF_ID/generate \
-H Authorization: Bearer $LOWKEYVIRALAPI_KEY \
-H Content-Type: application/json \
-d {imagemodel: zimage_turbo}
图片模型及每张图片成本:
- - zimageturbo — 1积分/张(最快)
- pimage — 2积分/张(高质量)
- flux2_dev — 2积分/张(高细节)
网格简报始终包含4张图片。
步骤3 — 渲染视频(1积分)
bash
curl -s -X POST https://lowkeyviral.com/api/v1/briefs/BRIEF_ID/render \
-H Authorization: Bearer $LOWKEYVIRALAPI_KEY \
-H Content-Type: application/json \
-d {design: default, soundtrack: City Sunshine}
返回{render_id: ...}。
步骤4 — 轮询直至完成(0积分)
bash
curl -s https://lowkeyviral.com/api/v1/briefs/BRIEFID/render/RENDERID/progress \
-H Authorization: Bearer $LOWKEYVIRALAPI_KEY
每2-3秒轮询一次。响应:
- - 进行中:{type: progress, progress: 0.45, stalled: false, ...}
- 完成:{type: done, url: https://...out.mp4, size: 1234567}
- 错误:{type: error, message: ...}
快捷方式 — 一键网格视频
使用render: true创建手动简报,一次性完成所有操作:
bash
curl -s -X POST https://lowkeyviral.com/api/v1/briefs/manual \
-H Authorization: Bearer $LOWKEYVIRALAPI_KEY \
-H Content-Type: application/json \
-d {
hook: 这些咖啡馆太棒了,
title: 最佳咖啡馆,
render: true,
design: default,
soundtrack: City Sunshine,
images: [
{title: 咖啡馆A, description: 一家舒适的极简主义咖啡馆,有拿铁艺术},
{title: 咖啡馆B, description: 工业风格咖啡馆,裸露砖墙},
{title: 咖啡馆C, description: 隐藏的花园咖啡馆,悬挂植物},
{title: 咖啡馆D, description: 屋顶咖啡馆,城市天际线景观}
],
imagemodel: zimage_turbo
}
带有description但无url的图片将由AI生成。响应中包含用于轮询的render_id。
工作流程:创建照片幻灯片
步骤1 — 生成AI简报(2积分)
bash
curl -s -X POST https://lowkeyviral.com/api/v1/briefs \
-H Authorization: Bearer $LOWKEYVIRALAPI_KEY \
-H Content-Type: application/json \
-d {prompt: 面向20多岁年轻人的护肤品牌, type: slideshow, slide_count: 6}
参数:
- - type:必须为slideshow
- slide_count:4-10(默认6)
步骤2 — 生成图片(每张幻灯片1-2积分)
bash
curl -s -X POST https://lowkeyviral.com/api/v1/briefs/BRIEF_ID/generate \
-H Authorization: Bearer $LOWKEYVIRALAPI_KEY \
-H Content-Type: application/json \
-d {imagemodel: zimage_turbo}
图片自动以竖版9:16方向生成。
步骤3 — 渲染幻灯片(1积分,同步)
bash
curl -s -X POST https://lowkeyviral.com/api/v1/briefs/BRIEF_ID/render \
-H Authorization: Bearer $LOWKEYVIRALAPI_KEY \
-H Content-Type: application/json \
-d {captionstyle: classicbold}
立即返回完成的幻灯片(无需轮询):
json
{
slides: [
{index: 0, url: https://...slide-0.jpg},
{index: 1, url: https://...slide-1.jpg}
]
}
快捷方式 — 一键幻灯片
bash
curl -s -X POST https://lowkeyviral.com/api/v1/briefs/manual \
-H Authorization: Bearer $LOWKEYVIRALAPI_KEY \
-H Content-Type: application/json \
-d {
type: slideshow,
captionstyle: classicbold,
render: true,
images: [
{title: 步骤1, description: 女性涂抹洁面乳,柔和晨光},
{title: 步骤2, description: 精华液滴管在洁净肌肤上,特写},
{title: 步骤3, description: 涂抹保湿霜,水润肌肤光泽}
],
imagemodel: zimage_turbo
}
响应立即包含slides数组。注意:幻灯片不接受hook——它会自动设置为第一张幻灯片的title。
上传自定义图片
如果您有自己的图片,请先上传:
bash
1. 获取预签名上传URL
curl -s -X POST https://lowkeyviral.com/api/v1/uploads \
-H Authorization: Bearer $LOWKEY
VIRALAPI_KEY \
-H Content-Type: application/json \
-d {content_type: image/jpeg}
响应:{uploadurl: https://..., fileurl: https://..., ...}
2. 上传文件(最大10 MB)
curl -X PUT UPLOAD_URL \
-H Content-Type: image/jpeg \
--data-binary @photo.jpg
3. 在简报中使用file_url
支持的类型:image/jpeg、image/p