eroq

API 参考 · Media

Video · templates

List the Replace templates — the trends: a famous clip, who you can cast in it, and its shots.

GET/v1/videos/templatesfree

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"
/v1/videos/templates
→ GET /v1/videos/templates
点击运行,即可回放一次基于文档自带数据的真实交互。无需密钥,不发请求,不扣费用。

响应

200 · application/json
{
  "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]
    }
  ]
}