Ambil Tugas Asinkron | Dokumentasi 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_..."
}
```

Endpoint Terkait

Seedance 2.0 dan

Seedance 2.5 menggunakan POST https://api.apihop.ai/v1/video/seedance, yang mengembalikan data.jobId dan memerlukan GET https://api.apihop.ai/v1/jobs/{id} untuk mengambil status serta hasil tugas.

Endpoint Pembuatan Gambar GPT-Image-2 saat ini

mengembalikan hasil langsung melalui JSON atau SSE dan tidak menggunakan Jobs.

Gunakan endpoint ini hanya jika respons pembuatan secara eksplisit berisi data.jobId. Permintaan harus menggunakan kunci API milik akun yang sama dengan pembuat tugas.

text

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

Autentikasi

http

Authorization: Bearer YOUR_API_KEY

Parameter Jalur

idstringwajib

ID tugas numerik yang dikembalikan sebagai jobId saat tugas dibuat.

Contoh Permintaan

bash

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

Respons

idstring

ID tugas.

statusstring

PENDING, CONNECT, PROCESSING, COMPLETED, FAILED, atau CANCELLED.

inputParamsobject

Parameter input yang dikirim saat tugas dibuat.

outputResultunknown

Output akhir. Model gambar dan video mengembalikan struktur yang berbeda.

createdAtstring

Stempel waktu pembuatan dalam ISO 8601.

startedAtstring | null

Waktu mulai pemrosesan dalam ISO 8601.

completedAtstring | null

Waktu penyelesaian dalam ISO 8601.

Contoh Berhasil

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_..."
}

Panduan Polling

Lakukan polling setiap 5 hingga 10 detik.
PENDING, CONNECT, dan PROCESSING bukan status akhir.
Baca outputResult setelah COMPLETED.
Hentikan polling setelah FAILED atau CANCELLED.
URL hasil dapat kedaluwarsa; segera simpan aset yang telah selesai.

Respons Kesalahan

Lihat Kode Kesalahan dan Pemecahan Masalah untuk referensi kode lengkap, perbedaan protokol, dan langkah diagnosis.

Tugas tidak ditemukan:

json

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

Mengakses tugas milik akun lain:

json

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