[{"data":1,"prerenderedAt":626},["ShallowReactive",2],{"docs-/ja/docs/webhooks":3},{"id":4,"title":5,"body":6,"description":619,"extension":620,"meta":621,"navigation":57,"path":622,"seo":623,"stem":624,"__hash__":625},"content/ja/docs/webhooks.md","Webhooks - Seedance 2.0 API",{"type":7,"value":8,"toc":609},"minimark",[9,14,18,22,30,196,199,210,214,354,357,460,463,483,486,585,588,605],[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,209],{},"タスクが完了（または失敗）すると、",[26,203,28],{}," に POST リクエストが送信されます。レスポンスボディのフォーマットは",[206,207,208],"strong",{},"タスク照会 API のレスポンスと同一","です。",[211,212,213],"h3",{"id":213},"完了",[31,215,219],{"className":216,"code":217,"language":218,"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,220,221,225,238,250,262,273,285,297,305,310,315,327,335,345,349],{"__ignoreMap":36},[40,222,223],{"class":42,"line":43},[40,224,92],{"class":50},[40,226,227,231,233,236],{"class":42,"line":54},[40,228,230],{"class":229},"sDLfK","    \"id\"",[40,232,101],{"class":50},[40,234,235],{"class":76},"\"task-unified-1756817821-4x3rx6ny\"",[40,237,80],{"class":50},[40,239,240,243,245,248],{"class":42,"line":61},[40,241,242],{"class":229},"    \"object\"",[40,244,101],{"class":50},[40,246,247],{"class":76},"\"video.generation.task\"",[40,249,80],{"class":50},[40,251,252,255,257,260],{"class":42,"line":73},[40,253,254],{"class":229},"    \"created\"",[40,256,101],{"class":50},[40,258,259],{"class":229},"1756817821",[40,261,80],{"class":50},[40,263,264,267,269,271],{"class":42,"line":83},[40,265,266],{"class":229},"    \"model\"",[40,268,101],{"class":50},[40,270,144],{"class":76},[40,272,80],{"class":50},[40,274,275,278,280,283],{"class":42,"line":95},[40,276,277],{"class":229},"    \"status\"",[40,279,101],{"class":50},[40,281,282],{"class":76},"\"completed\"",[40,284,80],{"class":50},[40,286,287,290,292,295],{"class":42,"line":109},[40,288,289],{"class":229},"    \"progress\"",[40,291,101],{"class":50},[40,293,294],{"class":229},"100",[40,296,80],{"class":50},[40,298,299,302],{"class":42,"line":120},[40,300,301],{"class":229},"    \"results\"",[40,303,304],{"class":50},": [\n",[40,306,307],{"class":42,"line":126},[40,308,309],{"class":76},"        \"https://cdn.example.com/videos/task-unified-1756817821-4x3rx6ny.mp4\"\n",[40,311,312],{"class":42,"line":136},[40,313,314],{"class":50},"    ],\n",[40,316,317,320,322,325],{"class":42,"line":149},[40,318,319],{"class":229},"    \"type\"",[40,321,101],{"class":50},[40,323,324],{"class":76},"\"video\"",[40,326,80],{"class":50},[40,328,329,332],{"class":42,"line":162},[40,330,331],{"class":229},"    \"task_info\"",[40,333,334],{"class":50},": {\n",[40,336,337,340,342],{"class":42,"line":175},[40,338,339],{"class":229},"        \"can_cancel\"",[40,341,101],{"class":50},[40,343,344],{"class":229},"false\n",[40,346,347],{"class":42,"line":186},[40,348,189],{"class":50},[40,350,351],{"class":42,"line":192},[40,352,353],{"class":50},"}\n",[211,355,356],{"id":356},"失敗",[31,358,360],{"className":216,"code":359,"language":218,"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,361,362,366,376,386,396,406,417,428,438,444,452,456],{"__ignoreMap":36},[40,363,364],{"class":42,"line":43},[40,365,92],{"class":50},[40,367,368,370,372,374],{"class":42,"line":54},[40,369,230],{"class":229},[40,371,101],{"class":50},[40,373,235],{"class":76},[40,375,80],{"class":50},[40,377,378,380,382,384],{"class":42,"line":61},[40,379,242],{"class":229},[40,381,101],{"class":50},[40,383,247],{"class":76},[40,385,80],{"class":50},[40,387,388,390,392,394],{"class":42,"line":73},[40,389,254],{"class":229},[40,391,101],{"class":50},[40,393,259],{"class":229},[40,395,80],{"class":50},[40,397,398,400,402,404],{"class":42,"line":83},[40,399,266],{"class":229},[40,401,101],{"class":50},[40,403,144],{"class":76},[40,405,80],{"class":50},[40,407,408,410,412,415],{"class":42,"line":95},[40,409,277],{"class":229},[40,411,101],{"class":50},[40,413,414],{"class":76},"\"failed\"",[40,416,80],{"class":50},[40,418,419,421,423,426],{"class":42,"line":109},[40,420,289],{"class":229},[40,422,101],{"class":50},[40,424,425],{"class":229},"0",[40,427,80],{"class":50},[40,429,430,432,434,436],{"class":42,"line":120},[40,431,319],{"class":229},[40,433,101],{"class":50},[40,435,324],{"class":76},[40,437,80],{"class":50},[40,439,440,442],{"class":42,"line":126},[40,441,331],{"class":229},[40,443,334],{"class":50},[40,445,446,448,450],{"class":42,"line":136},[40,447,339],{"class":229},[40,449,101],{"class":50},[40,451,344],{"class":229},[40,453,454],{"class":42,"line":149},[40,455,189],{"class":50},[40,457,458],{"class":42,"line":162},[40,459,353],{"class":50},[19,461,462],{"id":462},"コールバックのタイミング",[464,465,466,480],"ul",{},[467,468,469,470,472,473,475,476,479],"li",{},"タスクが",[206,471,213],{},"、",[206,474,356],{},"、または",[206,477,478],{},"キャンセル","された時にトリガーされます",[467,481,482],{},"課金確認が完了した後に送信されます",[19,484,485],{"id":485},"コールバックの要件",[487,488,489,502],"table",{},[490,491,492],"thead",{},[493,494,495,499],"tr",{},[496,497,498],"th",{},"要件",[496,500,501],{},"詳細",[503,504,505,516,528,540,552,564],"tbody",{},[493,506,507,511],{},[508,509,510],"td",{},"プロトコル",[508,512,513],{},[206,514,515],{},"HTTPS のみ",[493,517,518,521],{},[508,519,520],{},"タイムアウト",[508,522,523,524,527],{},"エンドポイントは ",[206,525,526],{},"10 秒以内","に応答する必要があります",[493,529,530,533],{},[508,531,532],{},"成功",[508,534,535,536,539],{},"受信確認として ",[206,537,538],{},"2xx"," ステータスコードを返してください",[493,541,542,545],{},[508,543,544],{},"リトライ",[508,546,547,548,551],{},"失敗時に最大 ",[206,549,550],{},"3 回","リトライします（1 秒後、2 秒後、4 秒後）",[493,553,554,557],{},[508,555,556],{},"URL の長さ",[508,558,559,560,563],{},"最大 ",[206,561,562],{},"2048"," 文字",[493,565,566,569],{},[508,567,568],{},"ネットワーク",[508,570,571,572,472,575,472,578,472,581,584],{},"内部/プライベート IP は禁止されています（",[26,573,574],{},"127.0.0.1",[26,576,577],{},"10.x.x.x",[26,579,580],{},"172.16-31.x.x",[26,582,583],{},"192.168.x.x","）",[19,586,587],{"id":587},"関連ドキュメント",[464,589,590,598],{},[467,591,592,597],{},[593,594,596],"a",{"href":595},"/docs/async-tasks","非同期タスク"," — ポーリングベースのステータス確認",[467,599,600,604],{},[593,601,603],{"href":602},"/docs/error-codes","エラーコード"," — エラーコードリファレンス",[606,607,608],"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":610},[611,612,616,617,618],{"id":21,"depth":54,"text":21},{"id":198,"depth":54,"text":198,"children":613},[614,615],{"id":213,"depth":61,"text":213},{"id":356,"depth":61,"text":356},{"id":462,"depth":54,"text":462},{"id":485,"depth":54,"text":485},{"id":587,"depth":54,"text":587},"Seedance 2.0 API でリアルタイムのビデオ生成通知のための webhook コールバックを設定します。","md",{},"/ja/docs/webhooks",{"title":5,"description":619},"ja/docs/webhooks","Z-8Erf2Hqwx5tbxcjODbfFaHMaOFK-v2dkvL2UkVwN8",1775067564669]