Browse the docs
Developers / Docs / Templates
Get AI Story scenes
Lists the scenes of an AI Story video you own: each scene's narration and its pictures, with what each picture shows (description) and which of the project's characters are in it. Use it to find pictures that came out wrong, then redraw just those with redo_ai_story_pictures (scenes: the scene number, your own description, and the characters in the picture). Free.
Paste it into any AI assistant. The shortcuts open with the prompt typed in; nothing is sent until you press enter.
At a glance
- REST
GET https://api.clippie.ai/v1/videos/:projectId/scenes
- MCP tool
get_story_scenes
- Scope
read
- Cost
- Free. Works with a read-only key.
Parameters
projectId- In:
- path
- Type:
- string
- Required:
- Yes
- Description:
- The AI Story project id: output.projectId of a create_ai_story_video job, an id from list_videos, or the id in an editor URL. 1-64 chars.
Example
curl
curl "https://api.clippie.ai/v1/videos/PROJECT_ID/scenes" \
-H "Authorization: Bearer $CLIPPIE_API_KEY"get-story-scenes.mjs
const auth = { Authorization: `Bearer ${process.env.CLIPPIE_API_KEY}` };
const res = await fetch('https://api.clippie.ai/v1/videos/PROJECT_ID/scenes', { headers: auth });
if (!res.ok) throw new Error((await res.json()).error.message);
console.log(await res.json());Response
200 with JSON. The full response schema is in the OpenAPI spec.
From an MCP client
Your AI calls get_story_scenes with the same fields as JSON arguments. See MCP server to connect one.
tools/call
{
"name": "get_story_scenes",
"arguments": {
"projectId": "PROJECT_ID"
}
}