# General Translation Platform: EnqueueFilesOptions
URL: https://generaltranslation.com/zh/docs/platform/core/reference/types/enqueue-files-options.mdx
---

title: EnqueueFilesOptions
description: 使用 General Translation 将已上传文件加入翻译队列的选项。EnqueueFilesOptions 类型的 API 参考。

---

`EnqueueFilesOptions` 是传递给 [`enqueueFiles`](/docs/platform/core/reference/gt-class-methods/translation/enqueue-files) 的配置类型，用于将先前已上传的源文件加入翻译队列。

*注意：这是 9.0 中 [`enqueueFiles`](/docs/platform/core/reference/gt-class-methods/translation/enqueue-files) 接受的用户可见类型。*

## 概览 [#overview]

`EnqueueFilesOptions` 用于说明批量文件翻译的目标区域设置和作业配置。只有 `targetLocales` 为必填项；其他字段均为可选。

```typescript
type EnqueueFilesOptions = {
  sourceLocale?: string;
  targetLocales: string[];
  modelProvider?: string;
  force?: boolean;
  timeout?: number;
};
```

## 属性 [#properties]

| 属性                                 | 描述                | 类型         | 可选 |
| ---------------------------------- | ----------------- | ---------- | -- |
| [`sourceLocale`](#source-locale)   | 覆盖源区域设置。 | `string`   | 是  |
| [`targetLocales`](#target-locales) | 要翻译到的目标区域设置代码。    | `string[]` | 否  |
| [`modelProvider`](#model-provider) | 翻译模型提供商。          | `string`   | 是  |
| [`force`](#force)                  | 使缓存的翻译失效，并强制重新翻译。 | `boolean`  | 是  |
| [`timeout`](#timeout)              | 请求超时时间 (毫秒) 。     | `number`   | 是  |

*注意：`requireApproval` 仅适用于 8.x，在 9.0 中已不存在。*

### `sourceLocale` [#source-locale]

**类型** `string` · **可选**

覆盖此 job 的源区域设置。省略时，默认使用实例的 `sourceLocale`。

### `targetLocales` [#target-locales]

**类型** `string[]` · **必填**

要将文件翻译成的目标区域设置代码。

### `modelProvider` [#model-provider]

**类型** `string` · **可选**

要使用的翻译模型提供商。

### `force` [#force]

**类型** `boolean` · **可选**

使缓存的翻译失效，并强制重新翻译文件，即使已有翻译也会如此。

### `timeout` [#timeout]

**类型** `number` · **可选**

请求超时时间，单位为毫秒。

## 示例 [#example]

```typescript
import { GT, EnqueueFilesOptions } from 'generaltranslation';

const options: EnqueueFilesOptions = {
  targetLocales: ['es', 'fr', 'de'],
  sourceLocale: 'en',
  modelProvider: 'premium',
};

const result = await gt.enqueueFiles(files, options);
```

```typescript
// 开发环境 vs 生产环境
const devOptions: EnqueueFilesOptions = {
  targetLocales: ['es'],
};

const prodOptions: EnqueueFilesOptions = {
  targetLocales: ['es', 'fr', 'de', 'ja'],
  modelProvider: 'premium',
  force: true,
};
```