---
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) 中。

## 价格

免费。此调用不计费。