[{"data":1,"prerenderedAt":631},["ShallowReactive",2],{"docs-/ko/docs/webhooks":3},{"id":4,"title":5,"body":6,"description":624,"extension":625,"meta":626,"navigation":58,"path":627,"seo":628,"stem":629,"__hash__":630},"content/ko/docs/webhooks.md","Webhooks - Seedance 2.0 API",{"type":7,"value":8,"toc":614},"minimark",[9,14,18,23,31,197,201,212,216,356,359,462,466,486,490,589,593,610],[10,11,13],"h1",{"id":12},"webhooks-callback-url","Webhooks (Callback URL)",[15,16,17],"p",{},"작업 상태 엔드포인트를 폴링하는 대신, 비디오 생성 작업이 완료, 실패 또는 취소될 때 실시간 HTTP POST 알림을 받을 수 있습니다.",[19,20,22],"h2",{"id":21},"콜백-설정","콜백 설정",[15,24,25,26,30],{},"생성 요청에 ",[27,28,29],"code",{},"callback_url","을 포함하세요:",[32,33,38],"pre",{"className":34,"code":35,"language":36,"meta":37,"style":37},"language-python shiki shiki-themes github-dark","import requests\n\nresponse = requests.post(\n    \"https://api.evolink.ai/v1/videos/generations\",\n    headers={\n        \"Authorization\": \"Bearer YOUR_API_KEY\",\n        \"Content-Type\": \"application/json\"\n    },\n    json={\n        \"model\": \"seedance-2.0\",\n        \"prompt\": \"A sunset over the ocean, cinematic wide shot\",\n        \"quality\": \"1080p\",\n        \"callback_url\": \"https://yourapp.com/api/video-callback\"\n    }\n)\n","python","",[27,39,40,53,60,72,82,94,108,119,125,135,148,161,174,185,191],{"__ignoreMap":37},[41,42,45,49],"span",{"class":43,"line":44},"line",1,[41,46,48],{"class":47},"snl16","import",[41,50,52],{"class":51},"s95oV"," requests\n",[41,54,56],{"class":43,"line":55},2,[41,57,59],{"emptyLinePlaceholder":58},true,"\n",[41,61,63,66,69],{"class":43,"line":62},3,[41,64,65],{"class":51},"response ",[41,67,68],{"class":47},"=",[41,70,71],{"class":51}," requests.post(\n",[41,73,75,79],{"class":43,"line":74},4,[41,76,78],{"class":77},"sU2Wk","    \"https://api.evolink.ai/v1/videos/generations\"",[41,80,81],{"class":51},",\n",[41,83,85,89,91],{"class":43,"line":84},5,[41,86,88],{"class":87},"s9osk","    headers",[41,90,68],{"class":47},[41,92,93],{"class":51},"{\n",[41,95,97,100,103,106],{"class":43,"line":96},6,[41,98,99],{"class":77},"        \"Authorization\"",[41,101,102],{"class":51},": ",[41,104,105],{"class":77},"\"Bearer YOUR_API_KEY\"",[41,107,81],{"class":51},[41,109,111,114,116],{"class":43,"line":110},7,[41,112,113],{"class":77},"        \"Content-Type\"",[41,115,102],{"class":51},[41,117,118],{"class":77},"\"application/json\"\n",[41,120,122],{"class":43,"line":121},8,[41,123,124],{"class":51},"    },\n",[41,126,128,131,133],{"class":43,"line":127},9,[41,129,130],{"class":87},"    json",[41,132,68],{"class":47},[41,134,93],{"class":51},[41,136,138,141,143,146],{"class":43,"line":137},10,[41,139,140],{"class":77},"        \"model\"",[41,142,102],{"class":51},[41,144,145],{"class":77},"\"seedance-2.0\"",[41,147,81],{"class":51},[41,149,151,154,156,159],{"class":43,"line":150},11,[41,152,153],{"class":77},"        \"prompt\"",[41,155,102],{"class":51},[41,157,158],{"class":77},"\"A sunset over the ocean, cinematic wide shot\"",[41,160,81],{"class":51},[41,162,164,167,169,172],{"class":43,"line":163},12,[41,165,166],{"class":77},"        \"quality\"",[41,168,102],{"class":51},[41,170,171],{"class":77},"\"1080p\"",[41,173,81],{"class":51},[41,175,177,180,182],{"class":43,"line":176},13,[41,178,179],{"class":77},"        \"callback_url\"",[41,181,102],{"class":51},[41,183,184],{"class":77},"\"https://yourapp.com/api/video-callback\"\n",[41,186,188],{"class":43,"line":187},14,[41,189,190],{"class":51},"    }\n",[41,192,194],{"class":43,"line":193},15,[41,195,196],{"class":51},")\n",[19,198,200],{"id":199},"콜백-페이로드","콜백 페이로드",[15,202,203,204,206,207,211],{},"작업이 완료(또는 실패)되면 ",[27,205,29],{},"로 POST 요청이 전송됩니다. 응답 본문의 형식은 ",[208,209,210],"strong",{},"작업 조회 API 응답과 동일합니다",":",[213,214,215],"h3",{"id":215},"완료",[32,217,221],{"className":218,"code":219,"language":220,"meta":37,"style":37},"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\": \"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","json",[27,222,223,227,240,252,264,275,287,299,307,312,317,329,337,347,351],{"__ignoreMap":37},[41,224,225],{"class":43,"line":44},[41,226,93],{"class":51},[41,228,229,233,235,238],{"class":43,"line":55},[41,230,232],{"class":231},"sDLfK","    \"id\"",[41,234,102],{"class":51},[41,236,237],{"class":77},"\"task-unified-1756817821-4x3rx6ny\"",[41,239,81],{"class":51},[41,241,242,245,247,250],{"class":43,"line":62},[41,243,244],{"class":231},"    \"object\"",[41,246,102],{"class":51},[41,248,249],{"class":77},"\"video.generation.task\"",[41,251,81],{"class":51},[41,253,254,257,259,262],{"class":43,"line":74},[41,255,256],{"class":231},"    \"created\"",[41,258,102],{"class":51},[41,260,261],{"class":231},"1756817821",[41,263,81],{"class":51},[41,265,266,269,271,273],{"class":43,"line":84},[41,267,268],{"class":231},"    \"model\"",[41,270,102],{"class":51},[41,272,145],{"class":77},[41,274,81],{"class":51},[41,276,277,280,282,285],{"class":43,"line":96},[41,278,279],{"class":231},"    \"status\"",[41,281,102],{"class":51},[41,283,284],{"class":77},"\"completed\"",[41,286,81],{"class":51},[41,288,289,292,294,297],{"class":43,"line":110},[41,290,291],{"class":231},"    \"progress\"",[41,293,102],{"class":51},[41,295,296],{"class":231},"100",[41,298,81],{"class":51},[41,300,301,304],{"class":43,"line":121},[41,302,303],{"class":231},"    \"results\"",[41,305,306],{"class":51},": [\n",[41,308,309],{"class":43,"line":127},[41,310,311],{"class":77},"        \"https://cdn.example.com/videos/task-unified-1756817821-4x3rx6ny.mp4\"\n",[41,313,314],{"class":43,"line":137},[41,315,316],{"class":51},"    ],\n",[41,318,319,322,324,327],{"class":43,"line":150},[41,320,321],{"class":231},"    \"type\"",[41,323,102],{"class":51},[41,325,326],{"class":77},"\"video\"",[41,328,81],{"class":51},[41,330,331,334],{"class":43,"line":163},[41,332,333],{"class":231},"    \"task_info\"",[41,335,336],{"class":51},": {\n",[41,338,339,342,344],{"class":43,"line":176},[41,340,341],{"class":231},"        \"can_cancel\"",[41,343,102],{"class":51},[41,345,346],{"class":231},"false\n",[41,348,349],{"class":43,"line":187},[41,350,190],{"class":51},[41,352,353],{"class":43,"line":193},[41,354,355],{"class":51},"}\n",[213,357,358],{"id":358},"실패",[32,360,362],{"className":218,"code":361,"language":220,"meta":37,"style":37},"{\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",[27,363,364,368,378,388,398,408,419,430,440,446,454,458],{"__ignoreMap":37},[41,365,366],{"class":43,"line":44},[41,367,93],{"class":51},[41,369,370,372,374,376],{"class":43,"line":55},[41,371,232],{"class":231},[41,373,102],{"class":51},[41,375,237],{"class":77},[41,377,81],{"class":51},[41,379,380,382,384,386],{"class":43,"line":62},[41,381,244],{"class":231},[41,383,102],{"class":51},[41,385,249],{"class":77},[41,387,81],{"class":51},[41,389,390,392,394,396],{"class":43,"line":74},[41,391,256],{"class":231},[41,393,102],{"class":51},[41,395,261],{"class":231},[41,397,81],{"class":51},[41,399,400,402,404,406],{"class":43,"line":84},[41,401,268],{"class":231},[41,403,102],{"class":51},[41,405,145],{"class":77},[41,407,81],{"class":51},[41,409,410,412,414,417],{"class":43,"line":96},[41,411,279],{"class":231},[41,413,102],{"class":51},[41,415,416],{"class":77},"\"failed\"",[41,418,81],{"class":51},[41,420,421,423,425,428],{"class":43,"line":110},[41,422,291],{"class":231},[41,424,102],{"class":51},[41,426,427],{"class":231},"0",[41,429,81],{"class":51},[41,431,432,434,436,438],{"class":43,"line":121},[41,433,321],{"class":231},[41,435,102],{"class":51},[41,437,326],{"class":77},[41,439,81],{"class":51},[41,441,442,444],{"class":43,"line":127},[41,443,333],{"class":231},[41,445,336],{"class":51},[41,447,448,450,452],{"class":43,"line":137},[41,449,341],{"class":231},[41,451,102],{"class":51},[41,453,346],{"class":231},[41,455,456],{"class":43,"line":150},[41,457,190],{"class":51},[41,459,460],{"class":43,"line":163},[41,461,355],{"class":51},[19,463,465],{"id":464},"콜백-타이밍","콜백 타이밍",[467,468,469,483],"ul",{},[470,471,472,473,475,476,478,479,482],"li",{},"작업이 ",[208,474,215],{},", ",[208,477,358],{}," 또는 ",[208,480,481],{},"취소","되었을 때 트리거됩니다",[470,484,485],{},"과금 확인이 완료된 후 전송됩니다",[19,487,489],{"id":488},"콜백-요구-사항","콜백 요구 사항",[491,492,493,506],"table",{},[494,495,496],"thead",{},[497,498,499,503],"tr",{},[500,501,502],"th",{},"요구 사항",[500,504,505],{},"세부 내용",[507,508,509,520,532,544,556,568],"tbody",{},[497,510,511,515],{},[512,513,514],"td",{},"프로토콜",[512,516,517],{},[208,518,519],{},"HTTPS만 지원",[497,521,522,525],{},[512,523,524],{},"타임아웃",[512,526,527,528,531],{},"엔드포인트는 ",[208,529,530],{},"10초"," 이내에 응답해야 합니다",[497,533,534,537],{},[512,535,536],{},"성공 응답",[512,538,539,540,543],{},"수신 확인을 위해 ",[208,541,542],{},"2xx"," 상태 코드를 반환해야 합니다",[497,545,546,549],{},[512,547,548],{},"재시도",[512,550,551,552,555],{},"실패 시 최대 ",[208,553,554],{},"3회 재시도"," (1초, 2초, 4초 후)",[497,557,558,561],{},[512,559,560],{},"URL 길이",[512,562,563,564,567],{},"최대 ",[208,565,566],{},"2048","자",[497,569,570,573],{},[512,571,572],{},"네트워크",[512,574,575,576,475,579,475,582,475,585,588],{},"내부/사설 IP는 사용할 수 없습니다 (",[27,577,578],{},"127.0.0.1",[27,580,581],{},"10.x.x.x",[27,583,584],{},"172.16-31.x.x",[27,586,587],{},"192.168.x.x",")",[19,590,592],{"id":591},"관련-문서","관련 문서",[467,594,595,603],{},[470,596,597,602],{},[598,599,601],"a",{"href":600},"/docs/async-tasks","비동기 작업"," -- 폴링 기반 상태 조회",[470,604,605,609],{},[598,606,608],{"href":607},"/docs/error-codes","오류 코드"," -- 오류 코드 레퍼런스",[611,612,613],"style",{},"html pre.shiki code .snl16, html code.shiki .snl16{--shiki-default:#F97583}html pre.shiki code .s95oV, html code.shiki .s95oV{--shiki-default:#E1E4E8}html pre.shiki code .sU2Wk, html code.shiki .sU2Wk{--shiki-default:#9ECBFF}html pre.shiki code .s9osk, html code.shiki .s9osk{--shiki-default:#FFAB70}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);}html pre.shiki code .sDLfK, html code.shiki .sDLfK{--shiki-default:#79B8FF}",{"title":37,"searchDepth":55,"depth":55,"links":615},[616,617,621,622,623],{"id":21,"depth":55,"text":22},{"id":199,"depth":55,"text":200,"children":618},[619,620],{"id":215,"depth":62,"text":215},{"id":358,"depth":62,"text":358},{"id":464,"depth":55,"text":465},{"id":488,"depth":55,"text":489},{"id":591,"depth":55,"text":592},"Seedance 2.0 API의 실시간 비디오 생성 알림을 위한 webhook 콜백을 설정합니다.","md",{},"/ko/docs/webhooks",{"title":5,"description":624},"ko/docs/webhooks","BpTFtH8IglK3QnklcQIu2WU44nM2HYCoBbza_SAxtDE",1775067575300]