# Get AI Story scenes

URL: https://clippie.ai/developers/docs/get-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.

## At a glance

| Property | Value |
| --- | --- |
| 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

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `projectId` | path | string | Yes |  | 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:

```bash
curl "https://api.clippie.ai/v1/videos/PROJECT_ID/scenes" \
  -H "Authorization: Bearer $CLIPPIE_API_KEY"
```

get-story-scenes.mjs:

```js
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](https://api.clippie.ai/v1/openapi.json).

## From an MCP client

Your AI calls `get_story_scenes` with the same fields as JSON arguments. See [MCP server](https://clippie.ai/developers/docs.md#mcp) to connect one.

tools/call:

```json
{
  "name": "get_story_scenes",
  "arguments": {
    "projectId": "PROJECT_ID"
  }
}
```
