API Crear clave

Formatos de anuncio

Comparativa

Pantalla dividida: la forma de siempre frente a tu producto, con etiquetas. Sin marcas de otros.

Desde
112 crpor anuncio
Endpoint
POST /api/v1/runs
Id del flujo
us_vs_them

Resultados reales de este flujo.

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": "us_vs_them",
    "options": {"tier": "draft", "aspect": "9:16", "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": "us_vs_them",
    "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": "9:16", "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

Nivel9:164:5
Borrador112 cr112 cr
Estándar220 cr220 cr
Premium270 cr270 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 us_vs_them
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 9:16, 4:5
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