Multi-Language Output & Localization

5 Languages

Native localization in 5 global languages: English, Hindi, Chinese, Bengali, and Spanish.

REST API Reference

The BaZi API features a deterministic multi-language localization engine. By passing the optional 'language' field in the calculation request body, all Four Pillars, Heavenly Stems, Earthly Branches, Five Elements, Ten Gods, Hidden Stems, Na Yin, 12 Growth Phases, and Zodiac animals are instantly translated and normalized. Supported language codes: 'en' (English), 'hi' (Hindi / हिन्दी), 'zh' (Chinese / 中文), 'bn' (Bengali / বাংলা), and 'es' (Spanish / Español). Defaults to 'en' if omitted.

Installation

Bash

POST https://api.baziapi.pro/api/v2/bazi/calculate

Quick Start

cURL Request with Language Parameter

Bash

curl -X POST https://api.baziapi.pro/api/v2/bazi/calculate \
  -H "x-api-key: bazi_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1998-08-12",
    "birthTime": "10:30",
    "gender": "male",
    "timezone": "Asia/Kolkata",
    "language": "hi"
  }'

API Parameters

Parameter	Type	Required	Default	Description
`language`	`'en' \| 'hi' \| 'zh' \| 'bn' \| 'es'`	Optional	`en`	Target localization language: 'en' (English), 'hi' (Hindi / हिन्दी), 'zh' (Chinese / 中文), 'bn' (Bengali / বাংলা), 'es' (Spanish / Español).

More Examples

Hindi Output (language: 'hi')

JSON

{
  "calendar": { "solar": { "weekDay": "बुधवार" }, "solarTerms": { "currentSolarTerm": "शरद ऋतु आरंभ" } },
  "fourPillars": {
    "yearPillar": "वू-यिन (यांग पृथ्वी बाघ)",
    "monthPillar": "गेन्ग-शेन (यांग धातु वानर)",
    "dayPillar": "शिन-माओ (यिन धातु खरगोश)",
    "hourPillar": "गुई-सी (यिन जल सर्प)"
  },
  "elementalComposition": { "yearElement": "पृथ्वी / काष्ठ", "monthElement": "धातु / धातु" },
  "traditionalMappings": {
    "relationshipMappings": { "yearRelationship": "प्रत्यक्ष संसाधन", "monthRelationship": "धन हरण" }
  },
  "traditionalInterpretations": { "dayMasterStrength": "सशक्त", "strongestElement": "धातु" },
  "zodiac": { "chineseZodiac": "बाघ" }
}

Chinese Output (language: 'zh')

JSON

{
  "calendar": { "solar": { "weekDay": "星期三" }, "solarTerms": { "currentSolarTerm": "立秋" } },
  "fourPillars": {
    "yearPillar": "戊寅",
    "monthPillar": "庚申",
    "dayPillar": "辛卯",
    "hourPillar": "癸巳"
  },
  "elementalComposition": { "yearElement": "土木", "monthElement": "金金" },
  "traditionalMappings": {
    "relationshipMappings": { "yearRelationship": "正印", "monthRelationship": "劫财" }
  },
  "traditionalInterpretations": { "dayMasterStrength": "身旺", "strongestElement": "金" },
  "zodiac": { "chineseZodiac": "虎" }
}

Bengali Output (language: 'bn')

JSON

{
  "calendar": { "solar": { "weekDay": "বুধবার" }, "solarTerms": { "currentSolarTerm": "শরতের শুরু" } },
  "fourPillars": {
    "yearPillar": "উ-ইন (ইয়াং মাটি বাঘ)",
    "monthPillar": "গেং-শেন (ইয়াং ধাতু বানর)",
    "dayPillar": "শিন-মাও (য়িন ধাতু খরগোশ)",
    "hourPillar": "গুই-সি (য়িন পানি সাপ)"
  },
  "elementalComposition": { "yearElement": "মাটি / কাঠ", "monthElement": "ধাতু / ধাতু" },
  "traditionalMappings": {
    "relationshipMappings": { "yearRelationship": "প্রত্যক্ষ সম্পদ", "monthRelationship": "সম্পদ হরণ" }
  },
  "traditionalInterpretations": { "dayMasterStrength": "শক্তিশালী", "strongestElement": "ধাতু" },
  "zodiac": { "chineseZodiac": "বাঘ" }
}

Spanish Output (language: 'es')

JSON

{
  "calendar": { "solar": { "weekDay": "Miércoles" }, "solarTerms": { "currentSolarTerm": "Inicio de Otoño" } },
  "fourPillars": {
    "yearPillar": "Wu-Yin (Tierra Yang Tigre)",
    "monthPillar": "Geng-Shen (Metal Yang Mono)",
    "dayPillar": "Xin-Mao (Metal Yin Conejo)",
    "hourPillar": "Gui-Si (Agua Yin Serpiente)"
  },
  "elementalComposition": { "yearElement": "Tierra / Madera", "monthElement": "Metal / Metal" },
  "traditionalMappings": {
    "relationshipMappings": { "yearRelationship": "Recurso Directo", "monthRelationship": "Robar Riqueza" }
  },
  "traditionalInterpretations": { "dayMasterStrength": "Fuerte", "strongestElement": "Metal" },
  "zodiac": { "chineseZodiac": "Tigre" }
}

POST /bazi/calculate

Outbound Webhooks

Something unclear? Contact developer support.