Poko API
Audio

Generate music

POST
/api/workspaces/{workspaceId}/audio/music

Generate a music track. Uses credits.

Authorization

apiKey
headerAuthorizationBearer <token>

A Poko API key (poko_live_…) from Poko Motion → Settings → API.

Path Parameters

workspaceId*string

Workspace id. GET /api/me returns the key's default workspace (workspaceId); GET /api/workspace/mine lists all of them.

Request Body

application/json
  1. body
prompt?string

What the music should sound like.

name?string
duration_seconds?number
Range10 <= value <= 180
volume?number
project_id?string

Project to file the track under.

Response Body

Success

application/json
  1. response
success?boolean
data?
Example Request
curl -X POST 'https://api.poko.video/api/workspaces/string/audio/music' \  -H 'Content-Type: application/json' \  -d '{  "prompt": "Upbeat electronic track for a product launch",  "duration_seconds": 30}'
Example Response
{  "success": true,  "data": {    "asset": {      "id": "Au7kP3mXq9",      "kind": "music",      "name": "Upbeat launch bed",      "url": "https://cdn.example.com/ai-ads/w/Wk7pQ2xR/audio/music/019a5f52-7c3e-7a1b-9d2e-3f4a5b6c7d8e.mp3",      "path": "/ai-ads/w/Wk7pQ2xR/audio/music/019a5f52-7c3e-7a1b-9d2e-3f4a5b6c7d8e.mp3",      "duration_seconds": 30,      "placement_seconds": null,      "volume": 0.5,      "credits_deducted_usd": 0.08,      "created_at": "2026-11-05T10:10:05.442Z"    },    "credits_deducted_usd": 0.08,    "generation_time_ms": 18342  }}

Get project GET

One project.

Generate sfx POST

Generate sound effects. Uses credits.