Clippie AI logo
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"

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"
  }
}