Skip to main content
GET
작업 상태 조회

인증

Authorization
string
header
필수

##모든 API는 Bearer Token 인증이 필요합니다##

API Key 받기:

API Key 관리 페이지를 방문하여 API Key를 받으세요

요청 헤더에 추가:

경로 매개변수

task_id
string
필수

작업 ID, 조회 시 {}를 무시하고 비동기 작업 응답 본문의 id를 경로 끝에 추가하세요

응답

작업 상태 세부 정보

created
integer

작업 생성 타임스탬프

예시:

1756817821

id
string

작업 ID

예시:

"task-unified-1756817821-4x3rx6ny"

model
string

사용된 모델

예시:

"gemini-3-pro-image-preview"

object
enum<string>

작업 유형

사용 가능한 옵션:
image.generation.task,
video.generation.task,
audio.generation.task
예시:

"image.generation.task"

progress
integer

작업 진행률 백분율

필수 범위: 0 <= x <= 100
예시:

100

status
enum<string>

작업 상태. 참고: 작업이 업스트림에서 아직 대기 중이어도 조회 API는 이미 "processing"을 반환하므로, 클라이언트는 보통 processing / completed / failed만 보게 됩니다.

사용 가능한 옵션:
pending,
processing,
completed,
failed
예시:

"completed"

type
enum<string>

작업 유형

사용 가능한 옵션:
image,
video,
audio,
text
예시:

"image"

duration
integer

작업 소요 시간(초). status가 "completed" 또는 "failed"일 때만 반환됩니다.

예시:

30

video_duration
number

실제 생성된 영상 길이(초). 일부 영상 모델(예: Kling)의 최종 상태에서만 반환됩니다.

예시:

5

draft_expires_at
string<date-time>

최종 비디오로 변환할 수 있는 기한(UTC, RFC 3339). 생성 시 draft: true를 전달한 Seedance 2.5 초안이 completed 상태일 때만 반환됩니다. 이 시각이 지나면 Seedance 2.5 Draft-to-Video로 변환할 수 없습니다

예시:

"2026-09-23T17:19:36Z"

source_task_id
string

이 최종 비디오의 변환 원본인 초안 작업의 ID. Seedance 2.5 Draft-to-Video 작업에서만 반환됩니다

예시:

"task-unified-1774857405-abc123"

results
string<uri>[]

결과 URL 목록. status가 "completed"이고 모델이 URL 결과를 생성하는 경우에만 반환되며, 그 외에는 필드 자체가 없습니다.

예시:
result_data
any

모델별 전체 결과 객체. 이미지 모델은 [{"url": ...}] 형태의 객체 배열(results와 동일한 URL)이며, 일부 모델은 더 풍부한 객체를 반환합니다(예: Suno는 곡 객체). 구조화된 결과가 없는 모델에서는 반환되지 않습니다.

예시:
usage
object

사용량 및 과금 정보. status가 "completed"일 때만 반환됩니다. credits_used와 cost는 항상 포함되며, 토큰 필드는 토큰 과금 모델(예: gpt-image-2)에서만 반환됩니다. 일부 모델은 모델별 과금 필드를 추가로 반환합니다.

error
object | null

작업 실패 시 오류 정보 (status가 failed일 때만 표시). 참고: 여기의 error.code는 문자열 유형의 비즈니스 오류 코드로 HTTP 상태 코드와 다릅니다. 전체 목록은 오류 코드 참조 문서를 확인하세요.

task_info
object

작업 상세 정보

effective_speed
enum<string>

Midjourney V7 variation / pan / outpaint: prompt는 선택 사항입니다. 생략, 빈 문자열, 공백만 있거나 제어 대상 속도·버전 매개변수를 제거한 뒤 비어 있으면 speed=turbo여도 Fast로 실행하고 Fast 요금을 적용합니다. 유효한 본문이 있으면 속도 생략 또는 fast는 Fast, turbo는 Turbo로 실행하며 Fast 요금의 2배입니다. Playground는 Fast만 제공합니다. 원본 작업은 현재 사용자의 완료된 작업이어야 합니다. prompt가 없을 때는 이미지 생성 및 지원되는 variation, pan, outpaint 결과를 사용할 수 있습니다. Historical tasks retain their recorded execution speed and billing.

사용 가능한 옵션:
draft,
fast,
turbo