---
title: "Supported Fonts"
description: "Translate가 받는 폰트와 굵기, 대상 언어별 기본 폰트, 읽을 수 있는 원본 언어 코드."
---

> Every apinoa docs page as markdown: https://apinoa.com/llms.txt (all in one file: https://apinoa.com/llms-full.txt; this API family in one file: https://apinoa.com/docs/image-translate/llms.txt)

```http
GET /v1/image-translate/supported-fonts
```

[Translate](/docs/api-reference/image-translate/translate)가 받는 값의 실시간 목록을 돌려줍니다. 대상 언어마다
어떤 폰트가 지원되는지, 각 언어의 기본 폰트, 모든 `font_weight`, 모든 `source_language`,
그리고 업로드한 폰트입니다. 시작할 때 호출해 결과를 캐시하세요. 목록은 거의 바뀌지 않지만,
폰트는 차차 추가됩니다.

## 요청

```bash tab="cURL"
curl "https://gateway.apinoa.com/v1/image-translate/supported-fonts" \
  -H "x-api-key: $APINOA_API_KEY"
```

```js tab="JavaScript"
const res = await fetch("https://gateway.apinoa.com/v1/image-translate/supported-fonts", {
  headers: { "x-api-key": process.env.APINOA_API_KEY },
});
const { data } = await res.json();
const font = data.defaultByLanguage["ko"] ?? data.allFonts[0];
```

```python tab="Python"
import os

import requests

res = requests.get(
    "https://gateway.apinoa.com/v1/image-translate/supported-fonts",
    headers={"x-api-key": os.environ["APINOA_API_KEY"]},
    timeout=10,
)
data = res.json()["data"]
font = data["defaultByLanguage"].get("ko", data["allFonts"][0])
```

## 파라미터

없습니다. `x-api-key` 헤더에 API 키만 보내세요.

## 응답

실제 응답을 36개 언어 중 네 개만 남기고 줄인 것입니다.

```json
{
  "success": true,
  "requestId": "547bebcbd167416c9d1097bc132e2194",
  "data": {
    "fontsByLanguage": {
      "ko": ["BMHANNAPro", "NotoSansKR", "Pretendard"],
      "zh-CN": ["NotoSansSC"],
      "ja": ["NotoSansKR", "NotoSansSC", "Pretendard"],
      "en": ["Pretendard", "NotoSansKR", "NotoSansSC"]
    },
    "defaultByLanguage": {
      "ko": "BMHANNAPro",
      "zh-CN": "NotoSansSC",
      "ja": "NotoSansKR",
      "en": "Pretendard"
    },
    "allFonts": ["BMHANNAPro", "NotoSansKR", "NotoSansSC", "Pretendard"],
    "allWeights": ["auto", "Thin", "Light", "Regular", "Medium", "SemiBold", "Bold", "ExtraBold", "Black"],
    "supportedSourceLanguages": ["auto", "ch", "zh", "zh-CN", "zh-TW", "chinese_cht", "ja", "japan", "en"],
    "userFonts": []
  }
}
```

| 필드 | 타입 | 의미 |
|---|---|---|
| `fontsByLanguage` | object | 대상 언어마다 지원하는 폰트. 첫 번째가 기본 폰트입니다. 빈 목록이면 그 문자를 지원하는 내장 폰트가 없습니다. |
| `defaultByLanguage` | object | 대상 언어 → 기본 폰트(`fontsByLanguage`의 첫 항목). |
| `allFonts` | string[] | Translate의 `font`가 받는 모든 값. |
| `allWeights` | string[] | Translate의 `font_weight`가 받는 모든 값. |
| `supportedSourceLanguages` | string[] | Translate와 OCR의 `source_language`가 받는 모든 값. `auto`는 자동 감지합니다. |
| `userFonts` | array | 업로드한 폰트. [Custom Fonts](/docs/api-reference/image-translate/custom-fonts)를 참고하세요. |

## 에러

| 상태 | 코드 | 의미 |
|---|---|---|
| 401 | `UNAUTHORIZED` | `x-api-key` 헤더가 없거나, 키가 유효하지 않습니다. |

모든 코드는 [Errors](/docs/errors)에 있습니다.

## 가격

무료입니다. 이 호출은 과금되지 않습니다.