Build with the Slidestorm API

curl https://slidestorm.ai/api/v1/accounts \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

# Response:
# {
#   "ok": true,
#   "data": {
#     "accounts": [
#       { "id": "01JT5...", "platform": "tiktok", "username": "mychannel", ... }
#     ]
#   }
# }

curl https://slidestorm.ai/api/v1/image-styles \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

# Response:
# {
#   "ok": true,
#   "data": {
#     "styles": [
#       { "id": "01JT5...", "name": "cinematic", "display_name": "Cinematic", "style_prompt": "..." }
#     ]
#   }
# }

curl https://slidestorm.ai/api/v1/usage \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

# Response:
# {
#   "ok": true,
#   "data": {
#     "credits": {
#       "remaining": 47,
#       "subscription_remaining": 30,
#       "pack_remaining": 17,
#       "has_active_subscription": true
#     },
#     "costs": {
#       "slideshow_generation": 1,
#       "image_generation": 3
#     }
#   }
# }

curl -X POST https://slidestorm.ai/api/v1/slideshows \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-unique-key-1" \
  -d '{
    "prompt": "5 practical coffee brewing tips for beginners",
    "slide_count": 5,
    "background_option": "generate",
    "image_style_id": "01JT5..."
  }'

# You can also use "custom_image_style" instead of "image_style_id":
#   "custom_image_style": "warm cinematic lighting"

# Response (201):
# {
#   "ok": true,
#   "data": {
#     "slideshow": { "id": "01JT5...", "title": "Generating...", "status": "generating" },
#     "polling": { "endpoint": "/api/v1/slideshows/01JT5...", "status": "generating" }
#   }
# }
#
# Possible 422 errors include:
# - invalid_payload
# - idempotency_key_required
# - invalid_idempotency_key
# - slideshow_create_failed

curl https://slidestorm.ai/api/v1/slideshows/01JT5... \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

# Poll until data.slideshow.status is "completed", "failed", or "timed_out"
# Prefer lifecycle hints for automation:
# - should_poll=true -> keep polling
# - should_poll=false + next_action="create_post" -> call POST /posts
# - should_poll=false + next_action="create_new_slideshow" -> stop and create a new slideshow request
# The response includes generation_summary with per-image progress:
#   "generation_summary": {
#     "total_slides": 5,
#     "completed_images": 3,
#     "failed_images": 0,
#     "pending_images": 2,
#     "missing_images": 0
#   }
# The response also includes diagnostics for timeout analysis:
#   "diagnostics": {
#     "failure_code": null,
#     "timed_out_at": null,
#     "last_progress_at": "2026-04-24T19:03:00.000Z",
#     "timeout_threshold_minutes": 30
#   }
# Do not keep creating new slideshows while should_poll=true.

curl -X POST https://slidestorm.ai/api/v1/posts \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "5 coffee tips you need to know",
    "slideshow_id": "01JT5...",
    "accounts": [{ "id": "YOUR_ACCOUNT_ID" }],
    "external_id": "my-post-abc123",
    "platform_configurations": {
      "tiktok": {
        "post_mode": "MEDIA_UPLOAD"
      }
    }
  }'

# post_mode currently supports MEDIA_UPLOAD only.
# MEDIA_UPLOAD uploads to TikTok inbox; user must publish manually in TikTok app.
# Text is validated before delivery (no auto-truncation):
# - title limit: 90 characters (derived from caption start)
# - description limit: 4000 characters
#
# Response (201):
# {
#   "ok": true,
#   "data": {
#     "post": {
#       "id": "01JT5...",
#       "type": "slideshow",
#       "platform": "tiktok",
#       "status": "pending",
#       "caption": "5 coffee tips you need to know",
#       "scheduled_at": "2026-04-24T19:00:00.000Z",
#       "created_at": "2026-04-24T19:00:00.000Z",
#       "external_id": "my-post-abc123",
#       "accounts": {
#         "total": 1,
#         "states": [
#           { "account_id": "01JT5...", "status": "pending", ... }
#         ]
#       }
#     },
#     "duplicate": false
#   }
# }

curl -X POST https://slidestorm.ai/api/v1/posts/01JT5.../check-status \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

# Use data.status fields to drive automation:
# - post_status
# - provider_status
# - is_terminal
# - is_recoverable
#
# uploaded = sent to TikTok inbox for manual publish
# posted = published/completed