API Get key

Images

Product Image Studio

One product photo, a full store carousel

From
10 crper ad
Endpoint
POST /api/v1/studio/carrusel/runs
Workflow id
carrusel

Real outputs of this workflow.

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/carrusel/estimate \
  -H "Authorization: Bearer $STAGLIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "card": "hero",
    "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/carrusel/runs \
  -H "Authorization: Bearer $STAGLIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "card": "hero",
    "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/carrusel/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/carrusel/runs/$ID/outputs.zip" -H "Authorization: Bearer $STAGLIGHT_API_KEY"

What it costs

TemplateFinal, best textDraft, fast and cheap
Hero / Packshot18 cr10 cr
Before / After18 cr10 cr
Handle Objections18 cr10 cr
Ingredients / What's Inside18 cr10 cr
How To Use18 cr10 cr
Risk Reversal / Guarantee18 cr10 cr
Testimonials / UGC Grid18 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 hero, before_after, objections, ingredients, how_to_use, guarantee, testimonials
media.productrequiredProduct photo media id[]
media.personModel photo media id[]
media.referenceLayout reference media id[]
media.customersReal customer photos media id[]
media.bgsrcrequiredAny image media id[]
inputs.resolutionResolution enum 1K, 2K, 4K
inputs.nicheNiche / category string
inputs.urlWebsite string
inputs.languageLanguage enum auto, en, es, it, de, fr, nl, pl, ...
inputs.descriptionProduct description and key selling points string
inputs.summaryWhat the scan learned (editable) string
inputs.ov_languageLanguage string
inputs.headlineHeadline string
inputs.sublineSubline string
inputs.ratingRating line string
inputs.quoteCustomer quote string
inputs.guarantee_daysGuarantee days int
inputs.bulletsList items (one per line) string
inputs.notesExtra direction 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