Render a draft
render_draftRender an approved draft into the video. THIS IS THE ONLY STEP THAT COSTS CREDITS: the price is quote.credits from get_draft / draft_video, charged once after the render succeeds (a failed attempt costs nothing; StoryShort may retry a failed render automatically, up to 3 times, and the same video is never charged twice — cancel_video stops the retries). Call it first without confirmCredits to get QUOTE_REQUIRED and the price, show the user, then call again with confirmCredits set to that exact number. A wrong number is refused (PRICE_CHANGED); a short balance is refused up front (INSUFFICIENT_CREDITS). A new account with no credits that has not had its free first video gets it here instead of an error: watermarked, labelled AI-generated, up to 30 seconds, standard voice, one per account, subject to the day's availability. That first video needs no confirmCredits; the answer carries its video id. Calling it again on a draft that is already rendering starts nothing new. Poll get_video until COMPLETED or FAILED. 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": {
"draftId": "<draftId>"
},
"name": "render_draft"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| draftId | Yes | ||
| confirmCredits | No | The render price in credits the user approved (quote.credits). |