API Crear clave

Imágenes

Fotos UGC

Fotos espontáneas con el producto en la mano, como hechas con el teléfono, a partir de una sola foto de producto. Sin texto, puro estilo UGC.

Desde
10 crpor anuncio
Endpoint
POST /api/v1/studio/ugc_fotos/runs
Id del flujo
ugc_fotos

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/studio/ugc_fotos/estimate \
  -H "Authorization: Bearer $STAGLIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "card": "ugc_street",
    "media": {
      "product": ["'"$MEDIA_ID"'"]
    }
  }' | 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/studio/ugc_fotos/runs \
  -H "Authorization: Bearer $STAGLIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "card": "ugc_street",
    "media": {
      "product": ["'"$MEDIA_ID"'"]
    },
    "max_credits": '"$PRICE"'
  }')

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

# 3. Espera a que termine.
while :; do
  STATUS=$(curl -s "https://staglight.ai/api/v1/studio/ugc_fotos/runs/$ID" -H "Authorization: Bearer $STAGLIGHT_API_KEY" | jq -r .status)
  case "$STATUS" in succeeded|partial|failed) break ;; esac; sleep 10
done

# 4. Descarga todos los archivos en un zip.
curl -s -L -o result.zip "https://staglight.ai/api/v1/studio/ugc_fotos/runs/$ID/outputs.zip" -H "Authorization: Bearer $STAGLIGHT_API_KEY"

Cuánto cuesta

PlantillaFinal, mejor textoBorrador, rápido y barato
En la calle18 cr10 cr
Rutina en el baño18 cr10 cr
En el coche18 cr10 cr
En la cocina18 cr10 cr
Bolsa del gimnasio18 cr10 cr
Unboxing18 cr10 cr
Selfie en el espejo18 cr10 cr
Piscina / verano18 cr10 cr

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

Entradas

NombreTipoValores
cardobligatorioLa plantilla string ugc_street, ugc_bathroom, ugc_car, ugc_kitchen, ugc_gym, ugc_unboxing, ugc_mirror, ugc_pool
media.productobligatorioFoto del producto media id[]
media.sceneReferencia de escena media id[]
inputs.handMano enum , man, woman
inputs.notesIndicaciones extra (opcional) string
inputs.resolutionResolución enum 1K, 2K, 4K
inputs.video_qualityCalidad del vídeo (Animar) enum fast, best
inputs.nicheNicho / categoría string
inputs.descriptionDescripción del producto y argumentos de venta string
qualityCalidad enum final, draft
aspectFormato enum 9:16, 4:5, 1:1

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