Font Families

List the commercially usable, redistributable font families in the Tonghe Cloud font library. Family names can be used directly as font parameters for other endpoints.

Basics

Item	Value
Method	GET
Path	/task/font/families
Auth	Not required
Cache	Cache-Control: public, max-age=60 + ETag

Query Parameters

Name	Type	Required	Description
query	string	No	Fuzzy match on family name (matches either the Chinese or English name, case-insensitive). Omit to return all

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "families": [
      {
        "family": "思源黑体 CN",
        "family_en": "Source Han Sans CN",
        "license": "Apache-2.0 — 明确允许再分发",
        "face_count": 8,
        "faces": [
          {
            "file": "sourcehansanscn-bold.otf",
            "weight": "Bold",
            "bytes": 8608184,
            "url": "https://api.ai-mcn.tv:9000/cloud/static/assets/fonts/sourcehansanscn-bold.otf"
          }
        ]
      }
    ],
    "total": 59
  }
}

Inclusion Criteria

A font appears in this list only if it meets both conditions:

1. Redistributable license — determined from the font file's own copyright and license fields (SIL OFL, Apache-2.0, or a vendor's public free-for-commercial-use declaration). Never inferred from file or directory names.
2. Full simplified Chinese coverage — verified against the character map. Fonts missing glyphs (mostly Japanese and traditional Chinese families) produce a half-font, half-system-fallback mix on simplified Chinese text, which looks worse than a plain fallback, so they are excluded.

Fonts that fail either condition are not listed, and no parameter can surface them.

Available Fonts