# generaltranslation: General Translation Core SDK: EnqueueFilesOptions
URL: https://generaltranslation.com/zh/docs/core/types/enqueue-files-options.mdx
---
title: EnqueueFilesOptions
description: 批量文件翻译操作的设置选项
---

## 概述

<Callout type="info">
  这是库内部使用的**内部**类型。面向用户、传递给 [`enqueueFiles`](/docs/core/class/methods/translation/enqueue-files) 的类型是 `EnqueueOptions`，它只是此类型的一个子集。
</Callout>

`EnqueueFilesOptions` 是用于批量文件翻译操作的完整内部配置类型。

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

## 属性

| 属性                 | 类型         | 必填    | 说明              |
| ------------------ | ---------- | ----- | --------------- |
| `requireApproval?` | `boolean`  | 否     | 需要审批流程          |
| `description?`     | `string`   | 否     | 任务描述            |
| `sourceLocale?`    | `string`   | 否     | 覆盖源区域设置         |
| `targetLocales`    | `string[]` | **是** | 目标区域设置代码        |
| `version?`         | `string`   | 否     | 版本标识符           |
| `_versionId?`      | `string`   | 否     | 内部版本 ID (由库使用)  |
| `timeout?`         | `number`   | 否     | 请求超时 (毫秒)       |
| `modelProvider?`   | `string`   | 否     | 翻译模型提供商         |
| `force?`           | `boolean`  | 否     | 强制重新处理          |

## 示例

### 基本用法

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

const options: EnqueueFilesOptions = {
  targetLocales: ['es', 'fr', 'de'],
  requireApproval: true
};

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

### 开发环境与生产环境

```typescript copy
// 开发环境
const devOptions: EnqueueFilesOptions = {
  targetLocales: ['es'],
  requireApproval: false
};

// 生产环境  
const prodOptions: EnqueueFilesOptions = {
  targetLocales: ['es', 'fr', 'de', 'ja'],
  requireApproval: true,
  modelProvider: 'premium'
};
```

## 相关类型

* [`FileToTranslate`](/docs/core/types/file-to-translate) - 文件输入数据结构