API Crear clave

Formatos de anuncio

Imagen con oferta

Una imagen de tu producto en escena. El precio o el descuento los añade la app con texto nítido.

Desde
19 crpor anuncio
Endpoint
POST /api/v1/runs
Id del flujo
offer_static
offer_static
Nivel
draft, standard, premium
Formato
1:1, 4:5, 9:16

Aún no hay un ejemplo de este flujo. Estos son sus ajustes reales.

La solicitud

# 0. Sube antes tu archivo. Su id va en el cuerpo.
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. Pide el precio. Gratis, no se cobra nada.
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": "offer_static",
    "options": {"tier": "draft", "aspect": "1:1", "lang": "es"}
  }' | jq .credits)
echo "$PRICE"

# 2. Inícialo. max_credits rechaza lo que pase de ese precio; el Idempotency-Key evita un cobro doble.
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": "offer_static",
    "product": {
      "name": "Sérum de vitamina C",
      "description": "Un sérum de vitamina C en un frasco de vidrio con gotero",
      "photos": ["'"$MEDIA_ID"'"]
    },
    "options": {"tier": "draft", "aspect": "1:1", "lang": "es"},
    "auto": true,
    "max_credits": '"$PRICE"'
  }')

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

# 3. Espera a que termine.
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. Descarga todos los archivos en un zip.
curl -s -L -o result.zip "https://staglight.ai/api/v1/runs/$ID/outputs.zip" -H "Authorization: Bearer $STAGLIGHT_API_KEY"

Cuánto cuesta

Nivel1:14:59:16
Borrador19 cr19 cr19 cr
Estándar27 cr27 cr27 cr
Premium33 cr33 cr33 cr

Precios del servidor con los ajustes por defecto. La llamada de estimación da el precio exacto para tus entradas, gratis.

Entradas

NombreTipoValores
formatobligatorioEl formato string offer_static
product | product_idobligatorioEl producto: uno guardado, o nombre, descripción y fotos object | string product_id de POST /api/v1/products, o {name, description, photos}
options.tierNivel enum draft, standard, premium
options.aspectFormato enum 1:1, 4:5, 9:16
options.langIdioma de los textos enum es, en
autoAprobar cada paso dentro de max_credits boolean true, false

Los archivos son ids de POST /api/v1/uploads. Ver la documentación

Pruébalo a mano

El mismo flujo funciona en el estudio, con el mismo saldo. Úsalo para ver el resultado antes de escribir código.

Regístrate para probarlo

Más flujos