Create video
Start making a video in the Poko app, with the app's own AI and the workspace settings. Returns at once with the queued video's requestId; poll Get video until status is completed or failed. While the app is closed the video waits in a queue.
apiKeyAuthorizationBearer <token>A Poko API key (poko_live_…) from Poko Motion → Settings → API.
workspaceId*stringWorkspace id. GET /api/me returns the key's default workspace (workspaceId); GET /api/workspace/mine lists all of them.
Idempotency-Key?stringSend the same value when you retry, and Poko answers with the first result instead of starting the work again.
application/json- body
name*string1 <= length <= 200projectType*stringurl: a web page. pdf/pptx: a document. motioncut: a screen recording or video to edit.
"url""pdf""pptx""motioncut"sourceUrl*stringHTTPS link to the page or file. For a local file, use fileUrl from upload_file.
prompt*stringWhat the video should be.
1 <= length <= 20000videoStyle?stringwalkthrough: product or document tour. motion-ad: polished ad. saas-motion-ad: SaaS launch or feature ad. research-explainer: explains a paper (pdf only). Required without templateId.
"walkthrough""motion-ad""saas-motion-ad""research-explainer"aspectRatio?stringRequired without templateId.
"16:9""1:1""9:16"templateId?stringA template from list_templates. The video follows its design and motion, and takes its aspect ratio; videoStyle and aspectRatio are then ignored. Not for motioncut.
model?stringA model id the Poko app offers, or gateway:. Leave out to use the app setting.
references?array<||>Material the video should use: a project, a Poko animation, or a file link (for example fileUrl from upload_file).
items <= 10Success
application/json- response
success?booleandata?curl -X POST 'https://api.poko.video/api/workspaces/string/videos' \ -H 'Content-Type: application/json' \ -d '{ "name": "Acme launch video", "projectType": "url", "sourceUrl": "https://acme.example.com", "prompt": "A 30-second launch video for our new dashboard. Show the three main features and end on the sign-up page.", "videoStyle": "saas-motion-ad", "aspectRatio": "16:9"}'{ "success": true, "data": { "requestId": "3f9c2a71-5b8e-4d2a-9c41-7e6b0d5a8f12", "status": "queued", "keyId": "kQ7vX2mLp9Za", "workspaceId": "Wk7pQ2xR", "deliveryAttempts": 0, "nextAttemptAt": "2026-11-05T08:56:50.208Z", "cancellationPending": false, "createdAt": "2026-11-05T08:56:50.208Z", "updatedAt": "2026-11-05T08:56:50.208Z" }}