# General Translation Platform: uploadFonts
URL: https://generaltranslation.com/fr/docs/platform/core/reference/gt-class-methods/translation/upload-fonts.mdx
---

title: uploadFonts
description: Téléverse des ressources de police persistantes pour les workflows de traduction Lottie. Référence de l’API uploadFonts.

---

Téléverse des polices TrueType ou OpenType via un projet afin que les tâches de traduction Lottie de la même Organization puissent les utiliser lors du traitement de la mise en page.

## Présentation [#overview]

Appelez `uploadFonts` avec des ressources de police encodées en Base64. La méthode divise les entrées volumineuses en lots de 50 et renvoie les identifiants des ressources stockées.

```typescript
const result = await gt.uploadFonts(fonts, {
  timeout: 30000,
});
```

Signature :

```typescript
uploadFonts(
  fonts: AssetUpload[],
  options?: UploadAssetsOptions
): Promise<UploadAssetsResponse>
```

*Remarque : `uploadFonts` nécessite une `apiKey` (ou une `devApiKey`) et un `projectId` dans l’instance GT.*

## Fonctionnement [#how-it-works]

* Le contenu des polices est déjà encodé en Base64 lorsqu’il est transmis à la méthode.
* Chaque police doit avoir un nom de fichier avec l’extension `.ttf` ou `.otf` et ne doit pas dépasser 20 Mo une fois décodée.
* Le projet détermine quelle Organization est propriétaire de la police. Les polices téléversées sont conservées pour toutes les tâches de traduction de cette Organization.
* Le service déduit la famille de polices, la graisse et le style italique à partir des métadonnées de la police, puis se replie sur le nom de fichier. Téléverser à nouveau une police avec la même identité dérivée remplace la ressource stockée.
* Les entrées contenant plus de 50 polices sont téléversées en plusieurs requêtes.

Consultez [Téléverser les ressources du projet](/docs/platform/openapi/reference/project/upload-assets) pour en savoir plus sur les règles de validation, l’identité et le comportement de nouvelle tentative.

## Paramètres [#parameters]

| Paramètre             | Description                              | Type                  | Facultatif | Par défaut |
| --------------------- | ---------------------------------------- | --------------------- | ---------- | ---------- |
| [`fonts`](#fonts)     | Polices encodées en Base64 à téléverser. | `AssetUpload[]`       | Non        | —          |
| [`options`](#options) | Options de la requête.                   | `UploadAssetsOptions` | Oui        | `{}`       |

### `fonts` [#fonts]

**Type** `AssetUpload[]` · **Obligatoire**

| Champ       | Description                                        | Type     | Facultatif |
| ----------- | -------------------------------------------------- | -------- | ---------- |
| `assetType` | Type de ressource. Seul `FONT` est pris en charge. | `'FONT'` | Non        |
| `content`   | Octets de police encodés en Base64.                | `string` | Non        |
| `fileName`  | Nom de fichier se terminant par `.ttf` ou `.otf`.  | `string` | Non        |

### `options` [#options]

**Type** `UploadAssetsOptions` · **Facultatif** · **Par défaut** `{}`

| Champ     | Description                                         | Type     | Facultatif |
| --------- | --------------------------------------------------- | -------- | ---------- |
| `timeout` | Délai d’expiration de la requête, en millisecondes. | `number` | Oui        |

## Renvoie [#returns]

**Type** `Promise<UploadAssetsResponse>`

Renvoie les identifiants des ressources de police stockées et le nombre de polices traitées :

| Propriété           | Description                                                   | Type              |
| ------------------- | ------------------------------------------------------------- | ----------------- |
| `assets`            | Ressources de police stockées.                                | `UploadedAsset[]` |
| `assets[].id`       | ID de la ressource Organization stockée.                      | `string`          |
| `assets[].assetKey` | Identité de police dérivée au format `<family>-<weight>[-i]`. | `string`          |
| `assets[].fileName` | Nom de fichier fourni lors de l’envoi.                        | `string`          |
| `count`             | Nombre de polices traitées.                                   | `number`          |

<Callout type="warn">
  **Incohérence de type dans la version v9.1.0 :** `UploadedAsset` déclare un booléen `deduped`, mais la réponse du service ne l’inclut pas. N’utilisez pas ce champ pour déterminer si une police existante a été remplacée.
</Callout>

## Exemple [#example]

```typescript title="upload-fonts.ts"
import { readFile } from 'node:fs/promises';
import { GT } from 'generaltranslation';

const gt = new GT({
  apiKey: process.env.GT_API_KEY,
  projectId: process.env.GT_PROJECT_ID,
});

const content = (await readFile('./public/fonts/BrandSans.ttf')).toString(
  'base64'
);

const result = await gt.uploadFonts([
  {
    assetType: 'FONT',
    content,
    fileName: 'BrandSans.ttf',
  },
]);

console.log(result.assets[0].assetKey);
```