Language Support

The Alt Magic API supports a wide range of languages for generating alt text. You can specify the desired language using the language_code parameter in your API requests.

How to Use Language Codes

Include the language_code parameter in your API request body. If left empty or not provided, the API will automatically fallback to English (en):
{
  "image_url": "https://example.com/image.jpg",
  "user_id": "user@example.com",
  "language_code": "es"
}

Supported Languages

A

  • Abkhaz - ab
  • Acehnese - ace
  • Acholi - ach
  • Afrikaans - af
  • Albanian - sq
  • Alur - alz
  • Amharic - am
  • Arabic - ar
  • Armenian - hy
  • Assamese - as
  • Awadhi - awa
  • Aymara - ay
  • Azerbaijani - az

B

  • Balinese - ban
  • Bambara - bm
  • Bashkir - ba
  • Basque - eu
  • Batak Karo - btx
  • Batak Simalungun - bts
  • Batak Toba - bbc
  • Belarusian - be
  • Bemba - bem
  • Bengali - bn
  • Betawi - bew
  • Bhojpuri - bho
  • Bikol - bik
  • Bosnian - bs
  • Breton - br
  • Bulgarian - bg
  • Buryat - bua

C

  • Cantonese - yue
  • Catalan - ca
  • Cebuano - ceb
  • Chichewa (Nyanja) - ny
  • Chinese (Simplified) - zh-CN
  • Chinese (Traditional) - zh-TW
  • Chuvash - cv
  • Corsican - co
  • Crimean Tatar - crh
  • Croatian - hr
  • Czech - cs

D

  • Danish - da
  • Dinka - din
  • Divehi - dv
  • Dogri - doi
  • Dombe - dov
  • Dutch - nl
  • Dzongkha - dz

E

  • English - en
  • Esperanto - eo
  • Estonian - et
  • Ewe - ee

F

  • Fijian - fj
  • Filipino (Tagalog) - fil
  • Finnish - fi
  • French - fr
  • French (French) - fr-FR
  • French (Canadian) - fr-CA
  • Frisian - fy
  • Fulfulde - ff

G

  • Ga - gaa
  • Galician - gl
  • Ganda (Luganda) - lg
  • Georgian - ka
  • German - de
  • Greek - el
  • Guarani - gn
  • Gujarati - gu

H

  • Haitian Creole - ht
  • Hakha Chin - cnh
  • Hausa - ha
  • Hawaiian - haw
  • Hebrew - he
  • Hiligaynon - hil
  • Hindi - hi
  • Hmong - hmn
  • Hungarian - hu
  • Hunsrik - hrx

I

  • Icelandic - is
  • Igbo - ig
  • Iloko - ilo
  • Indonesian - id
  • Irish - ga
  • Italian - it

J

  • Japanese - ja
  • Javanese - jv

K

  • Kannada - kn
  • Kapampangan - pam
  • Kazakh - kk
  • Khmer - km
  • Kiga - cgg
  • Kinyarwanda - rw
  • Kituba - ktu
  • Konkani - gom
  • Korean - ko
  • Krio - kri
  • Kurdish (Kurmanji) - ku
  • Kurdish (Sorani) - ckb
  • Kyrgyz - ky

L

  • Lao - lo
  • Latgalian - ltg
  • Latin - la
  • Latvian - lv
  • Ligurian - lij
  • Limburgan - li
  • Lingala - ln
  • Lithuanian - lt
  • Lombard - lmo
  • Luo - luo
  • Luxembourgish - lb

M

  • Macedonian - mk
  • Maithili - mai
  • Makassar - mak
  • Malagasy - mg
  • Malay - ms
  • Malay (Jawi) - ms-Arab
  • Malayalam - ml
  • Maltese - mt
  • Maori - mi
  • Marathi - mr
  • Meadow Mari - chm
  • Meiteilon (Manipuri) - mni-Mtei
  • Minang - min
  • Mizo - lus
  • Mongolian - mn
  • Myanmar (Burmese) - my

N

  • Ndebele (South) - nr
  • Nepalbhasa (Newari) - new
  • Nepali - ne
  • Northern Sotho (Sepedi) - nso
  • Norwegian - no
  • Nuer - nus

O

  • Occitan - oc
  • Odia (Oriya) - or
  • Oromo - om

P

  • Pangasinan - pag
  • Papiamento - pap
  • Pashto - ps
  • Persian - fa
  • Polish - pl
  • Portuguese - pt
  • Portuguese (Portugal) - pt-PT
  • Portuguese (Brazil) - pt-BR
  • Punjabi - pa
  • Punjabi (Shahmukhi) - pa-Arab

Q

  • Quechua - qu

R

  • Romani - rom
  • Romanian - ro
  • Rundi - rn
  • Russian - ru

S

  • Samoan - sm
  • Sango - sg
  • Sanskrit - sa
  • Scots Gaelic - gd
  • Serbian - sr
  • Sesotho - st
  • Seychellois Creole - crs
  • Shan - shn
  • Shona - sn
  • Sicilian - scn
  • Silesian - szl
  • Sindhi - sd
  • Sinhala (Sinhalese) - si
  • Slovak - sk
  • Slovenian - sl
  • Somali - so
  • Spanish - es
  • Sundanese - su
  • Swahili - sw
  • Swati - ss
  • Swedish - sv

T

  • Tajik - tg
  • Tamil - ta
  • Tatar - tt
  • Telugu - te
  • Tetum - tet
  • Thai - th
  • Tigrinya - ti
  • Tsonga - ts
  • Tswana - tn
  • Turkish - tr
  • Turkmen - tk
  • Twi (Akan) - ak

U

  • Ukrainian - uk
  • Urdu - ur
  • Uyghur - ug
  • Uzbek - uz

V

  • Vietnamese - vi

W

  • Welsh - cy

X

  • Xhosa - xh

Y

  • Yiddish - yi
  • Yoruba - yo
  • Yucatec Maya - yua

Z

  • Zulu - zu

Language Code Format

Language codes follow the ISO 639-1 standard for most languages, with some extended codes for regional variants:
  • Two-letter codes: Most languages use standard two-letter codes (e.g., en, es, fr)
  • Extended codes: Some languages have regional variants (e.g., zh-CN, zh-TW, pt-BR, pt-PT)
  • Three-letter codes: Some less common languages use three-letter codes (e.g., ace, ach, alz)

Example Usage

Generate Alt Text in Spanish

curl -X POST "https://api.altmagic.pro/v1/generate-alt-text-api" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "image_url": "https://example.com/image.jpg",
    "user_id": "user@example.com",
    "language_code": "es"
  }'

Generate Alt Text in French

curl -X POST "https://api.altmagic.pro/v1/generate-alt-text-api" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "image_url": "https://example.com/image.jpg",
    "user_id": "user@example.com",
    "language_code": "fr"
  }'

Generate Alt Text in Japanese

curl -X POST "https://api.altmagic.pro/v1/generate-alt-text-api" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "image_url": "https://example.com/image.jpg",
    "user_id": "user@example.com",
    "language_code": "ja"
  }'

Best Practices

  1. Always specify the language: Use the language_code parameter to ensure alt text is generated in the desired language
  2. Consider your audience: Choose the language that best serves your target audience
  3. Test with different languages: Verify that the generated alt text is appropriate for each language
  4. Fallback behavior: If language_code is not provided or left empty, the API automatically defaults to English (en)
  5. Invalid language codes: If an unrecognized language code is provided, the API will also fallback to English

Need Help?

If you have questions about language support or need assistance with specific languages, contact us at advait@altmagic.pro.