Skip to main content

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": "[email protected]",
  "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": "[email protected]",
    "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": "[email protected]",
    "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": "[email protected]",
    "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 [email protected].