lowkey viral

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. 2. Create an API key from the dashboard: https://lowkeyviral.com/dashboard/api-keys 3. Set the key as an environment variable:

   export LOWKEY_VIRAL_API_KEY="lkv_sk_your_key_here"
   

API keys are prefixed with lkv_sk_ and are shown only once at creation time.

What You Can Create

Grid Videos (2x2 grid)

Photo Slideshows (carousel)

Authentication

All API requests go to https://lowkeyviral.com/api/v1/ and require the API key as a Bearer token:

Authorization: Bearer $LOWKEY_VIRAL_API_KEY

Rate Limits

Workflow: Create a Grid Video

Step 1 — Generate AI Briefs (2 credits)

curl -s -X POST https://lowkeyviral.com/api/v1/briefs \
  -H "Authorization: Bearer $LOWKEY_VIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A travel app for Gen-Z backpackers"}'

Returns 5 briefs. Pick the best one and note its id.

Step 2 — Generate Images (4-8 credits)

curl -s -X POST https://lowkeyviral.com/api/v1/briefs/BRIEF_ID/generate \
  -H "Authorization: Bearer $LOWKEY_VIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_model": "z_image_turbo"}'

Image models and costs per image:

Grid briefs always have 4 images.

Step 3 — Render Video (1 credit)

curl -s -X POST https://lowkeyviral.com/api/v1/briefs/BRIEF_ID/render \
  -H "Authorization: Bearer $LOWKEY_VIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"design": "default", "soundtrack": "City Sunshine"}'

Returns {"render_id": "..."}.

Step 4 — Poll Until Done (0 credits)

curl -s https://lowkeyviral.com/api/v1/briefs/BRIEF_ID/render/RENDER_ID/progress \
  -H "Authorization: Bearer $LOWKEY_VIRAL_API_KEY"

Poll every 2-3 seconds. Responses:

Shortcut — One-Call Grid Video

Create a manual brief with render: true to do everything in one request:

curl -s -X POST https://lowkeyviral.com/api/v1/briefs/manual \
  -H "Authorization: Bearer $LOWKEY_VIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "hook": "these coffee shops are insane",
    "title": "Best Coffee Shops",
    "render": true,
    "design": "default",
    "soundtrack": "City Sunshine",
    "images": [
      {"title": "Cafe A", "description": "A cozy minimalist cafe with latte art"},
      {"title": "Cafe B", "description": "Industrial style coffee shop with exposed brick"},
      {"title": "Cafe C", "description": "Hidden garden cafe with hanging plants"},
      {"title": "Cafe D", "description": "Rooftop cafe with city skyline view"}
    ],
    "image_model": "z_image_turbo"
  }'

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)

curl -s -X POST https://lowkeyviral.com/api/v1/briefs \
  -H "Authorization: Bearer $LOWKEY_VIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A skincare brand for 20-somethings", "type": "slideshow", "slide_count": 6}'

Parameters:

Step 2 — Generate Images (1-2 credits per slide)

curl -s -X POST https://lowkeyviral.com/api/v1/briefs/BRIEF_ID/generate \
  -H "Authorization: Bearer $LOWKEY_VIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_model": "z_image_turbo"}'

Images are generated in portrait 9:16 orientation automatically.

Step 3 — Render Slides (1 credit, synchronous)

curl -s -X POST https://lowkeyviral.com/api/v1/briefs/BRIEF_ID/render \
  -H "Authorization: Bearer $LOWKEY_VIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"caption_style": "classic_bold"}'

Returns finished slides immediately (no polling needed):

{
  "slides": [
    {"index": 0, "url": "https://...slide-0.jpg"},
    {"index": 1, "url": "https://...slide-1.jpg"}
  ]
}

Shortcut — One-Call Slideshow

curl -s -X POST https://lowkeyviral.com/api/v1/briefs/manual \
  -H "Authorization: Bearer $LOWKEY_VIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "slideshow",
    "caption_style": "classic_bold",
    "render": true,
    "images": [
      {"title": "Step 1", "description": "Woman applying cleanser, soft morning light"},
      {"title": "Step 2", "description": "Serum dropper on clear skin, close-up"},
      {"title": "Step 3", "description": "Moisturizer application, dewy skin glow"}
    ],
    "image_model": "z_image_turbo"
  }'

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:

# 1. Get presigned upload URL
curl -s -X POST https://lowkeyviral.com/api/v1/uploads \
  -H "Authorization: Bearer $LOWKEY_VIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content_type": "image/jpeg"}'
Response: {"upload_url": "https://...", "file_url": "https://...", ...}
2. Upload the file (max 10 MB)
curl -X PUT "UPLOAD_URL" \
  -H "Content-Type: image/jpeg" \
  --data-binary @photo.jpg
3. Use file_url in your brief

Supported types: image/jpeg, image/png, image/webp.

Checking Account & Credits

curl -s https://lowkeyviral.com/api/v1/account \
  -H "Authorization: Bearer $LOWKEY_VIRAL_API_KEY"

Returns: {"credits": 42, "plan_type": "PRO", "next_reset_date": "..."}

Listing & Managing Briefs

# List all briefs (paginated)
curl -s "https://lowkeyviral.com/api/v1/briefs?limit=20" \
  -H "Authorization: Bearer $LOWKEY_VIRAL_API_KEY"
Filter by type
curl -s "https://lowkeyviral.com/api/v1/briefs?type=slideshow" \
  -H "Authorization: Bearer $LOWKEY_VIRAL_API_KEY"
Get single brief
curl -s https://lowkeyviral.com/api/v1/briefs/BRIEF_ID \
  -H "Authorization: Bearer $LOWKEY_VIRAL_API_KEY"
Delete a brief
curl -s -X DELETE https://lowkeyviral.com/api/v1/briefs/BRIEF_ID \
  -H "Authorization: Bearer $LOWKEY_VIRAL_API_KEY"

Credit Costs Summary

| Operation | Grid | Slideshow | |-----------|------|-----------| | AI briefs (5 returned) | 2 | 2 | | Manual brief | 0 | 0 | | Images (z_image_turbo) | 4 total | 1/image | | Images (p_image) | 8 total | 2/image | | Images (flux_2_dev) | 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

Slideshow Caption Styles

Soundtracks (Grid Only)

Image Models

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

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. 2. Create an API key from the dashboard: https://lowkeyviral.com/dashboard/api-keys 3. Set the key as an environment variable:

   export LOWKEY_VIRAL_API_KEY="lkv_sk_your_key_here"
   

API keys are prefixed with lkv_sk_ and are shown only once at creation time.