Pobierz zadanie asynchroniczne | Dokumentacja 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_..."
}
```

Obsługiwane punkty końcowe

Seedance 2.0 i

Seedance 2.5 używają POST https://api.apihop.ai/v1/video/seedance, który zwraca data.jobId i wymaga GET https://api.apihop.ai/v1/jobs/{id} do pobrania statusu i wyników zadania.

Bieżący punkt końcowy Generowanie obrazów GPT-Image-2

zwraca wyniki bezpośrednio przez JSON lub SSE i nie używa Jobs.

Używaj tego punktu końcowego tylko wtedy, gdy odpowiedź utworzenia jawnie zawiera data.jobId. Żądanie musi używać klucza API należącego do tego samego konta, które utworzyło zadanie.

text

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

Uwierzytelnianie

http

Authorization: Bearer YOUR_API_KEY

Parametr ścieżki

idstringWymagane

Numeryczny ID zadania zwrócony jako jobId przy utworzeniu.

Przykład żądania

bash

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

Odpowiedź

idstring

ID zadania.

statusstring

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

inputParamsobject

Parametry wejściowe przesłane przy utworzeniu zadania.

outputResultunknown

Końcowy wynik. Modele obrazów i wideo zwracają różne struktury.

createdAtstring

Znacznik czasu utworzenia w ISO 8601.

startedAtstring | null

Czas rozpoczęcia przetwarzania w ISO 8601.

completedAtstring | null

Czas ukończenia w ISO 8601.

Przykład powodzenia

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

Wskazówki odpytywania

Odpytuj co 5 do 10 sekund.
PENDING, CONNECT i PROCESSING nie są stanami końcowymi.
Odczytaj outputResult po COMPLETED.
Zatrzymaj odpytywanie po FAILED lub CANCELLED.
Adresy wyników mogą wygasać; niezwłocznie zapisuj ukończone zasoby.

Odpowiedzi błędów

Zobacz kody błędów i diagnozowanie, aby poznać pełny wykaz kodów, różnice protokołów i kroki diagnostyczne.

Nie znaleziono zadania:

json

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

Dostęp do zadania innego konta:

json

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