# General Translation Platform: 上传项目资源
URL: https://generaltranslation.com/zh/docs/platform/openapi/reference/project/upload-assets.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 通过项目上传 OpenType 或 TrueType 字体，供所属组织内的 Lottie 翻译工作流程使用。每种字体均由基于其字体系列、字重和斜体样式生成的标准化标识唯一确定（该标识来自提供的 family 和 style，或字体元数据和文件名）。重新上传具有相同标识的字体会覆盖现有资源，因此在收到 500 响应后可以安全地完整重试。上传项目资源的 API 参考。

{/* 此文件由 Fumadocs 生成。请勿直接编辑。任何更改都应重新运行生成命令。 */}

## Endpoint

`POST https://api.gtx.dev/v2/project/assets`

**Operation ID:** `uploadAssets`

**Tags:** `Project`

**Summary:** Upload Project assets

Upload OpenType or TrueType fonts for Lottie translations across your Organization. Uploading the same font family, weight, and italic style replaces the existing font. You can safely retry the full upload after a `500` response.

Authentication: required. Send an API key in the `Authorization: Bearer <key>` header when authenticating.

### Parameters

- `gt-api-version` (header, "2025-01-01.v0" | "2025-11-03.v1" | "2026-02-18.v1" | "2026-03-06.v1", optional): API contract version. Defaults to the oldest supported version.
- `gt-project-id` (header, string, optional): Target project ID when no project ID is present in the path. Project API keys default to their bound project. If supplied, the header must match both the path target and the key’s bound project.

### Request body (required)

Body (`application/json`, object):
- `assets` (object[], required)
  - `assetType` ("FONT", required)
  - `content` (string, required)
  - `fileName` (string, required)
  - `family` (string)
  - `style` (string)

### Responses

**201**: Uploaded assets
Response body (`application/json`, object):
- `assets` (object[], required)
  - `id` (string, required)
  - `assetKey` (string, required)
  - `fileName` (string, required)
- `count` (integer, required)

**400**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**401**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**403**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**404**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**413**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**429**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**500**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

Complete OpenAPI 3.1 specification: https://generaltranslation.com/openapi.yaml

OpenAPI schema: [openapi.json](https://generaltranslation.com/openapi.json)

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.