RANDOMX / API

API 控制台

将 RandomX 接入你的应用。

RANDOMX / DEVELOPERS

1. 获取 API 密钥

API 参考

使用与 RandomX 网站相同的生成能力。搜索工具、查看每个参数的约束，然后复制请求。

基础地址https://randomx.ai/api/v1

幂等请求Idempotency-Key

HTTP / JSONapplication/json

全部工具 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

每个 POST 都要带唯一的 Idempotency-Key。只有在重试相同请求和相同请求体时才能复用。

快速模式下，后续请求传入相同选项和 batch_id，可继续同一批次且不重复。每次新的逻辑请求使用新的 Idempotency-Key。

参数

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

请求示例

使用 AI 直接生成全新内容。按实际返回条数计费；任务未完成时可能返回 202。

请求体

{
  "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"}}'

响应

响应字段

200 application/json

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

加载中…