Build with AmpClip.
Generate posts from your approved formats and check the results from your own tools.
Authentication and limits
Base URL: https://ampclip.io/api/v1
Authorization: Bearer st_…
Create a key in Settings → API keys. Keep it on your server; never put it in a public browser bundle.
The current limiter allows 20 requests per 60 seconds per key in each server isolate. At most three slideshows can generate at once per studio. A generation uses one credit.
Check your studio
GET /api/v1/account
Returns workspace_id, name, subscription_tier, credits and next_reset_date.
curl https://ampclip.io/api/v1/account \
-H "Authorization: Bearer $AMPCLIP_API_KEY"Generate a slideshow
POST /api/v1/slideshows/generate
Use recurring_format_id for an approved saved format or its song attachment. Find the ID in your studio’s saved format URL. An optional track_id must already be attached to that format. IDs are 32-character hexadecimal strings.
Optional fields: post_direction (1–1,000 characters), hook (an exact opening, 1–180 characters), language (up to 8 characters), and aspect_ratio (9:16, 4:5 or 1:1).
Do not combine recurring_format_id with format_id, archetype, song_photo_recipe or additional_context. Legacy generation without recurring_format_id is retired.
Returns HTTP 202 with slideshow_id and status: "processing". This creates an inbox draft with a frozen revision. Review and approve it for delivery; select the sound and publish in TikTok.
curl https://ampclip.io/api/v1/slideshows/generate \
-H "Authorization: Bearer $AMPCLIP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"recurring_format_id":"YOUR_APPROVED_FORMAT_ID","post_direction":"A new take on leaving your hometown"}'Read the result
GET /api/v1/slideshows/{id}/status
Returns slideshow_id, status, video_status, hook, caption, hashtags, slideshow_images, video_url, archetype, format_id, error and created_at.
Status may be draft, generating, rendering, completed or failed. Check slideshow_images for the rendered slides. video_url is present only when a video export exists.
Handle errors
Errors use { "error": "A readable explanation", "code": "ERROR_CODE" }.
401 UNAUTHORIZED: check your key.
402 INSUFFICIENT_CREDITS: check Billing.
404 NOT_FOUND: check the ID and studio.
422 VALIDATION_ERROR: fix the fields described in error.
422 LEGACY_GENERATION_RETIRED: supply recurring_format_id.
429 RATE_LIMITED: wait for the Retry-After response header.
429 CONCURRENT_LIMIT: wait for an in-progress slideshow to finish.
Other generation validation errors include a readable explanation; check error before retrying. Avoid blindly retrying a generation POST, because another successful request would use another credit.