جلب مهمة غير متزامنة | وثائق 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مطلوب

معرف المهمة الرقمي المعاد باسم jobId عند إنشاء المهمة.

مثال طلب

bash

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

الاستجابة

idstring

معرف المهمة.

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.
قد تنتهي صلاحية عناوين النتائج؛ احفظ الأصول المكتملة بسرعة.

استجابات الأخطاء

راجع رموز الأخطاء وتشخيصها للمرجع الكامل للرموز واختلافات البروتوكولات وخطوات التشخيص.

المهمة غير موجودة:

json

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

الوصول إلى مهمة حساب آخر:

json

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