RANDOMX / API

    API 控制台

    將 RandomX 接入你的應用程式。

    RANDOMX / DEVELOPERS

    1. 取得 API 金鑰

    API 參考

    使用與 RandomX 網站相同的生成能力。搜尋工具、查看每個參數的限制,然後複製請求。

    基础地址https://randomx.ai/api/v1
    冪等請求Idempotency-Key
    HTTP / JSONapplication/json

    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。

    參數

    字段类型必填預設值可用值 / 範圍說明
    localestring否enen | zh-CN | zh-TW | es | ja | ko | fr | de | pt-BR | vi | idResponse language for generated names and explanations.
    genderstring否""男 | 女 | 中性 | ""Gender preference. Empty means any.
    surnamestring否""max 80 charactersOptional family name to keep fixed.
    nameStylestring否""max 80 charactersStyle such as classic, elegant, or modern.
    nameInspirationstring否""max 300 charactersTheme or inspiration for the given name.
    customRequirementsstring否""max 300 charactersExtra naming requirements.
    wuxingstring否""max 300 charactersOptional five-elements preference.
    birthdaystring否""date or text, max 300 charactersUsed only as a naming reference.
    repeatNamesstring否""max 300 charactersNames to avoid repeating.
    genrestring否""max 300 charactersGame genre for game-name tools.
    platformstring否""max 300 charactersGame platform for game-name tools.
    gameGenrestring否""max 300 charactersGame category for nickname tools.
    nicknameStylestring否""max 300 charactersDesired nickname tone or style.
    personastring否""max 300 charactersPlayer persona used by nickname tools.
    culturalNamestring否無non-empty for generateOriginal name to adapt into a Chinese name.
    aionFactionstring否無Elyos | Asmodian | AnyAION faction preference; not an official game limit.
    aionClassstring否無Gladiator | Templar | Assassin | Ranger | Sorcerer | Spiritmaster | Cleric | Chanter | AnyAION class preference.
    aionStylestring否無Elegant | Dark | Mystic | Heroic | Cute | AnyAION name style.
    aionLengthstring否無short | medium | long | anyDesired 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
    }

    載入中…