메인 콘텐츠로 건너뛰기
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.1-flash-image-preview"

object
enum<string>

작업 유형

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

"image.generation.task"

progress
integer

작업 진행률 백분율

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

100

results
string<uri>[]

작업 결과 목록 (완료 시 제공)

예시:
status
enum<string>

작업 상태

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

"completed"

error
object | null

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

task_info
object

작업 상세 정보

type
enum<string>

작업 유형

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

"image"