[{"data":1,"prerenderedAt":625},["ShallowReactive",2],{"docs-/zh/docs/webhooks":3},{"id":4,"title":5,"body":6,"description":618,"extension":619,"meta":620,"navigation":57,"path":621,"seo":622,"stem":623,"__hash__":624},"content/zh/docs/webhooks.md","Webhooks - Seedance 2.0 API",{"type":7,"value":8,"toc":608},"minimark",[9,14,18,22,30,196,199,209,213,353,356,459,462,482,485,584,587,604],[10,11,13],"h1",{"id":12},"webhooks回调-url","Webhooks（回调 URL）",[15,16,17],"p",{},"当视频生成任务完成、失败或被取消时，通过 HTTP POST 接收实时通知，无需轮询任务状态接口。",[19,20,21],"h2",{"id":21},"设置回调",[15,23,24,25,29],{},"在生成请求中包含 ",[26,27,28],"code",{},"callback_url","：",[31,32,37],"pre",{"className":33,"code":34,"language":35,"meta":36,"style":36},"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","",[26,38,39,52,59,71,81,93,107,118,124,134,147,160,173,184,190],{"__ignoreMap":36},[40,41,44,48],"span",{"class":42,"line":43},"line",1,[40,45,47],{"class":46},"snl16","import",[40,49,51],{"class":50},"s95oV"," requests\n",[40,53,55],{"class":42,"line":54},2,[40,56,58],{"emptyLinePlaceholder":57},true,"\n",[40,60,62,65,68],{"class":42,"line":61},3,[40,63,64],{"class":50},"response ",[40,66,67],{"class":46},"=",[40,69,70],{"class":50}," requests.post(\n",[40,72,74,78],{"class":42,"line":73},4,[40,75,77],{"class":76},"sU2Wk","    \"https://api.evolink.ai/v1/videos/generations\"",[40,79,80],{"class":50},",\n",[40,82,84,88,90],{"class":42,"line":83},5,[40,85,87],{"class":86},"s9osk","    headers",[40,89,67],{"class":46},[40,91,92],{"class":50},"{\n",[40,94,96,99,102,105],{"class":42,"line":95},6,[40,97,98],{"class":76},"        \"Authorization\"",[40,100,101],{"class":50},": ",[40,103,104],{"class":76},"\"Bearer YOUR_API_KEY\"",[40,106,80],{"class":50},[40,108,110,113,115],{"class":42,"line":109},7,[40,111,112],{"class":76},"        \"Content-Type\"",[40,114,101],{"class":50},[40,116,117],{"class":76},"\"application/json\"\n",[40,119,121],{"class":42,"line":120},8,[40,122,123],{"class":50},"    },\n",[40,125,127,130,132],{"class":42,"line":126},9,[40,128,129],{"class":86},"    json",[40,131,67],{"class":46},[40,133,92],{"class":50},[40,135,137,140,142,145],{"class":42,"line":136},10,[40,138,139],{"class":76},"        \"model\"",[40,141,101],{"class":50},[40,143,144],{"class":76},"\"seedance-2.0\"",[40,146,80],{"class":50},[40,148,150,153,155,158],{"class":42,"line":149},11,[40,151,152],{"class":76},"        \"prompt\"",[40,154,101],{"class":50},[40,156,157],{"class":76},"\"A sunset over the ocean, cinematic wide shot\"",[40,159,80],{"class":50},[40,161,163,166,168,171],{"class":42,"line":162},12,[40,164,165],{"class":76},"        \"quality\"",[40,167,101],{"class":50},[40,169,170],{"class":76},"\"1080p\"",[40,172,80],{"class":50},[40,174,176,179,181],{"class":42,"line":175},13,[40,177,178],{"class":76},"        \"callback_url\"",[40,180,101],{"class":50},[40,182,183],{"class":76},"\"https://yourapp.com/api/video-callback\"\n",[40,185,187],{"class":42,"line":186},14,[40,188,189],{"class":50},"    }\n",[40,191,193],{"class":42,"line":192},15,[40,194,195],{"class":50},")\n",[19,197,198],{"id":198},"回调载荷",[15,200,201,202,204,205,29],{},"当任务完成（或失败）时，系统会向您的 ",[26,203,28],{}," 发送 POST 请求。响应体格式与",[206,207,208],"strong",{},"任务查询 API 的响应完全一致",[210,211,212],"h3",{"id":212},"已完成",[31,214,218],{"className":215,"code":216,"language":217,"meta":36,"style":36},"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",[26,219,220,224,237,249,261,272,284,296,304,309,314,326,334,344,348],{"__ignoreMap":36},[40,221,222],{"class":42,"line":43},[40,223,92],{"class":50},[40,225,226,230,232,235],{"class":42,"line":54},[40,227,229],{"class":228},"sDLfK","    \"id\"",[40,231,101],{"class":50},[40,233,234],{"class":76},"\"task-unified-1756817821-4x3rx6ny\"",[40,236,80],{"class":50},[40,238,239,242,244,247],{"class":42,"line":61},[40,240,241],{"class":228},"    \"object\"",[40,243,101],{"class":50},[40,245,246],{"class":76},"\"video.generation.task\"",[40,248,80],{"class":50},[40,250,251,254,256,259],{"class":42,"line":73},[40,252,253],{"class":228},"    \"created\"",[40,255,101],{"class":50},[40,257,258],{"class":228},"1756817821",[40,260,80],{"class":50},[40,262,263,266,268,270],{"class":42,"line":83},[40,264,265],{"class":228},"    \"model\"",[40,267,101],{"class":50},[40,269,144],{"class":76},[40,271,80],{"class":50},[40,273,274,277,279,282],{"class":42,"line":95},[40,275,276],{"class":228},"    \"status\"",[40,278,101],{"class":50},[40,280,281],{"class":76},"\"completed\"",[40,283,80],{"class":50},[40,285,286,289,291,294],{"class":42,"line":109},[40,287,288],{"class":228},"    \"progress\"",[40,290,101],{"class":50},[40,292,293],{"class":228},"100",[40,295,80],{"class":50},[40,297,298,301],{"class":42,"line":120},[40,299,300],{"class":228},"    \"results\"",[40,302,303],{"class":50},": [\n",[40,305,306],{"class":42,"line":126},[40,307,308],{"class":76},"        \"https://cdn.example.com/videos/task-unified-1756817821-4x3rx6ny.mp4\"\n",[40,310,311],{"class":42,"line":136},[40,312,313],{"class":50},"    ],\n",[40,315,316,319,321,324],{"class":42,"line":149},[40,317,318],{"class":228},"    \"type\"",[40,320,101],{"class":50},[40,322,323],{"class":76},"\"video\"",[40,325,80],{"class":50},[40,327,328,331],{"class":42,"line":162},[40,329,330],{"class":228},"    \"task_info\"",[40,332,333],{"class":50},": {\n",[40,335,336,339,341],{"class":42,"line":175},[40,337,338],{"class":228},"        \"can_cancel\"",[40,340,101],{"class":50},[40,342,343],{"class":228},"false\n",[40,345,346],{"class":42,"line":186},[40,347,189],{"class":50},[40,349,350],{"class":42,"line":192},[40,351,352],{"class":50},"}\n",[210,354,355],{"id":355},"失败",[31,357,359],{"className":215,"code":358,"language":217,"meta":36,"style":36},"{\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",[26,360,361,365,375,385,395,405,416,427,437,443,451,455],{"__ignoreMap":36},[40,362,363],{"class":42,"line":43},[40,364,92],{"class":50},[40,366,367,369,371,373],{"class":42,"line":54},[40,368,229],{"class":228},[40,370,101],{"class":50},[40,372,234],{"class":76},[40,374,80],{"class":50},[40,376,377,379,381,383],{"class":42,"line":61},[40,378,241],{"class":228},[40,380,101],{"class":50},[40,382,246],{"class":76},[40,384,80],{"class":50},[40,386,387,389,391,393],{"class":42,"line":73},[40,388,253],{"class":228},[40,390,101],{"class":50},[40,392,258],{"class":228},[40,394,80],{"class":50},[40,396,397,399,401,403],{"class":42,"line":83},[40,398,265],{"class":228},[40,400,101],{"class":50},[40,402,144],{"class":76},[40,404,80],{"class":50},[40,406,407,409,411,414],{"class":42,"line":95},[40,408,276],{"class":228},[40,410,101],{"class":50},[40,412,413],{"class":76},"\"failed\"",[40,415,80],{"class":50},[40,417,418,420,422,425],{"class":42,"line":109},[40,419,288],{"class":228},[40,421,101],{"class":50},[40,423,424],{"class":228},"0",[40,426,80],{"class":50},[40,428,429,431,433,435],{"class":42,"line":120},[40,430,318],{"class":228},[40,432,101],{"class":50},[40,434,323],{"class":76},[40,436,80],{"class":50},[40,438,439,441],{"class":42,"line":126},[40,440,330],{"class":228},[40,442,333],{"class":50},[40,444,445,447,449],{"class":42,"line":136},[40,446,338],{"class":228},[40,448,101],{"class":50},[40,450,343],{"class":228},[40,452,453],{"class":42,"line":149},[40,454,189],{"class":50},[40,456,457],{"class":42,"line":162},[40,458,352],{"class":50},[19,460,461],{"id":461},"回调时机",[463,464,465,479],"ul",{},[466,467,468,469,471,472,474,475,478],"li",{},"当任务状态变为",[206,470,212],{},"、",[206,473,355],{},"或",[206,476,477],{},"已取消","时触发",[466,480,481],{},"在计费确认完成后发送",[19,483,484],{"id":484},"回调要求",[486,487,488,501],"table",{},[489,490,491],"thead",{},[492,493,494,498],"tr",{},[495,496,497],"th",{},"要求",[495,499,500],{},"详情",[502,503,504,515,527,539,551,563],"tbody",{},[492,505,506,510],{},[507,508,509],"td",{},"协议",[507,511,512],{},[206,513,514],{},"仅限 HTTPS",[492,516,517,520],{},[507,518,519],{},"超时",[507,521,522,523,526],{},"您的接口必须在 ",[206,524,525],{},"10 秒"," 内响应",[492,528,529,532],{},[507,530,531],{},"成功确认",[507,533,534,535,538],{},"返回 ",[206,536,537],{},"2xx"," 状态码以确认收到",[492,540,541,544],{},[507,542,543],{},"重试",[507,545,546,547,550],{},"失败后最多 ",[206,548,549],{},"重试 3 次","（间隔 1 秒、2 秒、4 秒）",[492,552,553,556],{},[507,554,555],{},"URL 长度",[507,557,558,559,562],{},"最多 ",[206,560,561],{},"2048"," 个字符",[492,564,565,568],{},[507,566,567],{},"网络",[507,569,570,571,471,574,471,577,471,580,583],{},"禁止使用内网/私有 IP（",[26,572,573],{},"127.0.0.1",[26,575,576],{},"10.x.x.x",[26,578,579],{},"172.16-31.x.x",[26,581,582],{},"192.168.x.x","）",[19,585,586],{"id":586},"相关文档",[463,588,589,597],{},[466,590,591,596],{},[592,593,595],"a",{"href":594},"/docs/async-tasks","异步任务"," — 基于轮询的状态检查",[466,598,599,603],{},[592,600,602],{"href":601},"/docs/error-codes","错误码"," — 错误码参考",[605,606,607],"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":36,"searchDepth":54,"depth":54,"links":609},[610,611,615,616,617],{"id":21,"depth":54,"text":21},{"id":198,"depth":54,"text":198,"children":612},[613,614],{"id":212,"depth":61,"text":212},{"id":355,"depth":61,"text":355},{"id":461,"depth":54,"text":461},{"id":484,"depth":54,"text":484},{"id":586,"depth":54,"text":586},"配置 webhook 回调，实时接收 Seedance 2.0 API 视频生成通知。","md",{},"/zh/docs/webhooks",{"title":5,"description":618},"zh/docs/webhooks","NQp9FlvAY6M0xZdmol-d9mNzzWMQ8_62-ZRxkt4fOdA",1775067578668]