비동기 작업

모든 비디오 생성 요청은 비동기적으로 처리됩니다. 생성 엔드포인트는 작업 id를 즉시 반환합니다. 작업 조회 엔드포인트를 사용하여 완료 여부를 폴링하거나, callback_url을 설정하여 실시간 알림을 받을 수 있습니다.

작업 상태 조회

GET https://api.evolink.ai/v1/tasks/{task_id}

경로 파라미터

파라미터	타입	필수	설명
`task_id`	string	예	생성 엔드포인트에서 반환된 작업 ID

응답 -- 대기 중

{
    "id": "task-unified-1756817821-4x3rx6ny",
    "object": "video.generation.task",
    "created": 1756817821,
    "model": "seedance-2.0",
    "status": "pending",
    "progress": 0,
    "type": "video",
    "task_info": {
        "can_cancel": true,
        "estimated_time": 165,
        "video_duration": 5
    }
}

응답 -- 처리 중

{
    "id": "task-unified-1756817821-4x3rx6ny",
    "object": "video.generation.task",
    "created": 1756817821,
    "model": "seedance-2.0",
    "status": "processing",
    "progress": 65,
    "type": "video",
    "task_info": {
        "can_cancel": true
    }
}

응답 -- 완료

{
    "id": "task-unified-1756817821-4x3rx6ny",
    "object": "video.generation.task",
    "created": 1756817821,
    "model": "seedance-2.0",
    "status": "completed",
    "progress": 100,
    "results": [
        "https://cdn.example.com/videos/task-unified-1756817821-4x3rx6ny.mp4"
    ],
    "type": "video",
    "task_info": {
        "can_cancel": false
    }
}

응답 -- 실패

{
    "id": "task-unified-1756817821-4x3rx6ny",
    "object": "video.generation.task",
    "created": 1756817821,
    "model": "seedance-2.0",
    "status": "failed",
    "progress": 0,
    "type": "video",
    "task_info": {
        "can_cancel": false
    }
}

응답 필드

필드	타입	설명
`id`	string	작업 ID
`object`	string	작업 유형: `video.generation.task`
`created`	integer	작업 생성 Unix 타임스탬프
`model`	string	사용된 모델
`status`	string	현재 작업 상태 (아래 참조)
`progress`	integer	완료 비율 (0--100)
`results`	array	비디오 URL 배열 (`completed` 상태일 때�� 존재)
`type`	string	출력 유형 (`video`)
`task_info.can_cancel`	boolean	작업 취소 가능 여부

상태 값

상태	설명
`pending`	작업이 큐에 등록되어 시작 대기 중입니다
`processing`	비디오가 생성되고 있습니다
`completed`	비디오가 준비되었습니다 -- `results` 배열에서 URL을 확인하세요
`failed`	생성에 실패했습니다

폴링 모범 사례

최적의 균형을 위해 5초 간격으로 폴링하세요
일반적인 생성 시간은 영상 길이와 화질 설정에 따라 달라집니다
프로덕션 환경에서는 폴링 대신 callback_url을 통한 Webhooks 사용을 권장합니다
비디오 URL은 24시간 동안 유효합니다 -- 신속하게 다운로드하여 저장하세요