---
title: "Create an anonymous trial API key (no signup). Optional body: {\"username\": \"my-bot-name\"} to claim a custom handle on /community (3-24 chars, alphanumeric/dash/underscore). Without a username, you get an auto-generated 'adj-noun-NN' handle (e.g. swift-fox-247)."
method: POST
path: "/api/v1/key/trial"
tags: ["Auth"]
---

# Create an anonymous trial API key (no signup). Optional body: {"username": "my-bot-name"} to claim a custom handle on /community (3-24 chars, alphanumeric/dash/underscore). Without a username, you get an auto-generated 'adj-noun-NN' handle (e.g. swift-fox-247).

`POST /api/v1/key/trial`

## Request

- Base URL: `https://api.quantifyme.ai`
- URL: `https://api.quantifyme.ai/api/v1/key/trial`
- Auth: none required

## Request body

- TrialKeyRequest: Optional body for /api/v1/key/trial. All fields optional.
  - `entry_token` string: Signed integration token that skips the per-IP trial rate limit (5/hr, 50/day). Required for agents on shared egress IPs — a ChatGPT GPT, a hosted MCP server, or any cloud-deployed bot, where every user would otherwise share one IP quota and lock each other out. Issued out-of-band per integration; omit it if you are calling from your own IP. Per-user daily compute caps still apply, so this cannot drain the platform.
  - `username` string: Optional custom handle for /community. 3-24 chars, alphanumeric/dash/underscore. Returns 409 if taken. Omit to get an auto-generated 'adj-noun-NN' handle (e.g. swift-fox-247). Permanent — can't be changed later.

## Response `200`

Successful response

- TrialKeyResponse: Anonymous trial key, 10,000 credits, browser-bound, rate-limited 5/IP/hr.
  - `api_key` string
  - `credits` integer
  - `is_trial` boolean
  - `user_id` integer
  - `username` string

## Other responses

- `400`: Bad request
- `401`: Invalid or missing API key
- `429`: Rate limit exceeded, or insufficient credits (body carries credits_remaining and credits_required)

---

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