---
title: "AI name generation"
method: POST
path: "/api/v1/generate"
tags: ["Generate"]
---

# AI name generation

`POST /api/v1/generate`

## Request

- Base URL: `https://namesniper.pro`
- URL: `https://namesniper.pro/api/v1/generate`
- Auth: HTTP bearer

## Request body

- object
  - `description` string, required: Business or project description.
  - `count` integer: Values outside the range are clamped, not rejected.
  - `style` 'modern' | 'classic' | 'tech' | 'creative' | 'professional' | 'playful' | 'abstract' | 'luxury' | 'minimalist'

## Response `200`

Generated names with .com availability.

- object
  - `success` unknown
  - `data` object
    - `description` string
    - `names` GeneratedName[]
      - `name` string, required
      - `explanation` string, required
      - `tags` string[], required
      - `confidence` number, required
      - `comAvailable` boolean: Whether the .com is available (DNS check).
      - `source` 'ai' | 'fallback': 'fallback' means the AI was unavailable and a mock was returned; not charged against quota.
    - `generatedAt` string, date-time
    - `cached` boolean
    - `quota` AiQuota: The caller's AI generation allowance after this request.
      - `used` integer, required
      - `limit` integer, nullable, required: null when the plan has no cap on generations.
      - `period` 'day' | 'month' | 'null', nullable, required: Which window `limit` applies to.
  - `meta` Meta: Standard response metadata.
    - `plan` 'guest' | 'free' | 'day_pass' | 'sniper' | 'pro' | 'business'
    - `duration` integer: Server processing time in milliseconds.
    - `timestamp` string, date-time

## Other responses

- `400`: Invalid request (missing field, bad JSON, or invalid value).
- `401`: Missing or invalid API key.
- `429`: Rate limit or daily quota exceeded. Inspect the `Retry-After` header for how many seconds to wait. Limits are per account, so every key on the account shares them.

---

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