YouTube
Vídeos explicativos 3D
Una historia real, cómo funciona algo o qué pasaría si: lo cuenta un narrador en un mundo 3D de dibujos animados
- Desde
- 248 crpor anuncio
- Endpoint
POST /api/v1/studio/toon3d/runs- Id del flujo
toon3d
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/studio/toon3d/estimate \
-H "Authorization: Bearer $STAGLIGHT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"card": "explain",
"inputs": {"plan": "{\"title\": \"The summer London'\''s river stank\", \"world\": \"Victorian London in the hot summer of 1858: the brown river Thames, a stone bridge, the Houses of Parliament\", \"hero\": \"a Victorian engineer in a brown bowler hat, a dark green frock coat and a grey waistcoat\", \"check\": \"Julio y agosto de 1858, calor; aguas residuales sin tratar en el Támesis (Wikipedia: Great Stink)\\nLas cortinas del lado del río del Parlamento se empaparon en cloruro de cal\\nLa ley se presentó el 15 de junio de 1858 y se aprobó el 2 de agosto de 1858\\nLas cloacas de Bazalgette siguen funcionando en el siglo XXI\", \"shots\": [{\"shows\": \"the engineer and other Londoners stand on a stone bridge over the brown Thames under a blazing sun, holding their noses while wavy green stink lines rise from the water.\", \"line\": \"En 1858, el río de Londres olía tan mal que el Parlamento apenas podía trabajar.\"}, {\"shows\": \"old brick sewer pipes along the riverbank pour brown water straight into the Thames, flies buzz over the mud and the sun beats down on the city.\", \"line\": \"Fue un verano abrasador, y el Támesis estaba lleno de aguas negras.\"}, {\"shows\": \"inside a grand wood-panelled hall of Parliament, cartoon lawmakers in dark coats cough, gag and fan themselves with papers beside tall open windows facing the same brown, smelly river.\", \"line\": \"El hedor entraba directo a las salas de los diputados.\"}, {\"shows\": \"workers dip long heavy curtains into wooden buckets of white chloride of lime and hang them, dripping, over the tall windows on the river side, while the engineer watches hopefully.\", \"line\": \"Así que empaparon las cortinas en cloruro de cal.\"}, {\"shows\": \"a busy building site by the river: workers lay curved brick walls of a huge round sewer tunnel while the engineer unrolls a long paper plan of tunnels.\", \"line\": \"En pocas semanas, una nueva ley pagó una enorme red de cloacas.\"}, {\"shows\": \"the engineer stands proudly in a clean, softly lit brick sewer tunnel as fresh water flows past, then the camera rises through the street to London at dusk.\", \"line\": \"Esos túneles todavía sirven a Londres. ¿Habrías aguantado la respiración?\"}]}"}
}' | 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/toon3d/runs \
-H "Authorization: Bearer $STAGLIGHT_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"card": "explain",
"inputs": {"plan": "{\"title\": \"The summer London'\''s river stank\", \"world\": \"Victorian London in the hot summer of 1858: the brown river Thames, a stone bridge, the Houses of Parliament\", \"hero\": \"a Victorian engineer in a brown bowler hat, a dark green frock coat and a grey waistcoat\", \"check\": \"Julio y agosto de 1858, calor; aguas residuales sin tratar en el Támesis (Wikipedia: Great Stink)\\nLas cortinas del lado del río del Parlamento se empaparon en cloruro de cal\\nLa ley se presentó el 15 de junio de 1858 y se aprobó el 2 de agosto de 1858\\nLas cloacas de Bazalgette siguen funcionando en el siglo XXI\", \"shots\": [{\"shows\": \"the engineer and other Londoners stand on a stone bridge over the brown Thames under a blazing sun, holding their noses while wavy green stink lines rise from the water.\", \"line\": \"En 1858, el río de Londres olía tan mal que el Parlamento apenas podía trabajar.\"}, {\"shows\": \"old brick sewer pipes along the riverbank pour brown water straight into the Thames, flies buzz over the mud and the sun beats down on the city.\", \"line\": \"Fue un verano abrasador, y el Támesis estaba lleno de aguas negras.\"}, {\"shows\": \"inside a grand wood-panelled hall of Parliament, cartoon lawmakers in dark coats cough, gag and fan themselves with papers beside tall open windows facing the same brown, smelly river.\", \"line\": \"El hedor entraba directo a las salas de los diputados.\"}, {\"shows\": \"workers dip long heavy curtains into wooden buckets of white chloride of lime and hang them, dripping, over the tall windows on the river side, while the engineer watches hopefully.\", \"line\": \"Así que empaparon las cortinas en cloruro de cal.\"}, {\"shows\": \"a busy building site by the river: workers lay curved brick walls of a huge round sewer tunnel while the engineer unrolls a long paper plan of tunnels.\", \"line\": \"En pocas semanas, una nueva ley pagó una enorme red de cloacas.\"}, {\"shows\": \"the engineer stands proudly in a clean, softly lit brick sewer tunnel as fresh water flows past, then the camera rises through the street to London at dusk.\", \"line\": \"Esos túneles todavía sirven a Londres. ¿Habrías aguantado la respiración?\"}]}"},
"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/toon3d/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/toon3d/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 = {
"card": "explain",
"inputs": {"plan": "{\"title\": \"The summer London's river stank\", \"world\": \"Victorian London in the hot summer of 1858: the brown river Thames, a stone bridge, the Houses of Parliament\", \"hero\": \"a Victorian engineer in a brown bowler hat, a dark green frock coat and a grey waistcoat\", \"check\": \"Julio y agosto de 1858, calor; aguas residuales sin tratar en el Támesis (Wikipedia: Great Stink)\\nLas cortinas del lado del río del Parlamento se empaparon en cloruro de cal\\nLa ley se presentó el 15 de junio de 1858 y se aprobó el 2 de agosto de 1858\\nLas cloacas de Bazalgette siguen funcionando en el siglo XXI\", \"shots\": [{\"shows\": \"the engineer and other Londoners stand on a stone bridge over the brown Thames under a blazing sun, holding their noses while wavy green stink lines rise from the water.\", \"line\": \"En 1858, el río de Londres olía tan mal que el Parlamento apenas podía trabajar.\"}, {\"shows\": \"old brick sewer pipes along the riverbank pour brown water straight into the Thames, flies buzz over the mud and the sun beats down on the city.\", \"line\": \"Fue un verano abrasador, y el Támesis estaba lleno de aguas negras.\"}, {\"shows\": \"inside a grand wood-panelled hall of Parliament, cartoon lawmakers in dark coats cough, gag and fan themselves with papers beside tall open windows facing the same brown, smelly river.\", \"line\": \"El hedor entraba directo a las salas de los diputados.\"}, {\"shows\": \"workers dip long heavy curtains into wooden buckets of white chloride of lime and hang them, dripping, over the tall windows on the river side, while the engineer watches hopefully.\", \"line\": \"Así que empaparon las cortinas en cloruro de cal.\"}, {\"shows\": \"a busy building site by the river: workers lay curved brick walls of a huge round sewer tunnel while the engineer unrolls a long paper plan of tunnels.\", \"line\": \"En pocas semanas, una nueva ley pagó una enorme red de cloacas.\"}, {\"shows\": \"the engineer stands proudly in a clean, softly lit brick sewer tunnel as fresh water flows past, then the camera rises through the street to London at dusk.\", \"line\": \"Esos túneles todavía sirven a Londres. ¿Habrías aguantado la respiración?\"}]}"}
}
price = requests.post(f"{BASE}/api/v1/studio/toon3d/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 = {
"card": "explain",
"inputs": {"plan": "{\"title\": \"The summer London's river stank\", \"world\": \"Victorian London in the hot summer of 1858: the brown river Thames, a stone bridge, the Houses of Parliament\", \"hero\": \"a Victorian engineer in a brown bowler hat, a dark green frock coat and a grey waistcoat\", \"check\": \"Julio y agosto de 1858, calor; aguas residuales sin tratar en el Támesis (Wikipedia: Great Stink)\\nLas cortinas del lado del río del Parlamento se empaparon en cloruro de cal\\nLa ley se presentó el 15 de junio de 1858 y se aprobó el 2 de agosto de 1858\\nLas cloacas de Bazalgette siguen funcionando en el siglo XXI\", \"shots\": [{\"shows\": \"the engineer and other Londoners stand on a stone bridge over the brown Thames under a blazing sun, holding their noses while wavy green stink lines rise from the water.\", \"line\": \"En 1858, el río de Londres olía tan mal que el Parlamento apenas podía trabajar.\"}, {\"shows\": \"old brick sewer pipes along the riverbank pour brown water straight into the Thames, flies buzz over the mud and the sun beats down on the city.\", \"line\": \"Fue un verano abrasador, y el Támesis estaba lleno de aguas negras.\"}, {\"shows\": \"inside a grand wood-panelled hall of Parliament, cartoon lawmakers in dark coats cough, gag and fan themselves with papers beside tall open windows facing the same brown, smelly river.\", \"line\": \"El hedor entraba directo a las salas de los diputados.\"}, {\"shows\": \"workers dip long heavy curtains into wooden buckets of white chloride of lime and hang them, dripping, over the tall windows on the river side, while the engineer watches hopefully.\", \"line\": \"Así que empaparon las cortinas en cloruro de cal.\"}, {\"shows\": \"a busy building site by the river: workers lay curved brick walls of a huge round sewer tunnel while the engineer unrolls a long paper plan of tunnels.\", \"line\": \"En pocas semanas, una nueva ley pagó una enorme red de cloacas.\"}, {\"shows\": \"the engineer stands proudly in a clean, softly lit brick sewer tunnel as fresh water flows past, then the camera rises through the street to London at dusk.\", \"line\": \"Esos túneles todavía sirven a Londres. ¿Habrías aguantado la respiración?\"}]}"},
"max_credits": 488
}
body["max_credits"] = price
r = requests.post(f"{BASE}/api/v1/studio/toon3d/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/studio/toon3d/runs/{start['id']}", headers=HEADERS, timeout=60).json()
if run["status"] in ("succeeded", "partial", "failed"):
break
time.sleep(10)
# 4. Descarga todos los archivos en un zip.
with open("result.zip", "wb") as out:
out.write(requests.get(f"{BASE}/api/v1/studio/toon3d/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 = {
"card": "explain",
"inputs": {"plan": "{\"title\": \"The summer London's river stank\", \"world\": \"Victorian London in the hot summer of 1858: the brown river Thames, a stone bridge, the Houses of Parliament\", \"hero\": \"a Victorian engineer in a brown bowler hat, a dark green frock coat and a grey waistcoat\", \"check\": \"Julio y agosto de 1858, calor; aguas residuales sin tratar en el Támesis (Wikipedia: Great Stink)\\nLas cortinas del lado del río del Parlamento se empaparon en cloruro de cal\\nLa ley se presentó el 15 de junio de 1858 y se aprobó el 2 de agosto de 1858\\nLas cloacas de Bazalgette siguen funcionando en el siglo XXI\", \"shots\": [{\"shows\": \"the engineer and other Londoners stand on a stone bridge over the brown Thames under a blazing sun, holding their noses while wavy green stink lines rise from the water.\", \"line\": \"En 1858, el río de Londres olía tan mal que el Parlamento apenas podía trabajar.\"}, {\"shows\": \"old brick sewer pipes along the riverbank pour brown water straight into the Thames, flies buzz over the mud and the sun beats down on the city.\", \"line\": \"Fue un verano abrasador, y el Támesis estaba lleno de aguas negras.\"}, {\"shows\": \"inside a grand wood-panelled hall of Parliament, cartoon lawmakers in dark coats cough, gag and fan themselves with papers beside tall open windows facing the same brown, smelly river.\", \"line\": \"El hedor entraba directo a las salas de los diputados.\"}, {\"shows\": \"workers dip long heavy curtains into wooden buckets of white chloride of lime and hang them, dripping, over the tall windows on the river side, while the engineer watches hopefully.\", \"line\": \"Así que empaparon las cortinas en cloruro de cal.\"}, {\"shows\": \"a busy building site by the river: workers lay curved brick walls of a huge round sewer tunnel while the engineer unrolls a long paper plan of tunnels.\", \"line\": \"En pocas semanas, una nueva ley pagó una enorme red de cloacas.\"}, {\"shows\": \"the engineer stands proudly in a clean, softly lit brick sewer tunnel as fresh water flows past, then the camera rises through the street to London at dusk.\", \"line\": \"Esos túneles todavía sirven a Londres. ¿Habrías aguantado la respiración?\"}]}"}
};
const price = await (await fetch(`${BASE}/api/v1/studio/toon3d/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 = {
"card": "explain",
"inputs": {"plan": "{\"title\": \"The summer London's river stank\", \"world\": \"Victorian London in the hot summer of 1858: the brown river Thames, a stone bridge, the Houses of Parliament\", \"hero\": \"a Victorian engineer in a brown bowler hat, a dark green frock coat and a grey waistcoat\", \"check\": \"Julio y agosto de 1858, calor; aguas residuales sin tratar en el Támesis (Wikipedia: Great Stink)\\nLas cortinas del lado del río del Parlamento se empaparon en cloruro de cal\\nLa ley se presentó el 15 de junio de 1858 y se aprobó el 2 de agosto de 1858\\nLas cloacas de Bazalgette siguen funcionando en el siglo XXI\", \"shots\": [{\"shows\": \"the engineer and other Londoners stand on a stone bridge over the brown Thames under a blazing sun, holding their noses while wavy green stink lines rise from the water.\", \"line\": \"En 1858, el río de Londres olía tan mal que el Parlamento apenas podía trabajar.\"}, {\"shows\": \"old brick sewer pipes along the riverbank pour brown water straight into the Thames, flies buzz over the mud and the sun beats down on the city.\", \"line\": \"Fue un verano abrasador, y el Támesis estaba lleno de aguas negras.\"}, {\"shows\": \"inside a grand wood-panelled hall of Parliament, cartoon lawmakers in dark coats cough, gag and fan themselves with papers beside tall open windows facing the same brown, smelly river.\", \"line\": \"El hedor entraba directo a las salas de los diputados.\"}, {\"shows\": \"workers dip long heavy curtains into wooden buckets of white chloride of lime and hang them, dripping, over the tall windows on the river side, while the engineer watches hopefully.\", \"line\": \"Así que empaparon las cortinas en cloruro de cal.\"}, {\"shows\": \"a busy building site by the river: workers lay curved brick walls of a huge round sewer tunnel while the engineer unrolls a long paper plan of tunnels.\", \"line\": \"En pocas semanas, una nueva ley pagó una enorme red de cloacas.\"}, {\"shows\": \"the engineer stands proudly in a clean, softly lit brick sewer tunnel as fresh water flows past, then the camera rises through the street to London at dusk.\", \"line\": \"Esos túneles todavía sirven a Londres. ¿Habrías aguantado la respiración?\"}]}"},
"max_credits": 488
};
body.max_credits = price.credits;
const res = await fetch(`${BASE}/api/v1/studio/toon3d/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", "partial", "failed"].includes(run.status)) {
await new Promise((r) => setTimeout(r, 10000));
run = await (await fetch(`${BASE}/api/v1/studio/toon3d/runs/${start.id}`, { headers })).json();
}
// 4. Descarga todos los archivos en un zip.
console.log(`${BASE}/api/v1/studio/toon3d/runs/${start.id}/outputs.zip`); Usa la API de Staglight para ejecutar el flujo "Vídeos explicativos 3D" desde código de servidor.
Docs: https://staglight.ai/es/llms.txt
Este flujo: https://staglight.ai/es/api/flujos/toon3d
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/studio/toon3d/estimate
2. Inícialo: POST /api/v1/studio/toon3d/runs, con la cabecera Idempotency-Key y max_credits.
Cuerpo: {"card": "explain", "inputs": {"plan": "{\"title\": \"The summer London's river stank\", \"world\": \"Victorian London in the hot summer of 1858: the brown river Thames, a stone bridge, the Houses of Parliament\", \"hero\": \"a Victorian engineer in a brown bowler hat, a dark green frock coat and a grey waistcoat\", \"check\": \"Julio y agosto de 1858, calor; aguas residuales sin tratar en el Támesis (Wikipedia: Great Stink)\\nLas cortinas del lado del río del Parlamento se empaparon en cloruro de cal\\nLa ley se presentó el 15 de junio de 1858 y se aprobó el 2 de agosto de 1858\\nLas cloacas de Bazalgette siguen funcionando en el siglo XXI\", \"shots\": [{\"shows\": \"the engineer and other Londoners stand on a stone bridge over the brown Thames under a blazing sun, holding their noses while wavy green stink lines rise from the water.\", \"line\": \"En 1858, el río de Londres olía tan mal que el Parlamento apenas podía trabajar.\"}, {\"shows\": \"old brick sewer pipes along the riverbank pour brown water straight into the Thames, flies buzz over the mud and the sun beats down on the city.\", \"line\": \"Fue un verano abrasador, y el Támesis estaba lleno de aguas negras.\"}, {\"shows\": \"inside a grand wood-panelled hall of Parliament, cartoon lawmakers in dark coats cough, gag and fan themselves with papers beside tall open windows facing the same brown, smelly river.\", \"line\": \"El hedor entraba directo a las salas de los diputados.\"}, {\"shows\": \"workers dip long heavy curtains into wooden buckets of white chloride of lime and hang them, dripping, over the tall windows on the river side, while the engineer watches hopefully.\", \"line\": \"Así que empaparon las cortinas en cloruro de cal.\"}, {\"shows\": \"a busy building site by the river: workers lay curved brick walls of a huge round sewer tunnel while the engineer unrolls a long paper plan of tunnels.\", \"line\": \"En pocas semanas, una nueva ley pagó una enorme red de cloacas.\"}, {\"shows\": \"the engineer stands proudly in a clean, softly lit brick sewer tunnel as fresh water flows past, then the camera rises through the street to London at dusk.\", \"line\": \"Esos túneles todavía sirven a Londres. ¿Habrías aguantado la respiración?\"}]}"}, "max_credits": 488}
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
| Plantilla | Final, mejor texto | Borrador, rápido y barato |
|---|---|---|
| Short explicativo | 488 cr | 248 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 |
|---|---|---|
cardLa plantilla | string | explain |
inputs.ideaTu tema | string | |
inputs.planEl plan | string | |
inputs.drawHistoria sorpresa | string | |
inputs.topicTipo de Short | enum | story, how, whatif |
inputs.lengthDuración | enum | 30, 60 |
inputs.languageIdioma | enum | auto, en, es |
qualityCalidad | enum | final, draft |
aspectFormato | enum | 9:16, 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.
Más flujos
- Resultado real YouTube
Shorts de ranking
Cinco puestos locos, del #5 al #1, en un solo Short vertical
por anuncio, desde190 cr
- Resultado real YouTube
Serie Glow-up
Una serie animada en la que tu público vota qué cambia cada día
por anuncio, desde216 cr
- Resultado real YouTube
Mates en movimiento
Cualquier idea se convierte en un Short de mates en neón, con la cifra real calculada y mostrada en acción
por anuncio, desde100 cr