YouTube
3D Toon Explainers
A curious true story, how something works or a what if, told by a narrator in a bright 3D cartoon world
- From
- 248 crper ad
- Endpoint
POST /api/v1/studio/toon3d/runs- Workflow id
toon3d
Real outputs of this workflow.
The request
# 1. Price it. Free, nothing is charged.
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\": \"Hot July and August 1858; untreated sewage in the Thames (Wikipedia: Great Stink)\\nParliament'\''s river-side curtains were soaked in chloride of lime\\nThe bill was tabled 15 June 1858 and passed into law on 2 August 1858\\nBazalgette'\''s sewers still work in the 21st century\", \"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\": \"In 1858, London'\''s river smelled so bad that Parliament could barely work.\"}, {\"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\": \"It was a scorching summer, and the Thames was full of raw sewage.\"}, {\"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\": \"The stench drifted straight into the lawmakers'\'' halls.\"}, {\"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\": \"So they soaked the curtains in chloride of lime.\"}, {\"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\": \"Within weeks, a new law paid for a giant network of sewers.\"}, {\"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\": \"Those tunnels still serve London today. Would you have held your breath?\"}]}"}
}' | jq .credits)
echo "$PRICE"
# 2. Start it. max_credits refuses anything above that price; the Idempotency-Key stops a double charge.
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\": \"Hot July and August 1858; untreated sewage in the Thames (Wikipedia: Great Stink)\\nParliament'\''s river-side curtains were soaked in chloride of lime\\nThe bill was tabled 15 June 1858 and passed into law on 2 August 1858\\nBazalgette'\''s sewers still work in the 21st century\", \"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\": \"In 1858, London'\''s river smelled so bad that Parliament could barely work.\"}, {\"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\": \"It was a scorching summer, and the Thames was full of raw sewage.\"}, {\"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\": \"The stench drifted straight into the lawmakers'\'' halls.\"}, {\"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\": \"So they soaked the curtains in chloride of lime.\"}, {\"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\": \"Within weeks, a new law paid for a giant network of sewers.\"}, {\"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\": \"Those tunnels still serve London today. Would you have held your breath?\"}]}"},
"max_credits": '"$PRICE"'
}')
ID=$(echo "$START" | jq -r .id)
# 3. Wait until it finishes.
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. Download every file in one 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. Price it. Free, nothing is charged.
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\": \"Hot July and August 1858; untreated sewage in the Thames (Wikipedia: Great Stink)\\nParliament's river-side curtains were soaked in chloride of lime\\nThe bill was tabled 15 June 1858 and passed into law on 2 August 1858\\nBazalgette's sewers still work in the 21st century\", \"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\": \"In 1858, London's river smelled so bad that Parliament could barely work.\"}, {\"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\": \"It was a scorching summer, and the Thames was full of raw sewage.\"}, {\"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\": \"The stench drifted straight into the lawmakers' halls.\"}, {\"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\": \"So they soaked the curtains in chloride of lime.\"}, {\"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\": \"Within weeks, a new law paid for a giant network of sewers.\"}, {\"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\": \"Those tunnels still serve London today. Would you have held your breath?\"}]}"}
}
price = requests.post(f"{BASE}/api/v1/studio/toon3d/estimate", headers=HEADERS, json=estimate, timeout=60).json()["credits"]
print(price)
# 2. Start it. max_credits refuses anything above that price; the Idempotency-Key stops a double charge.
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\": \"Hot July and August 1858; untreated sewage in the Thames (Wikipedia: Great Stink)\\nParliament's river-side curtains were soaked in chloride of lime\\nThe bill was tabled 15 June 1858 and passed into law on 2 August 1858\\nBazalgette's sewers still work in the 21st century\", \"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\": \"In 1858, London's river smelled so bad that Parliament could barely work.\"}, {\"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\": \"It was a scorching summer, and the Thames was full of raw sewage.\"}, {\"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\": \"The stench drifted straight into the lawmakers' halls.\"}, {\"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\": \"So they soaked the curtains in chloride of lime.\"}, {\"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\": \"Within weeks, a new law paid for a giant network of sewers.\"}, {\"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\": \"Those tunnels still serve London today. Would you have held your breath?\"}]}"},
"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. Wait until it finishes.
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. Download every file in one 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 or newer. Save as run.mjs: top-level await needs a module.
const BASE = "https://staglight.ai";
const headers = { Authorization: `Bearer ${process.env.STAGLIGHT_API_KEY}` };
const json = { ...headers, "Content-Type": "application/json" };
// 1. Price it. Free, nothing is charged.
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\": \"Hot July and August 1858; untreated sewage in the Thames (Wikipedia: Great Stink)\\nParliament's river-side curtains were soaked in chloride of lime\\nThe bill was tabled 15 June 1858 and passed into law on 2 August 1858\\nBazalgette's sewers still work in the 21st century\", \"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\": \"In 1858, London's river smelled so bad that Parliament could barely work.\"}, {\"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\": \"It was a scorching summer, and the Thames was full of raw sewage.\"}, {\"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\": \"The stench drifted straight into the lawmakers' halls.\"}, {\"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\": \"So they soaked the curtains in chloride of lime.\"}, {\"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\": \"Within weeks, a new law paid for a giant network of sewers.\"}, {\"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\": \"Those tunnels still serve London today. Would you have held your breath?\"}]}"}
};
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. Start it. max_credits refuses anything above that price; the Idempotency-Key stops a double charge.
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\": \"Hot July and August 1858; untreated sewage in the Thames (Wikipedia: Great Stink)\\nParliament's river-side curtains were soaked in chloride of lime\\nThe bill was tabled 15 June 1858 and passed into law on 2 August 1858\\nBazalgette's sewers still work in the 21st century\", \"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\": \"In 1858, London's river smelled so bad that Parliament could barely work.\"}, {\"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\": \"It was a scorching summer, and the Thames was full of raw sewage.\"}, {\"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\": \"The stench drifted straight into the lawmakers' halls.\"}, {\"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\": \"So they soaked the curtains in chloride of lime.\"}, {\"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\": \"Within weeks, a new law paid for a giant network of sewers.\"}, {\"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\": \"Those tunnels still serve London today. Would you have held your breath?\"}]}"},
"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. Wait until it finishes.
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. Download every file in one zip.
console.log(`${BASE}/api/v1/studio/toon3d/runs/${start.id}/outputs.zip`); Use the Staglight API to run the workflow "3D Toon Explainers" from server code.
Docs: https://staglight.ai/llms.txt
This workflow: https://staglight.ai/en/api/workflows/toon3d
Key: read it from the STAGLIGHT_API_KEY environment variable. Never put it in browser code.
1. Price it for free first: POST /api/v1/studio/toon3d/estimate
2. Start it: POST /api/v1/studio/toon3d/runs, with an Idempotency-Key header and max_credits.
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\": \"Hot July and August 1858; untreated sewage in the Thames (Wikipedia: Great Stink)\\nParliament's river-side curtains were soaked in chloride of lime\\nThe bill was tabled 15 June 1858 and passed into law on 2 August 1858\\nBazalgette's sewers still work in the 21st century\", \"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\": \"In 1858, London's river smelled so bad that Parliament could barely work.\"}, {\"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\": \"It was a scorching summer, and the Thames was full of raw sewage.\"}, {\"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\": \"The stench drifted straight into the lawmakers' halls.\"}, {\"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\": \"So they soaked the curtains in chloride of lime.\"}, {\"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\": \"Within weeks, a new law paid for a giant network of sewers.\"}, {\"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\": \"Those tunnels still serve London today. Would you have held your breath?\"}]}"}, "max_credits": 488}
Files are media ids from POST /api/v1/uploads.
3. After a timeout, check the job list before you retry, and retry with the same Idempotency-Key.
4. Poll the run until it finishes, then download its outputs.zip. What it costs
| Template | Final, best text | Draft, fast and cheap |
|---|---|---|
| Explainer Short | 488 cr | 248 cr |
Prices from the server at the default settings. The estimate call gives the exact price for your inputs, for free.
Inputs
| Name | Type | Allowed |
|---|---|---|
cardThe template | string | explain |
inputs.ideaYour topic | string | |
inputs.planThe plan | string | |
inputs.drawSurprise story | string | |
inputs.topicKind of Short | enum | story, how, whatif |
inputs.lengthLength | enum | 30, 60 |
inputs.languageLanguage | enum | auto, en, es |
qualityQuality | enum | final, draft |
aspectShape | enum | 9:16, 16:9 |
Files are media ids from POST /api/v1/uploads. View documentation
Try it by hand
The same workflow runs in the studio, on the same balance. Use it to see the result before you write code.
More workflows
- Real output YouTube
Ranking Shorts
Five crazy levels, ranked #5 to #1, in one vertical Short
per ad, from190 cr
- Real output YouTube
Glow-up Series
An animated series in your language where your audience votes what changes each day
per ad, from216 cr
- Real output YouTube
Motion Math
Any idea becomes a neon maths Short, with the real number worked out and shown happening
per ad, from100 cr