RANDOMX / API

API console

Connect your applications to RandomX.

RANDOMX / DEVELOPERS

1. Get an API key

API reference

Build against the same generators that power RandomX. Search a tool, inspect every option, then copy a request.

Base URLhttps://randomx.ai/api/v1

IdempotencyIdempotency-Key

HTTP / JSONapplication/json

All tools 26

RANDOMX / REST

Chinese Cat Names Generator

Generate Chinese names, game handles or themed names with AI.

POST/api/v1/tools/chinese-cat-names-generator/generate

Send a unique Idempotency-Key with every POST. Reuse the same key only when retrying the same request and body.

In fast mode, reuse batch_id with unchanged options to continue the same batch without repeats. Use a new Idempotency-Key for each new logical request.

Options

Field	Type	Required	Default	Allowed values	Description
`locale`	string	No	`en`	en \| zh-CN \| zh-TW \| es \| ja \| ko \| fr \| de \| pt-BR \| vi \| id	Response language for generated names and explanations.
`gender`	string	No	`""`	男 \| 女 \| 中性 \| ""	Gender preference. Empty means any.
`surname`	string	No	`""`	max 80 characters	Optional family name to keep fixed.
`nameStyle`	string	No	`""`	max 80 characters	Style such as classic, elegant, or modern.
`nameInspiration`	string	No	`""`	max 300 characters	Theme or inspiration for the given name.
`customRequirements`	string	No	`""`	max 300 characters	Extra naming requirements.
`wuxing`	string	No	`""`	max 300 characters	Optional five-elements preference.
`birthday`	string	No	`""`	date or text, max 300 characters	Used only as a naming reference.
`repeatNames`	string	No	`""`	max 300 characters	Names to avoid repeating.
`genre`	string	No	`""`	max 300 characters	Game genre for game-name tools.
`platform`	string	No	`""`	max 300 characters	Game platform for game-name tools.
`gameGenre`	string	No	`""`	max 300 characters	Game category for nickname tools.
`nicknameStyle`	string	No	`""`	max 300 characters	Desired nickname tone or style.
`persona`	string	No	`""`	max 300 characters	Player persona used by nickname tools.
`culturalName`	string	No	`None`	non-empty for generate	Original name to adapt into a Chinese name.
`aionFaction`	string	No	`None`	Elyos \| Asmodian \| Any	AION faction preference; not an official game limit.
`aionClass`	string	No	`None`	Gladiator \| Templar \| Assassin \| Ranger \| Sorcerer \| Spiritmaster \| Cleric \| Chanter \| Any	AION class preference.
`aionStyle`	string	No	`None`	Elegant \| Dark \| Mystic \| Heroic \| Cute \| Any	AION name style.
`aionLength`	string	No	`None`	short \| medium \| long \| any	Desired AION name length.

Request

Generate original content with AI. Direct generation is billed per returned item and may return 202 while work continues.

Request body

{
  "count": 1,
  "options": {
    "locale": "en",
    "nameStyle": "classic"
  }
}

cURL

curl -X POST 'https://randomx.ai/api/v1/tools/chinese-cat-names-generator/generate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{"count":1,"options":{"locale":"en","nameStyle":"classic"}}'

Response

Response fields

200 application/json

{
  "id": "REQUEST_ID",
  "state": "complete",
  "batch_id": "BATCH_ID",
  "results": [
    {
      "value": 42
    }
  ],
  "charged": 1,
  "status": "available",
  "delivered_total": 1
}

Loading…