Referencia de la API · Platform
Creations library
Every image and video you rendered, with its recipe.
Every /v1 image, video and speech render is saved to your creation library automatically (free) with the full recipe in meta — model, rack, seconds, references. Pass folder_id on the generation call (images, videos, video edits, speech, remove-background, film renders) and it lands straight in that folder. GET /v1/creations/{id} fetches one; PATCH /v1/creations/{id} moves it between folders ({ "folderId": … | null }) and hearts it ({ "favorite": true } — favoritedAt on every creation); DELETE removes it and its file.
Folders: GET /v1/folders lists them, POST /v1/folders ({ "name": … }) creates, PATCH /v1/folders/{id} renames, DELETE /v1/folders/{id} removes — deleting a folder keeps its creations (they fall back to the root).
Public folder links (Team, Agency and Enterprise). POST /v1/folders/{id}/share gives a folder a page anyone with the link can open, signed out — share.url (eroq.ai/f/…). Visitors see the files only: never a prompt, a model or your account; downloads: false makes it view-only. The page follows the folder (files you add appear), pauses while the workspace that shared it is off the business tier, and never gets indexed. DELETE /v1/folders/{id}/share kills the link at once — sharing again mints a new one. A role that cannot publish answers 403 role_forbidden; a plan below Team, 403 plan_required.
Community publishing. POST /v1/creations/{id}/publish puts a creation on the public shelf at eroq.ai/community — title is its public face, the prompt and recipe stay private; durationSeconds overrides the badge with the exact measured length. DELETE …/publish pulls it back (likes, comments and views survive a re-publish). POST …/thumbnail (multipart file, image ≤ 5MB) sets the cover of a video or voice.
Endpoints
Selecciona un verbo para cargar su solicitud, su playground y su respuesta.
List your renders with folders and recipes.
One creation, full meta — the Remix recipe.
Move it between folders ({ "folderId": … | null }) and/or heart it ({ "favorite": true }).
Target folder id, or null to move it back to the root.
true adds it to your favorites (stamps favoritedAt), false removes it.
Delete the creation and its file.
Submit to the community shelf. Every publish is reviewed by our team first: review is pending, then approved (live) or rejected — readable on the creation. Publishing again keeps the verdict unless the title changes; a rejected item is resubmitted.
Public title, up to 120 characters. Defaults to a trimmed prompt — except a voice line, which defaults to its voice's name (its prompt is the script, and stays private).
Exact media length for the duration badge — pass what your player measured.
Remove it from the community — engagement is kept for a re-publish.
Set the cover of a video/voice (multipart file, image ≤ 5MB). A new cover on an approved community item sends it back to review (review in the response).
Cover image, up to 5MB.
List your folders — share is the public link, null while private.
Create a folder.
Folder name, unique per account, up to 40 characters.
Rename a folder.
The new name, unique per account, up to 40 characters.
Delete a folder — its creations fall back to the root, its public link dies.
curl https://eroq.ai/v1/creations \
-H "Authorization: Bearer $EROQ_API_KEY"Respuesta
{
"folders": [{ "id": "…", "name": "Campaign A" }],
"creations": [{
"id": "…", "kind": "video", "url": "https://…", "model": "seedance-2-5",
"prompt": "slow pan over the rooftop", "meta": { "seconds": 10, "shot": "push-in" }
}]
}