API Get key

Ad formats

Claymation ad

A talking clay object tells your product's story in four scenes. You approve the script and the storyboard before paying for clips.

From
253 crper ad
Endpoint
POST /api/v1/runs
Workflow id
claymation

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/runs/estimate \
  -H "Authorization: Bearer $STAGLIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "claymation",
    "options": {"tier": "draft", "aspect": "9:16", "lang": "en"}
  }' | 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/runs \
  -H "Authorization: Bearer $STAGLIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "format": "claymation",
    "product": {
      "name": "Vitamin C serum",
      "description": "A vitamin C serum in a glass dropper bottle",
      "photos": ["'"$MEDIA_ID"'"]
    },
    "options": {"tier": "draft", "aspect": "9:16", "lang": "en"},
    "auto": true,
    "max_credits": '"$PRICE"'
  }')

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

# 3. Wait until it finishes.
while :; do
  STATUS=$(curl -s "https://staglight.ai/api/v1/runs/$ID?wait=30" -H "Authorization: Bearer $STAGLIGHT_API_KEY" | jq -r .status)
  case "$STATUS" in succeeded|failed|canceled|awaiting_approval|needs_attention) break ;; esac
done

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

What it costs

Tier9:164:51:1
Draft253 cr253 cr253 cr
Standard482 cr482 cr482 cr
Premium598 cr598 cr598 cr

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

Inputs

NameTypeAllowed
formatrequiredThe format string claymation
product | product_idrequiredThe product: a saved one, or name, description and photos object | string product_id from POST /api/v1/products, or {name, description, photos}
options.tierTier enum draft, standard, premium
options.aspectShape enum 9:16, 4:5, 1:1
options.langLanguage of the words enum es, en
autoApprove every step within max_credits boolean true, false

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