Create a series
create_seriesCreate a series: StoryShort makes a video on this niche every scheduleIntervalDays, and can auto-post it to YouTube. The series NAME is the topic every video is written from, so put the user's own subject in it. Creating or changing a series is FREE. While active, the scheduler makes one video every scheduleIntervalDays (the first at its next run, within about 30 minutes) and charges each video like any video, 40 credits with the default render, at render time. It needs at least 40 credits in the balance: when the balance cannot pay for the next video the scheduler PAUSES the series (it never overdraws), so create_series and resume_series refuse with SERIES_NEEDS_CREDITS instead of making a series that would never run. Agents may keep at most 5 series active at once (SERIES_LIMIT_REACHED). StoryShort has no per-key daily spending cap: pause_series is the brake. Set startPaused: true to create it without generating (then resume_series). Accounts with fewer credits than one video (every new account starts at 0, and free accounts cannot run a series) are refused: you get SERIES_NEEDS_CREDITS with a topUpUrl, nothing is created. autoPostYouTube only works once YouTube is connected (get_connection_status) — nothing checks it here; madeForKids is the COPPA answer, ask the user. A name that already exists returns SERIES_EXISTS. TikTok auto-post is not available for series (use publish_video, which sends to Drafts). Pass idempotencyKey so a retry never makes a second series. Requires the "video:create" scope.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"niche": "<niche>"
},
"name": "create_series"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The series topic/name; every video is generated from it. | |
| niche | Yes | Content niche (list_niches). | |
| quality | No | ||
| language | No | Narration language code, e.g. "en" (default). | |
| madeForKids | No | COPPA answer for YouTube uploads from this series. Ask the user. | |
| startPaused | No | Create without generating until resume_series. | |
| idempotencyKey | No | Retry-safe: a repeat with the same key returns the first answer (replayed: true). | |
| autoPostYouTube | No | Upload each finished video to the connected YouTube channel. | |
| defaultDuration | No | Seconds per video; longer lengths need a paid plan. | |
| scheduleIntervalDays | No | One video every N days (default 1 = daily). |