Poko API
Usage

Get usage by project

GET
/api/motion-billing/usage-by-project

Credits spent per project in a month.

Authorization

apiKey
headerAuthorizationBearer <token>

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

Query Parameters

workspace_id*string

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

month?string

YYYY-MM. Leave out for all time.

Match^\d{4}-\d{2}$

Response Body

Success

application/json
  1. response
success?boolean
data?
Example Request
curl -X GET 'https://api.poko.video/api/motion-billing/usage-by-project?workspace_id=string'
Example Response
{  "success": true,  "data": {    "month": "2026-10",    "projects": [      {        "projectId": "Pj4kT9wQzN",        "requestCount": 171,        "inputTokens": 53665,        "outputTokens": 309550,        "cacheCreationTokens": 3332194,        "cacheReadTokens": 10627733,        "costUsd": 30.4797,        "firstUsedAt": "2026-10-07T05:10:39.036Z",        "lastUsedAt": "2026-10-08T08:00:01.510Z",        "audioSeconds": 30,        "mediaGenerations": 2,        "musicCount": 1,        "sfxCount": 1,        "llmCostUsd": 30.1597,        "musicCostUsd": 0.08,        "sfxCostUsd": 0.24,        "mediaCostUsd": 0.32,        "projectName": "Acme launch video"      }    ]  }}