Raw schema
{
"type": "object",
"properties": {
"seriesId": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "A series id from autoshort_list_series."
},
"plan": {
"type": "object",
"description": "The whole season plan. Omit to review or confirm the stored one.",
"properties": {
"version": {
"type": "integer",
"enum": [
1
]
},
"title": {
"type": "string",
"maxLength": 80
},
"logline": {
"type": "string",
"minLength": 10,
"maxLength": 300
},
"genre": {
"type": "string",
"enum": [
"drama",
"thriller",
"comedy",
"horror",
"romance"
]
},
"language": {
"type": "string",
"maxLength": 12,
"description": "The narration language of every episode: 'en', 'vi'... (never auto)."
},
"narratorVoiceId": {
"type": "string",
"minLength": 3,
"maxLength": 64,
"description": "The narrator of every episode: an ElevenLabs voice id or a Google voice name such as en-US-Chirp3-HD-Aoede."
},
"styleTokens": {
"type": "string",
"minLength": 3,
"maxLength": 160,
"description": "One short phrase appended to every shot prompt, e.g. \"cinematic, moody teal light, 35mm film\"."
},
"characters": {
"type": "array",
"minItems": 1,
"maxItems": 6,
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 40
},
"role": {
"type": "string",
"maxLength": 120
},
"look": {
"type": "string",
"minLength": 8,
"maxLength": 400,
"description": "ONE character: age band, hair, outfit, one prop. Never two characters in one look."
},
"sheetId": {
"type": [
"string",
"null"
],
"description": "The READY character sheet of THIS series that plays this character."
},
"wardrobeLock": {
"type": "string",
"minLength": 3,
"maxLength": 200,
"description": "The outfit, identical in every episode (\"natural fur, no clothes\" for an animal)."
},
"expressionRule": {
"type": "string",
"maxLength": 200
}
},
"required": [
"name",
"look",
"wardrobeLock"
],
"additionalProperties": false
}
},
"rules": {
"type": "array",
"maxItems": 16,
"items": {
"type": "string",
"maxLength": 300
}
},
"episodes": {
"type": "array",
"minItems": 1,
"maxItems": 12,
"items": {
"type": "object",
"properties": {
"n": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"title": {
"type": "string",
"maxLength": 80
},
"logline": {
"type": "string",
"maxLength": 300
},
"characterName": {
"type": "string",
"maxLength": 40,
"description": "The ONE character of the cast this episode stars."
},
"cliffhangerLine": {
"type": "string",
"maxLength": 200,
"description": "The LAST spoken sentence of every episode but the last."
},
"shots": {
"type": "array",
"minItems": 3,
"maxItems": 8,
"items": {
"type": "object",
"properties": {
"narration": {
"type": "string",
"maxLength": 600,
"description": "What the narrator says over this shot."
},
"action": {
"type": "string",
"maxLength": 300,
"description": "What the viewer sees: ONE character, one action. Never on-screen text."
},
"camera": {
"type": "string",
"maxLength": 120,
"description": "Camera: shot size and one move."
}
},
"required": [
"narration"
],
"additionalProperties": false
},
"description": "Shots you write. Give `shots` OR `script`."
},
"script": {
"type": "string",
"maxLength": 2400,
"description": "The narration the system splits into shots. Give `script` OR `shots`."
}
},
"required": [
"n",
"title",
"characterName",
"cliffhangerLine"
],
"additionalProperties": false
}
}
},
"required": [
"version",
"logline",
"genre",
"language",
"narratorVoiceId",
"styleTokens",
"characters",
"episodes"
],
"additionalProperties": false
},
"review": {
"type": "boolean",
"description": "Run the season review on the stored plan (after saving `plan` if given)."
},
"aiReview": {
"type": "boolean",
"description": "With review: also run the advisory AI review (default true)."
},
"confirm": {
"type": "boolean",
"description": "The owner confirms the reviewed plan. Needs planHash; do not send `plan` in the same call."
},
"planHash": {
"type": "string",
"minLength": 64,
"maxLength": 64,
"description": "With confirm: the planHash the review returned."
}
},
"required": [
"seriesId"
],
"additionalProperties": false
}