Truy vấn tác vụ bất đồng bộ | Tài liệu API

# Get Async Job

Get the status and result of an asynchronous job created by the current account.

GET https://api.apihop.ai/v1/jobs/{id}

## Applicable Endpoints

- [Seedance 2.0](https://apihop.ai/en/docs/api-reference/BytePlus/seedance-2-0) and

[Seedance 2.5](https://apihop.ai/en/docs/api-reference/BytePlus/seedance-2-5) use `POST https://api.apihop.ai/v1/video/seedance`, which returns `data.jobId` and requires `GET https://api.apihop.ai/v1/jobs/{id}` to retrieve job status and results.

- The current [GPT-Image-2 Image Generation](https://apihop.ai/en/docs/api-reference/OpenAI/gpt-image-2)

endpoint returns results directly through JSON or SSE and does not use Jobs.

Use this endpoint only when a creation response explicitly contains `data.jobId`. The request must use an API Key belonging to the same account that created the job.

```text
GET https://api.apihop.ai/v1/jobs/{id}
```

## Authentication

```http
Authorization: Bearer YOUR_API_KEY
```

## Path Parameter

### `id` (string, required)

Numeric job ID returned as `jobId` when the job was created.

## Request Example

```bash
curl --request GET \
  --url https://api.apihop.ai/v1/jobs/123456789012345678 \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

## Response

### `id` (string)

Job ID.

### `status` (string)

`PENDING`, `CONNECT`, `PROCESSING`, `COMPLETED`, `FAILED`, or `CANCELLED`.

### `inputParams` (object)

Input parameters submitted when the job was created.

### `outputResult` (unknown)

Final output. Image and video models return different structures.

### `createdAt` (string)

ISO 8601 creation timestamp.

### `startedAt` (string | null)

ISO 8601 processing start time.

### `completedAt` (string | null)

ISO 8601 completion time.

### Success Example

```json
{
  "success": true,
  "data": {
    "id": "123456789012345678",
    "status": "COMPLETED",
    "inputParams": {
      "model": "seedance-2.5",
      "prompt": "Create an eight-second brand film"
    },
    "outputResult": [
      {
        "url": [
          "https://video.example.com/generated/result.mp4"
        ]
      }
    ],
    "createdAt": "2026-08-20T08:24:00.000Z",
    "startedAt": "2026-08-20T08:24:02.000Z",
    "completedAt": "2026-08-20T08:26:30.000Z"
  },
  "requestId": "req_..."
}
```

## Polling Guidance

- Poll every 5 to 10 seconds.
- `PENDING`, `CONNECT`, and `PROCESSING` are non-terminal.
- Read `outputResult` after `COMPLETED`.
- Stop polling after `FAILED` or `CANCELLED`.
- Result URLs may expire; save completed assets promptly.

## Error Responses

See [Error Codes and Troubleshooting](https://apihop.ai/en/docs/api-reference/errors) for the full code reference, protocol differences, and diagnostic steps.

Job not found:

```json
{
  "success": false,
  "error": {
    "code": 30000,
    "message": "Job 123456789012345678 not found"
  },
  "requestId": "req_..."
}
```

Accessing another account's job:

```json
{
  "success": false,
  "error": {
    "code": 20001,
    "message": "Access denied"
  },
  "requestId": "req_..."
}
```

Điểm cuối áp dụng

Seedance 2.0 và

Seedance 2.5 dùng POST https://api.apihop.ai/v1/video/seedance, trả data.jobId và cần GET https://api.apihop.ai/v1/jobs/{id} để lấy trạng thái cùng kết quả tác vụ.

Điểm cuối Tạo ảnh GPT-Image-2

hiện trả kết quả trực tiếp qua JSON hoặc SSE và không dùng tác vụ Jobs.

Chỉ dùng điểm cuối này khi phản hồi tạo chứa rõ data.jobId. Yêu cầu phải dùng khóa API thuộc cùng tài khoản đã tạo tác vụ.

text

GET https://api.apihop.ai/v1/jobs/{id}

Xác thực

http

Authorization: Bearer YOUR_API_KEY

Tham số đường dẫn

idstringbắt buộc

ID tác vụ dạng số trả về dưới tên jobId khi tạo tác vụ.

Ví dụ yêu cầu

bash

curl --request GET \
  --url https://api.apihop.ai/v1/jobs/123456789012345678 \
  --header 'Authorization: Bearer YOUR_API_KEY'

Phản hồi

idstring

ID tác vụ.

statusstring

PENDING, CONNECT, PROCESSING, COMPLETED, FAILED hoặc CANCELLED.

inputParamsobject

Tham số đầu vào gửi khi tạo tác vụ.

outputResultunknown

Đầu ra cuối. Mô hình ảnh và video trả cấu trúc khác nhau.

createdAtstring

Dấu thời gian tạo ISO 8601.

startedAtstring | null

Thời gian bắt đầu xử lý ISO 8601.

completedAtstring | null

Thời gian hoàn thành ISO 8601.

Ví dụ thành công

json

{
  "success": true,
  "data": {
    "id": "123456789012345678",
    "status": "COMPLETED",
    "inputParams": {
      "model": "seedance-2.5",
      "prompt": "Create an eight-second brand film"
    },
    "outputResult": [
      {
        "url": [
          "https://video.example.com/generated/result.mp4"
        ]
      }
    ],
    "createdAt": "2026-08-20T08:24:00.000Z",
    "startedAt": "2026-08-20T08:24:02.000Z",
    "completedAt": "2026-08-20T08:26:30.000Z"
  },
  "requestId": "req_..."
}

Hướng dẫn thăm dò

Thăm dò mỗi 5 đến 10 giây.
PENDING, CONNECT và PROCESSING chưa phải trạng thái cuối.
Đọc outputResult sau COMPLETED.
Dừng thăm dò sau FAILED hoặc CANCELLED.
URL kết quả có thể hết hạn; lưu tài nguyên hoàn tất kịp thời.

Phản hồi lỗi

Xem Mã lỗi và khắc phục để có tham chiếu mã đầy đủ, khác biệt giao thức và bước chẩn đoán.

Không tìm thấy tác vụ:

json

{
  "success": false,
  "error": {
    "code": 30000,
    "message": "Job 123456789012345678 not found"
  },
  "requestId": "req_..."
}

Truy cập tác vụ tài khoản khác:

json

{
  "success": false,
  "error": {
    "code": 20001,
    "message": "Access denied"
  },
  "requestId": "req_..."
}