Audio
Generate sfx
POST
Generate sound effects. Uses credits.
apiKeyheader
AuthorizationBearer <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.
application/json- body
cues*array<>Items
items <= 30Success
application/json- response
success?booleandata?curl -X POST 'https://api.poko.video/api/workspaces/string/audio/sfx' \ -H 'Content-Type: application/json' \ -d '{ "cues": [ { "prompt": "Soft whoosh", "placement_seconds": 2.5 }, { "prompt": "Notification chime", "placement_seconds": 8 } ]}'Example Response
{ "success": true, "data": { "assets": [ { "id": "Sx2mQ8kLp4", "kind": "sfx", "name": "Soft UI Click", "url": "https://cdn.example.com/ai-ads/w/Wk7pQ2xR/audio/sfx/019a5f53-1a2b-7c3d-8e4f-5a6b7c8d9e0f.mp3", "path": "/ai-ads/w/Wk7pQ2xR/audio/sfx/019a5f53-1a2b-7c3d-8e4f-5a6b7c8d9e0f.mp3", "duration_seconds": 1, "placement_seconds": 2.5, "volume": 0.35, "credits_deducted_usd": 0.02, "created_at": "2026-11-05T10:11:40.118Z" }, { "id": "Sx9vN3tRw7", "kind": "sfx", "name": "Sound effect 2", "url": "https://cdn.example.com/ai-ads/w/Wk7pQ2xR/audio/sfx/019a5f53-2b3c-7d4e-9f5a-6b7c8d9e0f1a.mp3", "path": "/ai-ads/w/Wk7pQ2xR/audio/sfx/019a5f53-2b3c-7d4e-9f5a-6b7c8d9e0f1a.mp3", "duration_seconds": 2, "placement_seconds": null, "volume": 0.35, "credits_deducted_usd": 0.024, "created_at": "2026-11-05T10:11:41.902Z" } ], "credits_deducted_usd": 0.044 }}