Asenkron işi sorgulama | API Belgeleri

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

İlgili uç noktalar

Seedance 2.0 ve Seedance 2.5, data.jobId döndüren POST https://api.apihop.ai/v1/video/seedance kullanır; durum ve sonuç için GET https://api.apihop.ai/v1/jobs/{id} ile sorgulama gerekir.
Mevcut GPT-Image-2 görsel oluşturma uç noktası sonuçları doğrudan JSON veya SSE ile döndürür ve Jobs kullanmaz.

Bu uç noktayı yalnızca oluşturma yanıtı açıkça data.jobId içeriyorsa kullanın. API anahtarı, işi oluşturan hesapla aynı hesaba ait olmalıdır.

text

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

Kimlik doğrulama

http

Authorization: Bearer YOUR_API_KEY

Yol parametresi

idstringzorunlu

Oluşturma yanıtında jobId olarak döndürülen sayısal iş kimliği.

İstek örneği

bash

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

Yanıt

idstring

İş kimliği.

statusstring

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

inputParamsobject

İş oluşturulurken gönderilen girdi parametreleri.

outputResultunknown

Nihai çıktı. Görsel ve video modelleri farklı yapılar döndürür.

createdAtstring

ISO 8601 biçiminde oluşturulma zamanı.

startedAtstring | null

ISO 8601 biçiminde işlem başlangıç zamanı.

completedAtstring | null

ISO 8601 biçiminde tamamlanma zamanı.

Başarılı yanıt örneği

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

Periyodik sorgulama önerileri

Her 5 ila 10 saniyede bir sorgulayın.
PENDING, CONNECT ve PROCESSING son durumlar değildir.
COMPLETED sonrasında outputResult değerini okuyun.
FAILED veya CANCELLED sonrasında sorgulamayı durdurun.
Sonuç URL’lerinin süresi dolabilir; tamamlanan dosyaları gecikmeden kaydedin.

Hata yanıtları

Tam kod başvurusu, protokol farkları ve tanılama adımları için Hata kodları ve sorun giderme sayfasına bakın.

İş bulunamadı:

json

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

Başka bir hesabın işine erişim:

json

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