API 参考 · Media
Video · templates
List the Replace templates — the trends: a famous clip, who you can cast in it, and its shots.
Free, no key needed. The studio's Replace shelf, as data: each template's clip, preview and poster (paths on https://eroq.ai), the trend's logo when it has one (a transparent WebP to lay over the poster), its length, its slots (the people you cast, left to right) and the instruction written for the engine ({slot} → @Name). New trends appear here first — load the list instead of copying it.
A template with shots is cut from several renders: render each shot with POST /v1/videos/edits, source set to the shot's own source (template:<id>:<n>, engine-ready on our side — nothing to upload), targets from the shot; then POST /v1/videos/edits/assemble puts them back into the clip. A shot never lands on its own: it is held for its cut and lands inside it — one video in the library, the shots out of the queue. renders lists the seconds billed, one entry per render.
curl https://eroq.ai/v1/videos/templates \
-H "Authorization: Bearer $EROQ_API_KEY"响应
{
"object": "list",
"data": [
{
"id": "gta-goodbye",
"name": "Goodbye GTA",
"about": "The GTA goodbye, shot for shot: …",
"clip": "/templates/replace/goodbye-gta.mp4",
"preview": "/templates/replace/goodbye-gta-preview-2.mp4",
"poster": "/templates/replace/goodbye-gta-poster-2.webp",
"logo": "/templates/logos/gta-vi.webp",
"seconds": 22,
"slots": [{ "id": "you" }],
"clipOutfits": true,
"voices": { "female": "/templates/replace/goodbye-gta-female.mp4" },
"shots": [
{ "start": 3.666, "end": 6.666, "targets": ["the young man in the foreground, seen in profile"], "source": "template:gta-goodbye:1" },
{ "start": 6.666, "end": 10.666, "targets": ["the young man in close-up, in tears"], "source": "template:gta-goodbye:2" },
{ "start": 10.666, "end": 14.541, "targets": ["the young man in the driver's seat"], "source": "template:gta-goodbye:3" },
{ "start": 0, "end": 3.666, "targets": ["the young man in the middle of the frame"], "source": "template:gta-goodbye:4" }
],
"renders": [3, 4, 3.875, 3.666]
}
]
}