Get embedding credits

Returns your organization's embedding credit balance, its one-time trial grant and the number of tokens embedded this calendar month.

GET /v1/embed-credits

Check the budget for embedding requestsOne million micro-US dollars equals one US dollar.

Identify your organizationUse its control-plane API key.
Read the balanceCheck remaining credit and the trial grant.
Compare monthly usageToken usage is separate from the remaining credit balance.

Before you start

Use your organization API key on the control-plane origin.

Connection setup

Read the result

balance_micro_usd is the remaining balance in millionths of a US dollar; 1,000,000 equals US$1. month_tokens is usage for the calendar month, not the remaining balance.

Response statuses

HTTP status reference

Status	What to do
200	OK
401	Check the credential and Authorization header.
403	Check tenant access, roles and permissions.
500	Check the outcome before retrying a write.

Request example

curl --include --request GET "https://api.originchain.ai/v1/embed-credits" \
  --header "Authorization: Bearer ${OC_ORG_API_KEY}"

Response example

Examples use synthetic values to show the response format.

Response status

{
  "balance_micro_usd": 1000000,
  "trial_granted_micro_usd": null,
  "month_tokens": 0
}

Illustrative balance, not pricing or a promised trial grant; one million micro-USD equals one USD.

Download the OpenAPI specification for the complete response schemas.

Before you startCopy Anchor Link

Read the resultCopy Anchor Link

Response statusesCopy Anchor Link

Before you start

Read the result

Response statuses