Aetheria Forge API Documentation

Generate names directly from your own applications and scripts via REST.

POST/api/generate

Generate singular and plural fantasy names based on language preset profiles, with optional custom overrides for phonemes and emotional tone.

Request Body Payload

{
  "preset": "shadow",
  "count": 5,
  "withMeaning": true,
  "override": {
    "tone": { "darkness": 1.0 },
    "phonemes": {
      "consonants": ["x", "z", "k", "th", "r"],
      "vowels": ["a", "u", "i", "e"]
    }
  }
}

Available Presets

  • nobleHonored Kingdom (elegant, light)
  • cthulhuElder Void (dark, harsh, madness)
  • shadowShadow Dominion (stealthy, dark)
  • barbarWar Clans (harsh, warrior)
  • mysticHidden Order (secretive, elegant)

Example Response

{
  "results": [
    {
      "singular": "Zarith",
      "plural": "Zarithes",
      "meaning": "poison-shadow"
    },
    {
      "singular": "Silom",
      "plural": "Silomes",
      "meaning": "silence"
    }
  ]
}