API Get key

Video

Product link ad

Paste your product link, get a video ad

From
169 crper ad
Endpoint
POST /api/v1/studio/link_ad/runs
Workflow id
link_ad

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/link_ad/estimate \
  -H "Authorization: Bearer $STAGLIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "card": "talk",
    "inputs": {"description": "Your words here"},
    "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/link_ad/runs \
  -H "Authorization: Bearer $STAGLIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "card": "talk",
    "inputs": {"description": "Your words here"},
    "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/link_ad/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/link_ad/runs/$ID/outputs.zip" -H "Authorization: Bearer $STAGLIGHT_API_KEY"

What it costs

TemplateFinal, best text
Talks about it169 cr
Presenter demo169 cr
Scene comes alive169 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 talk, demo, scene
media.productrequiredProduct photo media id[]
inputs.nameProduct name string
inputs.descriptionrequiredWhat it is string
inputs.saySpoken line (optional, turns on voice) string
inputs.motionWhat moves (optional, the video only) string
inputs.genderWho's showcasing it enum man, woman
inputs.setScene enum bathroom, bedroom, kitchen, car, park, street
inputs.shotsShot style enum single, multi
inputs.framingShot distance enum wide, medium, close
inputs.modelModel enum kling, veo_fast, veo_best
inputs.durationDuration enum 5, 10, 15
inputs.soundNative sound bool
inputs.nicheCategory string
inputs.product_infoProduct facts string
qualityQuality enum final
aspectShape enum 9:16, 1:1, 16:9

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