---
title: "Mint a free trial API key"
method: POST
path: "/v1/keys/mint"
---

# Mint a free trial API key

`POST /v1/keys/mint`

## Request

- Base URL: `https://api.veezee.io`
- URL: `https://api.veezee.io/v1/keys/mint`
- Auth: none required

Creates a trial account and returns its API key (vz_trial_...). Empty body, no signup. The key carries the free per-IP daily budget, so minting more keys from one IP gains nothing. Rate limited per IP.

## Response `200`

minted

- object
  - `key` string, required: The API key (vz_trial_...). Shown once; store it.
  - `key_hint` string, required
  - `account_id` string, required
  - `plan` 'trial', required
  - `free_tier` object, required
    - `credits_per_ip_day` integer
    - `freshness` string
    - `first_page_only` boolean
  - `upgrade_url` string, required
  - `setup` object, required: Copy-paste snippets: env export, a curl example, and MCP connection config.
    - `env` string
    - `rest` string
    - `mcp` object
      - `url` string
      - `headers` object
        - `Authorization` string
  - `note` string, required
  - `docs` string, required

## Other responses

- `429`: RATE_LIMITED

---

[API](https://skmtc.dev/veezee/apis/veezee-api.md) · [All operations](https://skmtc.dev/veezee/apis/veezee-api/llms.txt) · [OpenAPI document](https://skmtc.dev/veezee/apis/veezee-api/revisions/6f1831474e70?raw)