API Crear clave

Vídeo

Vídeo UGC

Una imagen del producto, una línea de descripción, un vídeo

Desde
169 crpor anuncio
Endpoint
POST /api/v1/studio/ugc_video/runs
Id del flujo
ugc_video

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_video/estimate \
  -H "Authorization: Bearer $STAGLIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "card": "demo",
    "inputs": {"description": "Tus palabras aquí"},
    "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_video/runs \
  -H "Authorization: Bearer $STAGLIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "card": "demo",
    "inputs": {"description": "Tus palabras aquí"},
    "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_video/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_video/runs/$ID/outputs.zip" -H "Authorization: Bearer $STAGLIGHT_API_KEY"

Cuánto cuesta

PlantillaFinal, mejor texto
Demo con presentador169 cr
Habla del producto169 cr
La escena cobra vida169 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 demo, talk, scene
media.productImagen del producto media id[]
media.personReferencia de la persona media id[]
media.scene_refReferencia de escena media id[]
media.startFotograma inicial media id[]
media.endFotograma final media id[]
inputs.descriptionobligatorioQué ocurre string
inputs.motionQué se mueve (opcional, solo el vídeo) string
inputs.sayFrase hablada (opcional, activa la voz) string
inputs.wordmarkNombre del producto tal como va impreso (opcional) string
inputs.genderQuién lo muestra enum man, woman
inputs.setEscena enum bathroom, bedroom, kitchen, car, park, street
inputs.shotsEstilo de plano enum single, multi
inputs.framingDistancia de plano enum wide, medium, close
inputs.modelModelo enum kling, veo_fast, veo_best
inputs.durationDuración enum 5, 10, 15
inputs.soundSonido nativo bool
inputs.hooksGanchos (opcional) string
inputs.insert_actionQué hacen las manos en el primer plano enum turn, unscrew, pump, flip, press
inputs.nicheNicho / categoría string
inputs.product_infoDescripción del producto y argumentos de venta string
qualityCalidad enum final
aspectFormato enum 9:16, 1:1, 16:9

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