Get Task Cost

GET/v1/tasks/{task_id}/cost

Retrieve the asynchronous settlement status, final cost, and token usage for a recent SandBase task.

Path parameters

stringtask_idrequired

SandBase task ID. This is the id returned by POST /v1/run or POST /v1/generations.

Authorization: Bearer sk-sb-YOUR_API_KEY

Response200 OK

{
  "id": "f3d2e8a1-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "completed",
  "settled": true,
  "currency": "USD",
  "cost": "0.001234",
  "estimated_cost": "0.001234",
  "usage": {
    "prompt_tokens": 1000,
    "completion_tokens": 200,
    "total_tokens": 1200,
    "cached_tokens": 800,
    "cache_creation_tokens": 0,
    "reasoning_tokens": 0
  }
}