API Crear clave

Formatos de anuncio

Mundo en miniatura

Tu producto a escala gigante con un mundo diminuto alrededor, en un clip corto con música.

Desde
61 crpor anuncio
Endpoint
POST /api/v1/runs
Id del flujo
miniature_world

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": "miniature_world",
    "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": "miniature_world",
    "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:51:1
Borrador61 cr61 cr61 cr
Estándar151 cr151 cr151 cr
Premium305 cr305 cr305 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 miniature_world
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, 1:1
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