API Get key

Images

Instagram Page Setup

Build your feed, or clone a competitor's

From
10 crper ad
Endpoint
POST /api/v1/studio/instagram/runs
Workflow id
instagram
instagram
Templates
9
Shape
1:1, 4:5, 9:16
Quality
final, draft

No example of this workflow yet. These are its real settings.

The request

# 0. Upload your file first. Its id goes in the body.
MEDIA_ID=$(curl -s -X POST https://staglight.ai/api/v1/uploads \
  -H "Authorization: Bearer $STAGLIGHT_API_KEY" -F file=@product.jpg | jq -r .id)

# 1. Price it. Free, nothing is charged.
PRICE=$(curl -s -X POST https://staglight.ai/api/v1/studio/instagram/estimate \
  -H "Authorization: Bearer $STAGLIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "card": "ig_lifestyle",
    "media": {
      "product": ["'"$MEDIA_ID"'"]
    }
  }' | jq .credits)
echo "$PRICE"

# 2. Start it. max_credits refuses anything above that price; the Idempotency-Key stops a double charge.
START=$(curl -s -X POST https://staglight.ai/api/v1/studio/instagram/runs \
  -H "Authorization: Bearer $STAGLIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "card": "ig_lifestyle",
    "media": {
      "product": ["'"$MEDIA_ID"'"]
    },
    "max_credits": '"$PRICE"'
  }')

ID=$(echo "$START" | jq -r .id)

# 3. Wait until it finishes.
while :; do
  STATUS=$(curl -s "https://staglight.ai/api/v1/studio/instagram/runs/$ID" -H "Authorization: Bearer $STAGLIGHT_API_KEY" | jq -r .status)
  case "$STATUS" in succeeded|partial|failed) break ;; esac; sleep 10
done

# 4. Download every file in one zip.
curl -s -L -o result.zip "https://staglight.ai/api/v1/studio/instagram/runs/$ID/outputs.zip" -H "Authorization: Bearer $STAGLIGHT_API_KEY"

What it costs

TemplateFinal, best textDraft, fast and cheap
Lifestyle Scene18 cr10 cr
Flatlay18 cr10 cr
Quote / Text Card18 cr10 cr
Benefit Callout18 cr10 cr
Testimonial Post18 cr10 cr
Relatable / Meme18 cr10 cr
Offer / Announcement18 cr10 cr
Profile Picture18 cr10 cr
Highlight Cover18 cr10 cr

Prices from the server at the default settings. The estimate call gives the exact price for your inputs, for free.

Inputs

NameTypeAllowed
cardrequiredThe template string ig_lifestyle, ig_flatlay, ig_quote, ig_benefit, ig_testimonial, ig_meme, ig_offer, ig_pfp, ig_highlight
media.productrequiredProduct photo media id[]
media.competitorCompetitor post media id[]
inputs.headlineExact text (optional) string
inputs.handleHandle (optional) string
inputs.languageLanguage enum auto, en, es, it, de, fr, nl, pl, ...
inputs.resolutionResolution enum 1K, 2K, 4K
inputs.quoteCustomer quote string
inputs.ratingRating line string
inputs.ad_labelShow an "Ad" tag when you copy another post bool
inputs.nicheNiche / category string
inputs.urlWebsite string
inputs.descriptionProduct description and key selling points string
inputs.summaryWhat the scan learned (editable) string
qualityQuality enum final, draft
aspectShape enum 1:1, 4:5, 9:16

Files are media ids from POST /api/v1/uploads. View documentation

Try it by hand

The same workflow runs in the studio, on the same balance. Use it to see the result before you write code.

Sign up to try it

More workflows