---
title: Hep.gg ID Generator (LLM)
description: Generate unique IDs in several formats over a single POST endpoint, authed with a username + token.
---

# Hep.gg ID Generator

Generate unique IDs in several formats. Each user can create multiple keys; each
key has its own usage counter.

Base URL: https://id.hep.gg
Auth: POST body { "username": "<your-username>", "token": "<your-key>" }
  The username is the global slug you chose for the key (lowercased server-side);
  the token is the key's secret. There are no auth headers.

## Endpoints

### POST /
Generate one ID. Body (JSON or form-urlencoded):
  username   string   The slug you chose for this key.
  token      string   The key's secret value.
  type       string   'uuid' | 'nanoid' | 'snowflake' | 'cuid' | '2fa' | 'license' | 'words' | 'keypair'.
                       'word' is accepted as an alias for 'words'.
  length     number   Optional, type-dependent:
                         nanoid  -> length (max 256)
                         words   -> word count (max 16)
                         cuid    -> length (2-32)
                         2fa     -> digits (defaults to 6)
  alphabet   string   Optional, for 'nanoid'. Custom alphabet.
  style      string   Optional, for 'words'. 'slug' (default) | 'title' | 'formal'.

Response: { "id": "<the-generated-id>" }
  For 'keypair': { "id": "<publicKey>", "privateID": "<privateKey>" }.

### Example
curl -X POST https://id.hep.gg/ \
  -H "Content-Type: application/json" \
  -d '{"username":"my-key","token":"...","type":"nanoid","length":21}'

## Hep.gg dashboard (cookie auth - not for programmatic use)
  GET    /api/v1/id/keys
  POST   /api/v1/id/keys                     { username, label? }
  GET    /api/v1/id/keys/:username
  PATCH  /api/v1/id/keys/:username           { label }
  POST   /api/v1/id/keys/:username/rotate
  DELETE /api/v1/id/keys/:username
  GET    /api/v1/id/keys/:username/available
  GET    /api/v1/id/stats