Render an approved preview as MP4
request_mp4AFTER a human has approved a preview, start rendering an MP4 of that temp page (25 credits = $0.25; BYOK: $0.01 with your own Railway worker saved or when full BYOK — every required key saved at /vip-setup — else the full $0.25; refunded on failure). Takes 1–3 min. To skip polling pass callback_url and/or wait_seconds; otherwise poll get_job_status (kind mp4) with the jobId. Never render MP4s for unapproved previews.
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": {
"pageUrl": "<pageUrl>"
},
"name": "request_mp4"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| intro | No | Optional: "joe_call" opens the video with Joe calling on a phone to set up your video. | |
| pageUrl | Yes | The approved pageUrl from generate_ad_creative. | |
| outro_url | No | Optional: an https MP4 (up to 60 s) to play after this video instead of your account outro. null = no outro for this render. | |
| orientation | No | Default vertical 9:16. Use "landscape" (16:9, no intro/outro clips) for a 16:9 page. | |
| callback_url | No | Optional https webhook. Receives the signed done/failed result; the response carries the webhook secret once. | |
| wait_seconds | No | Optional, 0-100. Wait this long for the MP4 and return it in the same call. |