API Reference

Get Me

Describe the authenticated key: workspace, scopes, live limits, today’s usage, and the wallet balance + pricing catalog.

Auth requires only a valid key — there is no scope gate, so any key can describe itself and the caller can pre-flight scopes and estimate cost against the live wallet before a multi-gigabyte upload. Limits reflect the running config (env-resolved, not code defaults) and usage_today reuses the same daily counters the quota enforcement reads. credit_balance_cents is a real null (never a fake 0) when credit billing is disabled for the deployment; agent_context.balance_note explains it.

GET

https://api.nanoclip.ai

Get Me

curl --request GET \
  --url https://api.nanoclip.ai/v1/me \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.nanoclip.ai/v1/me', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "workspace": {
    "id": "<string>",
    "name": "<string>"
  },
  "api_key": {
    "prefix": "<string>",
    "scopes": [
      "<string>"
    ],
    "name": "<string>"
  },
  "limits": {
    "requests_per_minute_per_key": 123,
    "projects_per_day": 123,
    "analysis_commands_per_day": 123,
    "max_upload_bytes": 123
  },
  "usage_today": {
    "projects_created": 123,
    "analysis_commands": 123,
    "day_resets_at": "<string>"
  },
  "billing": {
    "currency": "<string>",
    "pricing": {
      "transcript_per_uploaded_hour_cents": 123,
      "diarization_addon_per_hour_cents": 123,
      "vision_per_minute_cents": 123,
      "retake_removal_per_minute_cents": 123
    },
    "credit_balance_cents": 123
  },
  "agent_context": {}
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

200 - application/json

Successful Response

workspace

MeWorkspace · object

required

Show child attributes

api_key

MeApiKey · object

required

Show child attributes

limits

MeLimits · object

required

Show child attributes

usage_today

MeUsageToday · object

required

Show child attributes

billing

MeBilling · object

required

Show child attributes

agent_context

Agent Context · object

required

Show child attributes

Get Me

curl --request GET \
  --url https://api.nanoclip.ai/v1/me \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.nanoclip.ai/v1/me', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "workspace": {
    "id": "<string>",
    "name": "<string>"
  },
  "api_key": {
    "prefix": "<string>",
    "scopes": [
      "<string>"
    ],
    "name": "<string>"
  },
  "limits": {
    "requests_per_minute_per_key": 123,
    "projects_per_day": 123,
    "analysis_commands_per_day": 123,
    "max_upload_bytes": 123
  },
  "usage_today": {
    "projects_created": 123,
    "analysis_commands": 123,
    "day_resets_at": "<string>"
  },
  "billing": {
    "currency": "<string>",
    "pricing": {
      "transcript_per_uploaded_hour_cents": 123,
      "diarization_addon_per_hour_cents": 123,
      "vision_per_minute_cents": 123,
      "retake_removal_per_minute_cents": 123
    },
    "credit_balance_cents": 123
  },
  "agent_context": {}
}