# General Translation Platform: 获取翻译任务状态
URL: https://generaltranslation.com/zh/docs/platform/openapi/reference/translation/job-status.mdx
---
title: 获取翻译任务状态
description: 获取 General Translation 中排队翻译任务的状态。获取翻译任务状态的 API 参考。

method: POST
---

返回一个或多个按 ID 指定的排队任务的状态。可用于轮询由 [Queue translations](/docs/platform/openapi/reference/translation/queue) 或 [Generate translation context](/docs/platform/openapi/reference/context/generate-context) 创建的任务。

## 概览 [#overview]

```http
POST https://api2.gtx.dev/v2/project/jobs/info
```

**权限** `project:files:read` · **速率限制** 默认 (200/分钟) 

通过一次请求即可查看后台任务的进度。

## 工作原理 [#how-it-works]

* 发送一个或多个 任务 ID。系统会在已认证的项目中查找这些 任务。
* 每个 任务 的原始 status 都会被标准化后：`pending` 和 `queued` 任务 会显示为 `queued`；`processing` 和 `retrying` 任务 会显示为 `processing`；`failed` 任务 会显示为 `failed`，并包含 `error.message`；`completed` 任务 会显示为 `completed`。
* 仅返回与所提供 ID 匹配的 任务。无法解析为 任务 的 ID 不会出现在响应数组中；如果请求中的 ID 都未匹配到任何 任务，则返回 `200` 和一个空数组。

## 请求 [#request]

### 请求头

| 请求头               | 说明                           | 必填 |
| ----------------- | ---------------------------- | -- |
| `x-gt-api-key`    | 项目或 Organization API 密钥。     | 是  |
| `x-gt-project-id` | 项目 ID。使用 Organization 密钥时必填。 | 否  |

### 响应体

**内容类型** `application/json`

| 字段       | 描述                              | 类型         | 可选 | 默认值 |
| -------- | ------------------------------- | ---------- | -- | --- |
| `jobIds` | 要查找的 job IDs；至少需要提供一个，且每个都不能为空。 | `string[]` | 否  | —   |

## 响应 [#response]

**状态** `200 OK`

响应为一个 JSON 数组，其中每个解析出的任务各对应一个条目：

```json title="Response"
[
  { "status": "completed", "jobId": "job_a..." },
  { "status": "processing", "jobId": "job_b..." },
  {
    "status": "failed",
    "jobId": "job_c...",
    "error": { "message": "Translation failed" }
  }
]
```

## 错误 [#errors]

| 状态    | 原因                                |
| ----- | --------------------------------- |
| `400` | 请求体无效，或 `jobIds` 数组为空。            |
| `401` | 缺少 API 密钥，或 API 密钥无效。             |
| `403` | API 密钥缺少 `project:files:read` 权限。 |
| `429` | 超出速率限制。                           |

## 示例 [#example]

```bash
curl -X POST https://api2.gtx.dev/v2/project/jobs/info \
  -H "x-gt-api-key: gtx-api-..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobIds": ["job_a...", "job_b..."]
  }'
```