Estimate a slideshow's price
Estimate a slideshow's price with the Wavegrain Carousel API: POST /api/v1/slideshows/estimate. Request body, responses and an example request.
POST /api/v1/slideshows/estimate is part of the Carousel API. Every call needs an access key: see Authentication.
Needs the read permission; spends nothing. The most one slideshow with these settings (or one copy, with copyPost) can cost, split by words, photos and AI images per slide, with the account's balance and the key's daily limit. Send at least credits as maxCredits when you make it.
Request body
| Field | Type | Required | Notes |
|---|---|---|---|
formatId | string | no | A saved format from list_formats. Default: your active brand with the settings below. |
brandId | string | no | Only without formatId: the brand to write for. Default: your active brand. |
groupId | string | no | Only without formatId: an account group (list_accounts) whose notes shape the script. |
slideCount | integer | no | Only without formatId: how many slides. Default 6. |
structure | "hook-proof-cta" | "listicle" | "before-after" | "educational" | "story" | "quote" | "ranking" | no | The kind of post: hook-proof-cta (Hook, proof, then a clear call to action); listicle (A numbered list); before-after (A transformation or comparison); educational (Teaches one idea step by step); story (A first-person narrative arc); quote (Quote or affirmation cards); ranking (Tier list or best-to-worst ranking); get_playbook gives each one's slides. Default: picked from the topic. |
outputProfile | "clean-square" | "clean-portrait" | "instagram-feed" | "instagram-feed-3-4" | "clean-vertical" | "tiktok" | "instagram-reels" | no | Slide size, width:height: clean-square 1:1, clean-portrait 4:5, instagram-feed 4:5 (default), instagram-feed-3-4 3:4, clean-vertical 9:16, tiktok 9:16, instagram-reels 9:16. |
styleId | "clean-ugc" | "clean-social" | "quiet-editorial" | "bold-statement" | "mens-looksmaxxing" | "comparison-grid" | "study-notes" | "aesthetic-soft" | "accent-pop" | no | Text look: clean-ugc (Effortless lowercase native look); clean-social (Bold sans in normal case with a strong shadow); quiet-editorial (Serif); bold-statement (Big all-caps hook over a dramatic scene); mens-looksmaxxing (Dark portrait); comparison-grid (Before-after or best-worst decks); study-notes (Small clean caption low on a desk/flatlay); aesthetic-soft (Airy scene); accent-pop (Clean sans with a warm accent color). |
hook | string | no | The cover's hook line, or the idea for it, in the brand's voice. |
ctaCardId | string | no | A CTA card from get_brand to close with. |
photosOnly | boolean | no | true: no AI image, so only the script costs; a slide no photo fits stays empty. |
copyPost | object | no | Price one copy_post call instead, with the AI images it may make. |
Example request
curl -X POST https://wavegrain.com/api/v1/slideshows/estimate \
-H "Authorization: Bearer $WAVEGRAIN_KEY" -H "Content-Type: application/json" \
-d '{"slideCount":6,"outputProfile":"instagram-feed"}'
Responses
| Status | Meaning |
|---|---|
| 200 | The price. |
| 400 | The body is not valid. |
| 401 | No access key, or an unknown, revoked or expired one |
| 403 | The key lacks the permission, or the account has no active plan |
| 404 | No such brand, format or group of yours. |
| 429 | Too many requests for the key or the account |
| 500 | Something went wrong on Wavegrain's side; try again, and send the request id if it keeps failing. |
A successful answer:
{
"credits": 14,
"scriptCredits": 4,
"photoSourcingCredits": 2,
"imageCredits": 8,
"slides": [
{
"role": "hook",
"credits": 2
},
{
"role": "content",
"credits": 2
}
],
"balance": 120,
"dailyCreditCap": 50,
"usedLast24h": 6
}
More in the Carousel API
- Make a slideshow from a topic:
POST /api/v1/slideshows - List slideshows:
GET /api/v1/slideshows - Make a slideshow in a post's look:
POST /api/v1/slideshows/copies - Follow a slideshow job:
GET /api/v1/jobs/{id} - Get a slideshow:
GET /api/v1/slideshows/{id} - Download a slideshow:
POST /api/v1/slideshows/{id}/export - All endpoints
Something wrong or missing? Write to support@wavegrain.com.