메인 콘텐츠로 건너뛰기
GET
/
v1
/
tasks
/
{task_id}
작업 상태 조회
curl --request GET \
  --url https://api.evolink.ai/v1/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "created": 1756817821,
  "id": "task-unified-1756817821-4x3rx6ny",
  "model": "gemini-3.1-flash-image-preview",
  "object": "image.generation.task",
  "progress": 100,
  "results": [
    "http://example.com/image.jpg"
  ],
  "status": "completed",
  "error": {
    "code": "content_policy_violation",
    "message": "Content policy violation.\nYour request was blocked by safety filters.",
    "type": "task_error"
  },
  "task_info": {
    "can_cancel": false
  },
  "type": "image"
}

인증

​
Authorization
string
header
필수

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

API Key 받기:

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

요청 헤더에 추가:

Authorization: Bearer YOUR_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>[]

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

예시:
["http://example.com/image.jpg"]
​
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"