[{"data":1,"prerenderedAt":885},["ShallowReactive",2],{"docs-/ko/docs/async-tasks":3},{"id":4,"title":5,"body":6,"description":877,"extension":878,"meta":879,"navigation":880,"path":881,"seo":882,"stem":883,"__hash__":884},"content/ko/docs/async-tasks.md","비동기 작업 API - Seedance 2.0",{"type":7,"value":8,"toc":864},"minimark",[9,14,27,32,42,47,89,93,262,266,370,374,497,501,603,607,743,747,802,806,839,843,860],[10,11,13],"h1",{"id":12},"비동기-작업","비동기 작업",[15,16,17,18,22,23,26],"p",{},"모든 비디오 생성 요청은 비동기적으로 처리됩니다. 생성 엔드포인트는 작업 ",[19,20,21],"code",{},"id","를 즉시 반환합니다. 작업 조회 엔드포인트를 사용하여 완료 여부를 폴링하거나, ",[19,24,25],{},"callback_url","을 설정하여 실시간 알림을 받을 수 있습니다.",[28,29,31],"h2",{"id":30},"작업-상태-조회","작업 상태 조회",[33,34,39],"pre",{"className":35,"code":37,"language":38},[36],"language-text","GET https://api.evolink.ai/v1/tasks/{task_id}\n","text",[19,40,37],{"__ignoreMap":41},"",[43,44,46],"h3",{"id":45},"경로-파라미터","경로 파라미터",[48,49,50,69],"table",{},[51,52,53],"thead",{},[54,55,56,60,63,66],"tr",{},[57,58,59],"th",{},"파라미터",[57,61,62],{},"타입",[57,64,65],{},"필수",[57,67,68],{},"설명",[70,71,72],"tbody",{},[54,73,74,80,83,86],{},[75,76,77],"td",{},[19,78,79],{},"task_id",[75,81,82],{},"string",[75,84,85],{},"예",[75,87,88],{},"생성 엔드포인트에서 반환된 작업 ID",[43,90,92],{"id":91},"응답-대기-중","응답 -- 대기 중",[33,94,98],{"className":95,"code":96,"language":97,"meta":41,"style":41},"language-json shiki shiki-themes github-dark","{\n    \"id\": \"task-unified-1756817821-4x3rx6ny\",\n    \"object\": \"video.generation.task\",\n    \"created\": 1756817821,\n    \"model\": \"seedance-2.0\",\n    \"status\": \"pending\",\n    \"progress\": 0,\n    \"type\": \"video\",\n    \"task_info\": {\n        \"can_cancel\": true,\n        \"estimated_time\": 165,\n        \"video_duration\": 5\n    }\n}\n","json",[19,99,100,109,126,139,152,165,178,191,204,213,226,239,250,256],{"__ignoreMap":41},[101,102,105],"span",{"class":103,"line":104},"line",1,[101,106,108],{"class":107},"s95oV","{\n",[101,110,112,116,119,123],{"class":103,"line":111},2,[101,113,115],{"class":114},"sDLfK","    \"id\"",[101,117,118],{"class":107},": ",[101,120,122],{"class":121},"sU2Wk","\"task-unified-1756817821-4x3rx6ny\"",[101,124,125],{"class":107},",\n",[101,127,129,132,134,137],{"class":103,"line":128},3,[101,130,131],{"class":114},"    \"object\"",[101,133,118],{"class":107},[101,135,136],{"class":121},"\"video.generation.task\"",[101,138,125],{"class":107},[101,140,142,145,147,150],{"class":103,"line":141},4,[101,143,144],{"class":114},"    \"created\"",[101,146,118],{"class":107},[101,148,149],{"class":114},"1756817821",[101,151,125],{"class":107},[101,153,155,158,160,163],{"class":103,"line":154},5,[101,156,157],{"class":114},"    \"model\"",[101,159,118],{"class":107},[101,161,162],{"class":121},"\"seedance-2.0\"",[101,164,125],{"class":107},[101,166,168,171,173,176],{"class":103,"line":167},6,[101,169,170],{"class":114},"    \"status\"",[101,172,118],{"class":107},[101,174,175],{"class":121},"\"pending\"",[101,177,125],{"class":107},[101,179,181,184,186,189],{"class":103,"line":180},7,[101,182,183],{"class":114},"    \"progress\"",[101,185,118],{"class":107},[101,187,188],{"class":114},"0",[101,190,125],{"class":107},[101,192,194,197,199,202],{"class":103,"line":193},8,[101,195,196],{"class":114},"    \"type\"",[101,198,118],{"class":107},[101,200,201],{"class":121},"\"video\"",[101,203,125],{"class":107},[101,205,207,210],{"class":103,"line":206},9,[101,208,209],{"class":114},"    \"task_info\"",[101,211,212],{"class":107},": {\n",[101,214,216,219,221,224],{"class":103,"line":215},10,[101,217,218],{"class":114},"        \"can_cancel\"",[101,220,118],{"class":107},[101,222,223],{"class":114},"true",[101,225,125],{"class":107},[101,227,229,232,234,237],{"class":103,"line":228},11,[101,230,231],{"class":114},"        \"estimated_time\"",[101,233,118],{"class":107},[101,235,236],{"class":114},"165",[101,238,125],{"class":107},[101,240,242,245,247],{"class":103,"line":241},12,[101,243,244],{"class":114},"        \"video_duration\"",[101,246,118],{"class":107},[101,248,249],{"class":114},"5\n",[101,251,253],{"class":103,"line":252},13,[101,254,255],{"class":107},"    }\n",[101,257,259],{"class":103,"line":258},14,[101,260,261],{"class":107},"}\n",[43,263,265],{"id":264},"응답-처리-중","응답 -- 처리 중",[33,267,269],{"className":95,"code":268,"language":97,"meta":41,"style":41},"{\n    \"id\": \"task-unified-1756817821-4x3rx6ny\",\n    \"object\": \"video.generation.task\",\n    \"created\": 1756817821,\n    \"model\": \"seedance-2.0\",\n    \"status\": \"processing\",\n    \"progress\": 65,\n    \"type\": \"video\",\n    \"task_info\": {\n        \"can_cancel\": true\n    }\n}\n",[19,270,271,275,285,295,305,315,326,337,347,353,362,366],{"__ignoreMap":41},[101,272,273],{"class":103,"line":104},[101,274,108],{"class":107},[101,276,277,279,281,283],{"class":103,"line":111},[101,278,115],{"class":114},[101,280,118],{"class":107},[101,282,122],{"class":121},[101,284,125],{"class":107},[101,286,287,289,291,293],{"class":103,"line":128},[101,288,131],{"class":114},[101,290,118],{"class":107},[101,292,136],{"class":121},[101,294,125],{"class":107},[101,296,297,299,301,303],{"class":103,"line":141},[101,298,144],{"class":114},[101,300,118],{"class":107},[101,302,149],{"class":114},[101,304,125],{"class":107},[101,306,307,309,311,313],{"class":103,"line":154},[101,308,157],{"class":114},[101,310,118],{"class":107},[101,312,162],{"class":121},[101,314,125],{"class":107},[101,316,317,319,321,324],{"class":103,"line":167},[101,318,170],{"class":114},[101,320,118],{"class":107},[101,322,323],{"class":121},"\"processing\"",[101,325,125],{"class":107},[101,327,328,330,332,335],{"class":103,"line":180},[101,329,183],{"class":114},[101,331,118],{"class":107},[101,333,334],{"class":114},"65",[101,336,125],{"class":107},[101,338,339,341,343,345],{"class":103,"line":193},[101,340,196],{"class":114},[101,342,118],{"class":107},[101,344,201],{"class":121},[101,346,125],{"class":107},[101,348,349,351],{"class":103,"line":206},[101,350,209],{"class":114},[101,352,212],{"class":107},[101,354,355,357,359],{"class":103,"line":215},[101,356,218],{"class":114},[101,358,118],{"class":107},[101,360,361],{"class":114},"true\n",[101,363,364],{"class":103,"line":228},[101,365,255],{"class":107},[101,367,368],{"class":103,"line":241},[101,369,261],{"class":107},[43,371,373],{"id":372},"응답-완료","응답 -- 완료",[33,375,377],{"className":95,"code":376,"language":97,"meta":41,"style":41},"{\n    \"id\": \"task-unified-1756817821-4x3rx6ny\",\n    \"object\": \"video.generation.task\",\n    \"created\": 1756817821,\n    \"model\": \"seedance-2.0\",\n    \"status\": \"completed\",\n    \"progress\": 100,\n    \"results\": [\n        \"https://cdn.example.com/videos/task-unified-1756817821-4x3rx6ny.mp4\"\n    ],\n    \"type\": \"video\",\n    \"task_info\": {\n        \"can_cancel\": false\n    }\n}\n",[19,378,379,383,393,403,413,423,434,445,453,458,463,473,479,488,492],{"__ignoreMap":41},[101,380,381],{"class":103,"line":104},[101,382,108],{"class":107},[101,384,385,387,389,391],{"class":103,"line":111},[101,386,115],{"class":114},[101,388,118],{"class":107},[101,390,122],{"class":121},[101,392,125],{"class":107},[101,394,395,397,399,401],{"class":103,"line":128},[101,396,131],{"class":114},[101,398,118],{"class":107},[101,400,136],{"class":121},[101,402,125],{"class":107},[101,404,405,407,409,411],{"class":103,"line":141},[101,406,144],{"class":114},[101,408,118],{"class":107},[101,410,149],{"class":114},[101,412,125],{"class":107},[101,414,415,417,419,421],{"class":103,"line":154},[101,416,157],{"class":114},[101,418,118],{"class":107},[101,420,162],{"class":121},[101,422,125],{"class":107},[101,424,425,427,429,432],{"class":103,"line":167},[101,426,170],{"class":114},[101,428,118],{"class":107},[101,430,431],{"class":121},"\"completed\"",[101,433,125],{"class":107},[101,435,436,438,440,443],{"class":103,"line":180},[101,437,183],{"class":114},[101,439,118],{"class":107},[101,441,442],{"class":114},"100",[101,444,125],{"class":107},[101,446,447,450],{"class":103,"line":193},[101,448,449],{"class":114},"    \"results\"",[101,451,452],{"class":107},": [\n",[101,454,455],{"class":103,"line":206},[101,456,457],{"class":121},"        \"https://cdn.example.com/videos/task-unified-1756817821-4x3rx6ny.mp4\"\n",[101,459,460],{"class":103,"line":215},[101,461,462],{"class":107},"    ],\n",[101,464,465,467,469,471],{"class":103,"line":228},[101,466,196],{"class":114},[101,468,118],{"class":107},[101,470,201],{"class":121},[101,472,125],{"class":107},[101,474,475,477],{"class":103,"line":241},[101,476,209],{"class":114},[101,478,212],{"class":107},[101,480,481,483,485],{"class":103,"line":252},[101,482,218],{"class":114},[101,484,118],{"class":107},[101,486,487],{"class":114},"false\n",[101,489,490],{"class":103,"line":258},[101,491,255],{"class":107},[101,493,495],{"class":103,"line":494},15,[101,496,261],{"class":107},[43,498,500],{"id":499},"응답-실패","응답 -- 실패",[33,502,504],{"className":95,"code":503,"language":97,"meta":41,"style":41},"{\n    \"id\": \"task-unified-1756817821-4x3rx6ny\",\n    \"object\": \"video.generation.task\",\n    \"created\": 1756817821,\n    \"model\": \"seedance-2.0\",\n    \"status\": \"failed\",\n    \"progress\": 0,\n    \"type\": \"video\",\n    \"task_info\": {\n        \"can_cancel\": false\n    }\n}\n",[19,505,506,510,520,530,540,550,561,571,581,587,595,599],{"__ignoreMap":41},[101,507,508],{"class":103,"line":104},[101,509,108],{"class":107},[101,511,512,514,516,518],{"class":103,"line":111},[101,513,115],{"class":114},[101,515,118],{"class":107},[101,517,122],{"class":121},[101,519,125],{"class":107},[101,521,522,524,526,528],{"class":103,"line":128},[101,523,131],{"class":114},[101,525,118],{"class":107},[101,527,136],{"class":121},[101,529,125],{"class":107},[101,531,532,534,536,538],{"class":103,"line":141},[101,533,144],{"class":114},[101,535,118],{"class":107},[101,537,149],{"class":114},[101,539,125],{"class":107},[101,541,542,544,546,548],{"class":103,"line":154},[101,543,157],{"class":114},[101,545,118],{"class":107},[101,547,162],{"class":121},[101,549,125],{"class":107},[101,551,552,554,556,559],{"class":103,"line":167},[101,553,170],{"class":114},[101,555,118],{"class":107},[101,557,558],{"class":121},"\"failed\"",[101,560,125],{"class":107},[101,562,563,565,567,569],{"class":103,"line":180},[101,564,183],{"class":114},[101,566,118],{"class":107},[101,568,188],{"class":114},[101,570,125],{"class":107},[101,572,573,575,577,579],{"class":103,"line":193},[101,574,196],{"class":114},[101,576,118],{"class":107},[101,578,201],{"class":121},[101,580,125],{"class":107},[101,582,583,585],{"class":103,"line":206},[101,584,209],{"class":114},[101,586,212],{"class":107},[101,588,589,591,593],{"class":103,"line":215},[101,590,218],{"class":114},[101,592,118],{"class":107},[101,594,487],{"class":114},[101,596,597],{"class":103,"line":228},[101,598,255],{"class":107},[101,600,601],{"class":103,"line":241},[101,602,261],{"class":107},[28,604,606],{"id":605},"응답-필드","응답 필드",[48,608,609,620],{},[51,610,611],{},[54,612,613,616,618],{},[57,614,615],{},"필드",[57,617,62],{},[57,619,68],{},[70,621,622,633,648,661,673,685,697,714,730],{},[54,623,624,628,630],{},[75,625,626],{},[19,627,21],{},[75,629,82],{},[75,631,632],{},"작업 ID",[54,634,635,640,642],{},[75,636,637],{},[19,638,639],{},"object",[75,641,82],{},[75,643,644,645],{},"작업 유형: ",[19,646,647],{},"video.generation.task",[54,649,650,655,658],{},[75,651,652],{},[19,653,654],{},"created",[75,656,657],{},"integer",[75,659,660],{},"작업 생성 Unix 타임스탬프",[54,662,663,668,670],{},[75,664,665],{},[19,666,667],{},"model",[75,669,82],{},[75,671,672],{},"사용된 모델",[54,674,675,680,682],{},[75,676,677],{},[19,678,679],{},"status",[75,681,82],{},[75,683,684],{},"현재 작업 상태 (아래 참조)",[54,686,687,692,694],{},[75,688,689],{},[19,690,691],{},"progress",[75,693,657],{},[75,695,696],{},"완료 비율 (0--100)",[54,698,699,704,707],{},[75,700,701],{},[19,702,703],{},"results",[75,705,706],{},"array",[75,708,709,710,713],{},"비디오 URL 배열 (",[19,711,712],{},"completed"," 상태일 때��� 존재)",[54,715,716,721,723],{},[75,717,718],{},[19,719,720],{},"type",[75,722,82],{},[75,724,725,726,729],{},"출력 유형 (",[19,727,728],{},"video",")",[54,731,732,737,740],{},[75,733,734],{},[19,735,736],{},"task_info.can_cancel",[75,738,739],{},"boolean",[75,741,742],{},"작업 취소 가능 여부",[28,744,746],{"id":745},"상태-값","상태 값",[48,748,749,758],{},[51,750,751],{},[54,752,753,756],{},[57,754,755],{},"상태",[57,757,68],{},[70,759,760,770,780,792],{},[54,761,762,767],{},[75,763,764],{},[19,765,766],{},"pending",[75,768,769],{},"작업이 큐에 등록되어 시작 대기 중입니다",[54,771,772,777],{},[75,773,774],{},[19,775,776],{},"processing",[75,778,779],{},"비디오가 생성되고 있습니다",[54,781,782,786],{},[75,783,784],{},[19,785,712],{},[75,787,788,789,791],{},"비디오가 준비되었습니다 -- ",[19,790,703],{}," 배열에서 URL을 확인하세요",[54,793,794,799],{},[75,795,796],{},[19,797,798],{},"failed",[75,800,801],{},"생성에 실패했습니다",[28,803,805],{"id":804},"폴링-모범-사례","폴링 모범 사례",[807,808,809,818,821,833],"ul",{},[810,811,812,813,817],"li",{},"최적의 균형을 위해 ",[814,815,816],"strong",{},"5초"," 간격으로 폴링하세요",[810,819,820],{},"일반적인 생성 시간은 영상 길이와 화질 설정에 따라 달라집니다",[810,822,823,824,826,827,832],{},"프로덕션 환경에서는 폴링 대신 ",[19,825,25],{},"을 통한 ",[828,829,831],"a",{"href":830},"/docs/webhooks","Webhooks"," 사용을 권장합니다",[810,834,835,838],{},[814,836,837],{},"비디오 URL은 24시간 동안 유효합니다"," -- 신속하게 다운로드하여 저장하세요",[28,840,842],{"id":841},"관련-문서","관련 문서",[807,844,845,853],{},[810,846,847,849,850,852],{},[828,848,831],{"href":830}," -- ",[19,851,25],{},"을 통한 실시간 완료 알림",[810,854,855,859],{},[828,856,858],{"href":857},"/docs/error-codes","오류 코드"," -- 실패 시나리오 처리",[861,862,863],"style",{},"html pre.shiki code .s95oV, html code.shiki .s95oV{--shiki-default:#E1E4E8}html pre.shiki code .sDLfK, html code.shiki .sDLfK{--shiki-default:#79B8FF}html pre.shiki code .sU2Wk, html code.shiki .sU2Wk{--shiki-default:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}",{"title":41,"searchDepth":111,"depth":111,"links":865},[866,873,874,875,876],{"id":30,"depth":111,"text":31,"children":867},[868,869,870,871,872],{"id":45,"depth":128,"text":46},{"id":91,"depth":128,"text":92},{"id":264,"depth":128,"text":265},{"id":372,"depth":128,"text":373},{"id":499,"depth":128,"text":500},{"id":605,"depth":111,"text":606},{"id":745,"depth":111,"text":746},{"id":804,"depth":111,"text":805},{"id":841,"depth":111,"text":842},"비디오 생성 작업 상태를 조회하고 Seedance 2.0 API로 완료된 비디오를 가져옵니다.","md",{},true,"/ko/docs/async-tasks",{"title":5,"description":877},"ko/docs/async-tasks","_qJrmfRBRK-RR1BcmyAXXvmqguoJYFs614DrjBq6aus",1775067575267]