Generate one series video (async)
Queue the render of ONE video part of an APPROVED series and return at once with a job_id: this call never waits for the video.
POST /api/v1/generate_video · MCP tool generate_video · scope drafts + spend
Queue the render of ONE video part of an APPROVED series and return at once with a job_id: this call never waits for the video. Poll get_video_status. Refuses a series nobody approved, a part that is not a video, a halted or over-budget brand, a workspace without credits, a part over the $3 per-video cap, and more than 30 renders per workspace per UTC day. Idempotent: a part already queued or rendered comes back with its job. Publishes nothing. Needs the key's 'drafts' and 'spend' scopes.
Scope. Save drafts, articles and series proposals to the Inbox, and withdraw your own drafts. Nothing publishes. Every call costs credits, so the key also needs spend.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
series_id | string | Yes | The seriesId. |
part | integer | string | Yes | The part: its number (1, 2, ...) or its episode id (from get_series). |
Request
curl -X POST https://growsocialelion.com/api/v1/generate_video \
-H "Authorization: Bearer gse_mcp_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"series_id":"ser_123","part":2}'Response
200 with the tool's answer. The shape below is generated from the output schema; real answers can carry more fields.
{
"status": "string",
"reason": "string",
"job_id": "string",
"code": "string"
}Errors use the shared body. See Errors. The full schema is in the API reference.