Formatos de anuncio
Script Runner
Pega tu guion y lo convertimos en escenas, fotogramas, clips y un vídeo montado.
- Desde
- 198 crpor anuncio
- Endpoint
POST /api/v1/runs- Id del flujo
script_runner
Resultados reales de este flujo.
La solicitud
# 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": "script_runner",
"options": {
"tier": "draft",
"aspect": "9:16",
"lang": "es",
"script": "Ana: Cada mañana tenía la piel cansada. Hasta que encontré este sérum."
}
}' | 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": "script_runner",
"options": {
"tier": "draft",
"aspect": "9:16",
"lang": "es",
"script": "Ana: Cada mañana tenía la piel cansada. Hasta que encontré este sérum."
},
"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" import os, time, uuid, requests
BASE = "https://staglight.ai"
HEADERS = {"Authorization": f"Bearer {os.environ['STAGLIGHT_API_KEY']}"}
# 1. Pide el precio. Gratis, no se cobra nada.
estimate = {
"format": "script_runner",
"options": {
"tier": "draft",
"aspect": "9:16",
"lang": "es",
"script": "Ana: Cada mañana tenía la piel cansada. Hasta que encontré este sérum."
}
}
price = requests.post(f"{BASE}/api/v1/runs/estimate", headers=HEADERS, json=estimate, timeout=60).json()["credits"]
print(price)
# 2. Inícialo. max_credits rechaza lo que pase de ese precio; el Idempotency-Key evita un cobro doble.
body = {
"format": "script_runner",
"options": {
"tier": "draft",
"aspect": "9:16",
"lang": "es",
"script": "Ana: Cada mañana tenía la piel cansada. Hasta que encontré este sérum."
},
"auto": True,
"max_credits": 117
}
body["max_credits"] = price
r = requests.post(f"{BASE}/api/v1/runs", json=body, timeout=60,
headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())})
r.raise_for_status()
start = r.json()
# 3. Espera a que termine.
while True:
run = requests.get(f"{BASE}/api/v1/runs/{start['id']}", headers=HEADERS, params={"wait": 30}, timeout=60).json()
if run["status"] in ("succeeded", "failed", "canceled", "awaiting_approval", "needs_attention"):
break
# 4. Descarga todos los archivos en un zip.
with open("result.zip", "wb") as out:
out.write(requests.get(f"{BASE}/api/v1/runs/{start['id']}/outputs.zip", headers=HEADERS, timeout=300).content) // Node 18 o posterior. Guárdalo como run.mjs: el await de nivel superior necesita un módulo.
const BASE = "https://staglight.ai";
const headers = { Authorization: `Bearer ${process.env.STAGLIGHT_API_KEY}` };
const json = { ...headers, "Content-Type": "application/json" };
// 1. Pide el precio. Gratis, no se cobra nada.
const estimate = {
"format": "script_runner",
"options": {
"tier": "draft",
"aspect": "9:16",
"lang": "es",
"script": "Ana: Cada mañana tenía la piel cansada. Hasta que encontré este sérum."
}
};
const price = await (await fetch(`${BASE}/api/v1/runs/estimate`, { method: "POST", headers: json, body: JSON.stringify(estimate) })).json();
console.log(price.credits);
// 2. Inícialo. max_credits rechaza lo que pase de ese precio; el Idempotency-Key evita un cobro doble.
const body = {
"format": "script_runner",
"options": {
"tier": "draft",
"aspect": "9:16",
"lang": "es",
"script": "Ana: Cada mañana tenía la piel cansada. Hasta que encontré este sérum."
},
"auto": true,
"max_credits": 117
};
body.max_credits = price.credits;
const res = await fetch(`${BASE}/api/v1/runs`, {
method: "POST", headers: { ...json, "Idempotency-Key": crypto.randomUUID() }, body: JSON.stringify(body),
});
if (!res.ok) throw new Error((await res.json()).error.message);
const start = await res.json();
// 3. Espera a que termine.
let run = start;
while (!["succeeded", "failed", "canceled", "awaiting_approval", "needs_attention"].includes(run.status)) {
run = await (await fetch(`${BASE}/api/v1/runs/${start.id}?wait=30`, { headers })).json();
}
// 4. Descarga todos los archivos en un zip.
console.log(`${BASE}/api/v1/runs/${start.id}/outputs.zip`); Usa la API de Staglight para ejecutar el flujo "Script Runner" desde código de servidor.
Docs: https://staglight.ai/es/llms.txt
Este flujo: https://staglight.ai/es/api/flujos/script_runner
Clave: léela de la variable de entorno STAGLIGHT_API_KEY. Nunca en código del navegador.
1. Pide antes el precio, gratis: POST /api/v1/runs/estimate
2. Inícialo: POST /api/v1/runs, con la cabecera Idempotency-Key y max_credits.
Cuerpo: {"format": "script_runner", "options": {"tier": "draft", "aspect": "9:16", "lang": "es", "script": "Ana: Cada mañana tenía la piel cansada. Hasta que encontré este sérum."}, "auto": true, "max_credits": 117}
Los archivos son ids de POST /api/v1/uploads.
3. Si se agota el tiempo, mira la lista de trabajos antes de reintentar, y reintenta con el mismo Idempotency-Key.
4. Consulta la ejecución hasta que termine y descarga su outputs.zip. Cuánto cuesta
| Nivel | 9:16 | 4:5 | 1:1 | 16:9 |
|---|---|---|---|---|
| Borrador | 198 cr | 198 cr | 198 cr | 198 cr |
| Estándar | 414 cr | 414 cr | 414 cr | 414 cr |
| Premium | 514 cr | 514 cr | 514 cr | 514 cr |
Precios del servidor con los ajustes por defecto. La llamada de estimación da el precio exacto para tus entradas, gratis.
Entradas
| Nombre | Tipo | Valores |
|---|---|---|
formatobligatorioEl formato | string | script_runner |
options.scriptobligatorioEl guion, en sintaxis de bloques o texto normal | string | |
options.tierNivel | enum | draft, standard, premium |
options.aspectFormato | enum | 9:16, 4:5, 1:1, 16:9 |
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.
Más flujos
- Resultado real Formatos de anuncio
UGC estilo creador
Un presentador creado con IA muestra tu producto a cámara, con guion, voz en off y subtítulos.
por anuncio, desde92 cr
- Resultado real Formatos de anuncio
Problema / Solución
Tres escenas: el problema, la molestia y tu producto como solución, con voz en off y subtítulos.
por anuncio, desde157 cr
- Resultado real Formatos de anuncio
3 razones
Tres beneficios en tres clips, con números grandes en pantalla. El texto lo pone la app, no el modelo.
por anuncio, desde157 cr