ดึงงานแบบอะซิงโครนัส | เอกสาร 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_..."
}
```

เอนด์พอยต์ที่เกี่ยวข้อง

Seedance 2.0 และ

Seedance 2.5 ใช้ POST https://api.apihop.ai/v1/video/seedance ซึ่งส่ง data.jobId กลับและต้องใช้ GET https://api.apihop.ai/v1/jobs/{id} เพื่อดึงสถานะและผลลัพธ์งาน

เอนด์พอยต์สร้างภาพ GPT-Image-2

ปัจจุบันส่งผลลัพธ์โดยตรงผ่าน JSON หรือ SSE และไม่ใช้ Jobs

ใช้เอนด์พอยต์นี้เฉพาะเมื่อการตอบกลับสร้างมี data.jobId อย่างชัดเจน คำขอต้องใช้คีย์ API ของบัญชีเดียวกับที่สร้างงาน

text

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

การยืนยันตัวตน

http

Authorization: Bearer YOUR_API_KEY

พารามิเตอร์เส้นทาง

idstringจำเป็น

ID งานแบบตัวเลขที่ส่งกลับเป็น jobId เมื่อสร้างงาน

ตัวอย่างคำขอ

bash

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

การตอบกลับ

idstring

ID งาน

statusstring

PENDING, CONNECT, PROCESSING, COMPLETED, FAILED หรือ CANCELLED

inputParamsobject

พารามิเตอร์อินพุตที่ส่งเมื่อสร้างงาน

outputResultunknown

เอาต์พุตสุดท้าย โมเดลภาพและวิดีโอส่งโครงสร้างต่างกัน

createdAtstring

เวลาสร้างรูปแบบ ISO 8601

startedAtstring | null

เวลาเริ่มประมวลผลรูปแบบ ISO 8601

completedAtstring | null

เวลาเสร็จสมบูรณ์รูปแบบ ISO 8601

ตัวอย่างสำเร็จ

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

แนวทางโพล

โพลทุก 5 ถึง 10 วินาที
PENDING, CONNECT และ PROCESSING ยังไม่ใช่สถานะสิ้นสุด
อ่าน outputResult หลัง COMPLETED
หยุดโพลหลัง FAILED หรือ CANCELLED
URL ผลลัพธ์อาจหมดอายุ บันทึกไฟล์ที่เสร็จแล้วโดยเร็ว

การตอบกลับผิดพลาด

ดูรหัสข้อผิดพลาดและการแก้ปัญหา สำหรับรหัสทั้งหมด ความต่างโปรโตคอล และขั้นตอนวินิจฉัย

ไม่พบงาน:

json

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

เข้าถึงงานของบัญชีอื่น:

json

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