Asynchronen Auftrag abrufen | API-Dokumentation

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

Zugehörige Endpunkte

Seedance 2.0 und Seedance 2.5 verwenden POST https://api.apihop.ai/v1/video/seedance, das data.jobId zurückgibt und GET https://api.apihop.ai/v1/jobs/{id} zum Abrufen von Status und Ergebnis erfordert.
Der aktuelle Endpunkt GPT-Image-2-Bilderzeugung liefert Ergebnisse direkt per JSON oder SSE und verwendet keine Jobs.

Verwenden Sie diesen Endpunkt nur, wenn die Erstellungsantwort ausdrücklich data.jobId enthält. Der API-Schlüssel muss zu demselben Konto gehören, das den Auftrag erstellt hat.

text

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

Authentifizierung

http

Authorization: Bearer YOUR_API_KEY

Pfadparameter

idstringerforderlich

Numerische Auftrags-ID, die beim Anlegen als jobId zurückgegeben wurde.

Anfragebeispiel

bash

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

Antwort

idstring

Auftrags-ID.

statusstring

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

inputParamsobject

Beim Anlegen übermittelte Eingabeparameter.

outputResultunknown

Endgültige Ausgabe. Bild- und Videomodelle liefern unterschiedliche Strukturen.

createdAtstring

Erstellungszeitstempel nach ISO 8601.

startedAtstring | null

Beginn der Verarbeitung nach ISO 8601.

completedAtstring | null

Abschlusszeit nach ISO 8601.

Erfolgsbeispiel

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

Abfragehinweise

Fragen Sie alle 5 bis 10 Sekunden ab.
PENDING, CONNECT und PROCESSING sind keine Endzustände.
Lesen Sie outputResult nach COMPLETED.
Beenden Sie die Abfragen nach FAILED oder CANCELLED.
Ergebnis-URLs können ablaufen; speichern Sie fertige Dateien zeitnah.

Fehlerantworten

Die vollständige Codereferenz, Protokollunterschiede und Diagnoseschritte finden Sie unter Fehlercodes und Fehlerbehebung.

Auftrag nicht gefunden:

json

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

Zugriff auf den Auftrag eines anderen Kontos:

json

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