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

FieldTypeRequiredNotes
formatIdstringnoA saved format from list_formats. Default: your active brand with the settings below.
brandIdstringnoOnly without formatId: the brand to write for. Default: your active brand.
groupIdstringnoOnly without formatId: an account group (list_accounts) whose notes shape the script.
slideCountintegernoOnly without formatId: how many slides. Default 6.
structure"hook-proof-cta" | "listicle" | "before-after" | "educational" | "story" | "quote" | "ranking"noThe 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"noSlide 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"noText 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).
hookstringnoThe cover's hook line, or the idea for it, in the brand's voice.
ctaCardIdstringnoA CTA card from get_brand to close with.
photosOnlybooleannotrue: no AI image, so only the script costs; a slide no photo fits stays empty.
copyPostobjectnoPrice 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

StatusMeaning
200The price.
400The body is not valid.
401No access key, or an unknown, revoked or expired one
403The key lacks the permission, or the account has no active plan
404No such brand, format or group of yours.
429Too many requests for the key or the account
500Something 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
}

Something wrong or missing? Write to support@wavegrain.com.