비동기 작업 조회 | 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로 반환된 숫자 작업 ID입니다.

요청 예제

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은 최종 상태가 아닙니다.
COMPLETED 후 outputResult를 읽으세요.
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_..."
}