API introduction - TokenGift

Base URL

https://api.tokengift.ai/v1

Authentication

Pass your app’s API key as a Bearer token:

Authorization: Bearer tg_live_…

Keys are issued in the dashboard, shown once, stored hashed. Rotate by issuing a new key and revoking the old one.

Compatibility promise

POST /v1/chat/completions accepts the OpenAI Chat Completions request shape (a curated subset — streaming and non-streaming) and proxies to our curated model list. If you use an OpenAI SDK, you only change baseURL and apiKey.

Response headers

Header	Meaning
`TokenGift-Balance`	Wallet balance (USD) after this request
`TokenGift-Request-Cost`	Exact cost (USD) of this request
`TokenGift-Request-Id`	ID for support and debugging — on every response, including errors
`TokenGift-Version`	API version that served the request (date-based, e.g. `2026-07-29`)
`x-ratelimit-*`	OpenAI-compatible rate limit info — see Errors

Versioning

The current API version is date-based and returned in the TokenGift-Version header. There is only one version today; when a breaking change ships, you’ll be able to pin a version per request with a TokenGift-Version request header, and existing integrations keep their behavior.

Roadmap

A management API (balances, gift issuance, usage reports) with Idempotency-Key support and cursor pagination is in active development — along with official TypeScript and Python SDKs and an MCP server for AI agents.

​Base URL

​Authentication

​Compatibility promise

​Response headers

​Versioning

​Roadmap