[{"data":1,"prerenderedAt":1148},["ShallowReactive",2],{"docs-/docs/getting-started":3},{"id":4,"title":5,"body":6,"description":1141,"extension":1142,"meta":1143,"navigation":233,"path":1144,"seo":1145,"stem":1146,"__hash__":1147},"content/en/docs/getting-started.md","Quick Start - Seedance 2.0 API",{"type":7,"value":8,"toc":1129},"minimark",[9,14,18,47,52,77,81,91,95,122,126,129,179,194,198,205,478,483,673,688,692,695,955,967,979,983,1077,1081,1125],[10,11,13],"h1",{"id":12},"quick-start","Quick Start",[15,16,17],"p",{},"Go from zero to generating an AI video in about 5 minutes.",[19,20,21],"blockquote",{},[15,22,23,27,28,31,32,35,36,40,41,46],{},[24,25,26],"strong",{},"Critical upfront:"," Seedance 2.0 has ",[24,29,30],{},"6 models, not 1",". There is ",[24,33,34],{},"no \"automatic mode detection\""," — you must pick the correct ",[37,38,39],"code",{},"model"," value based on your input type. See the full matrix in ",[42,43,45],"a",{"href":44},"/docs/models-overview","Models Overview",".",[48,49,51],"h2",{"id":50},"prerequisites","Prerequisites",[53,54,55,66,74],"ul",{},[56,57,58,59,65],"li",{},"An EvoLink account (",[42,60,64],{"href":61,"rel":62},"https://evolink.ai",[63],"nofollow","Sign up free",")",[56,67,68,69],{},"An API key from your ",[42,70,73],{"href":71,"rel":72},"https://evolink.ai/dashboard/keys",[63],"API Key Management Page",[56,75,76],{},"Any HTTP client (cURL, Python, Node.js, etc.)",[48,78,80],{"id":79},"base-url","Base URL",[82,83,88],"pre",{"className":84,"code":86,"language":87},[85],"language-text","https://api.evolink.ai\n","text",[37,89,86],{"__ignoreMap":90},"",[48,92,94],{"id":93},"step-1-save-your-api-key","Step 1: Save Your API Key",[82,96,100],{"className":97,"code":98,"language":99,"meta":90,"style":90},"language-bash shiki shiki-themes github-dark","export EVOLINK_API_KEY=\"your-api-key-here\"\n","bash",[37,101,102],{"__ignoreMap":90},[103,104,107,111,115,118],"span",{"class":105,"line":106},"line",1,[103,108,110],{"class":109},"snl16","export",[103,112,114],{"class":113},"s95oV"," EVOLINK_API_KEY",[103,116,117],{"class":109},"=",[103,119,121],{"class":120},"sU2Wk","\"your-api-key-here\"\n",[48,123,125],{"id":124},"step-2-pick-the-right-model","Step 2: Pick the Right Model",[15,127,128],{},"Based on what you have:",[130,131,132,145],"table",{},[133,134,135],"thead",{},[136,137,138,142],"tr",{},[139,140,141],"th",{},"Your input",[139,143,144],{},"Model to use",[146,147,148,159,169],"tbody",{},[136,149,150,154],{},[151,152,153],"td",{},"Text prompt only",[151,155,156],{},[37,157,158],{},"seedance-2.0-text-to-video",[136,160,161,164],{},[151,162,163],{},"1–2 reference images",[151,165,166],{},[37,167,168],{},"seedance-2.0-image-to-video",[136,170,171,174],{},[151,172,173],{},"Images + videos + audio (multimodal)",[151,175,176],{},[37,177,178],{},"seedance-2.0-reference-to-video",[15,180,181,182,185,186,189,190,46],{},"Need faster generation and lower cost? Add the ",[37,183,184],{},"fast-"," prefix to any of the above, e.g. ",[37,187,188],{},"seedance-2.0-fast-text-to-video",". See ",[42,191,193],{"href":192},"/docs/fast-models","Fast Models",[48,195,197],{"id":196},"step-3-make-your-first-request","Step 3: Make Your First Request",[15,199,200,201,204],{},"Here's a ",[24,202,203],{},"text-to-video"," example:",[82,206,210],{"className":207,"code":208,"language":209,"meta":90,"style":90},"language-python shiki shiki-themes github-dark","import os\nimport requests\n\nresponse = requests.post(\n    \"https://api.evolink.ai/v1/videos/generations\",\n    headers={\n        \"Authorization\": f\"Bearer {os.environ['EVOLINK_API_KEY']}\",\n        \"Content-Type\": \"application/json\"\n    },\n    json={\n        \"model\": \"seedance-2.0-text-to-video\",\n        \"prompt\": \"A golden retriever running through a sunlit meadow, cinematic slow motion\",\n        \"duration\": 5,\n        \"quality\": \"720p\",\n        \"aspect_ratio\": \"16:9\"\n    }\n)\n\ntask = response.json()\nprint(f\"Task ID: {task['id']}\")\nprint(f\"Status: {task['status']}\")\n","python",[37,211,212,220,228,235,246,255,267,303,314,320,330,343,356,369,382,393,399,405,410,421,451],{"__ignoreMap":90},[103,213,214,217],{"class":105,"line":106},[103,215,216],{"class":109},"import",[103,218,219],{"class":113}," os\n",[103,221,223,225],{"class":105,"line":222},2,[103,224,216],{"class":109},[103,226,227],{"class":113}," requests\n",[103,229,231],{"class":105,"line":230},3,[103,232,234],{"emptyLinePlaceholder":233},true,"\n",[103,236,238,241,243],{"class":105,"line":237},4,[103,239,240],{"class":113},"response ",[103,242,117],{"class":109},[103,244,245],{"class":113}," requests.post(\n",[103,247,249,252],{"class":105,"line":248},5,[103,250,251],{"class":120},"    \"https://api.evolink.ai/v1/videos/generations\"",[103,253,254],{"class":113},",\n",[103,256,258,262,264],{"class":105,"line":257},6,[103,259,261],{"class":260},"s9osk","    headers",[103,263,117],{"class":109},[103,265,266],{"class":113},"{\n",[103,268,270,273,276,279,282,286,289,292,295,298,301],{"class":105,"line":269},7,[103,271,272],{"class":120},"        \"Authorization\"",[103,274,275],{"class":113},": ",[103,277,278],{"class":109},"f",[103,280,281],{"class":120},"\"Bearer ",[103,283,285],{"class":284},"sDLfK","{",[103,287,288],{"class":113},"os.environ[",[103,290,291],{"class":120},"'EVOLINK_API_KEY'",[103,293,294],{"class":113},"]",[103,296,297],{"class":284},"}",[103,299,300],{"class":120},"\"",[103,302,254],{"class":113},[103,304,306,309,311],{"class":105,"line":305},8,[103,307,308],{"class":120},"        \"Content-Type\"",[103,310,275],{"class":113},[103,312,313],{"class":120},"\"application/json\"\n",[103,315,317],{"class":105,"line":316},9,[103,318,319],{"class":113},"    },\n",[103,321,323,326,328],{"class":105,"line":322},10,[103,324,325],{"class":260},"    json",[103,327,117],{"class":109},[103,329,266],{"class":113},[103,331,333,336,338,341],{"class":105,"line":332},11,[103,334,335],{"class":120},"        \"model\"",[103,337,275],{"class":113},[103,339,340],{"class":120},"\"seedance-2.0-text-to-video\"",[103,342,254],{"class":113},[103,344,346,349,351,354],{"class":105,"line":345},12,[103,347,348],{"class":120},"        \"prompt\"",[103,350,275],{"class":113},[103,352,353],{"class":120},"\"A golden retriever running through a sunlit meadow, cinematic slow motion\"",[103,355,254],{"class":113},[103,357,359,362,364,367],{"class":105,"line":358},13,[103,360,361],{"class":120},"        \"duration\"",[103,363,275],{"class":113},[103,365,366],{"class":284},"5",[103,368,254],{"class":113},[103,370,372,375,377,380],{"class":105,"line":371},14,[103,373,374],{"class":120},"        \"quality\"",[103,376,275],{"class":113},[103,378,379],{"class":120},"\"720p\"",[103,381,254],{"class":113},[103,383,385,388,390],{"class":105,"line":384},15,[103,386,387],{"class":120},"        \"aspect_ratio\"",[103,389,275],{"class":113},[103,391,392],{"class":120},"\"16:9\"\n",[103,394,396],{"class":105,"line":395},16,[103,397,398],{"class":113},"    }\n",[103,400,402],{"class":105,"line":401},17,[103,403,404],{"class":113},")\n",[103,406,408],{"class":105,"line":407},18,[103,409,234],{"emptyLinePlaceholder":233},[103,411,413,416,418],{"class":105,"line":412},19,[103,414,415],{"class":113},"task ",[103,417,117],{"class":109},[103,419,420],{"class":113}," response.json()\n",[103,422,424,427,430,432,435,437,440,443,445,447,449],{"class":105,"line":423},20,[103,425,426],{"class":284},"print",[103,428,429],{"class":113},"(",[103,431,278],{"class":109},[103,433,434],{"class":120},"\"Task ID: ",[103,436,285],{"class":284},[103,438,439],{"class":113},"task[",[103,441,442],{"class":120},"'id'",[103,444,294],{"class":113},[103,446,297],{"class":284},[103,448,300],{"class":120},[103,450,404],{"class":113},[103,452,454,456,458,460,463,465,467,470,472,474,476],{"class":105,"line":453},21,[103,455,426],{"class":284},[103,457,429],{"class":113},[103,459,278],{"class":109},[103,461,462],{"class":120},"\"Status: ",[103,464,285],{"class":284},[103,466,439],{"class":113},[103,468,469],{"class":120},"'status'",[103,471,294],{"class":113},[103,473,297],{"class":284},[103,475,300],{"class":120},[103,477,404],{"class":113},[479,480,482],"h3",{"id":481},"response-http-200","Response (HTTP 200)",[82,484,488],{"className":485,"code":486,"language":487,"meta":90,"style":90},"language-json shiki shiki-themes github-dark","{\n    \"id\": \"task-unified-1774857405-abc123\",\n    \"object\": \"video.generation.task\",\n    \"created\": 1774857405,\n    \"model\": \"seedance-2.0-text-to-video\",\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    \"usage\": {\n        \"billing_rule\": \"per_second\",\n        \"credits_reserved\": 50,\n        \"user_group\": \"default\"\n    }\n}\n","json",[37,489,490,494,506,518,530,541,553,565,577,585,597,609,619,623,630,642,654,664,668],{"__ignoreMap":90},[103,491,492],{"class":105,"line":106},[103,493,266],{"class":113},[103,495,496,499,501,504],{"class":105,"line":222},[103,497,498],{"class":284},"    \"id\"",[103,500,275],{"class":113},[103,502,503],{"class":120},"\"task-unified-1774857405-abc123\"",[103,505,254],{"class":113},[103,507,508,511,513,516],{"class":105,"line":230},[103,509,510],{"class":284},"    \"object\"",[103,512,275],{"class":113},[103,514,515],{"class":120},"\"video.generation.task\"",[103,517,254],{"class":113},[103,519,520,523,525,528],{"class":105,"line":237},[103,521,522],{"class":284},"    \"created\"",[103,524,275],{"class":113},[103,526,527],{"class":284},"1774857405",[103,529,254],{"class":113},[103,531,532,535,537,539],{"class":105,"line":248},[103,533,534],{"class":284},"    \"model\"",[103,536,275],{"class":113},[103,538,340],{"class":120},[103,540,254],{"class":113},[103,542,543,546,548,551],{"class":105,"line":257},[103,544,545],{"class":284},"    \"status\"",[103,547,275],{"class":113},[103,549,550],{"class":120},"\"pending\"",[103,552,254],{"class":113},[103,554,555,558,560,563],{"class":105,"line":269},[103,556,557],{"class":284},"    \"progress\"",[103,559,275],{"class":113},[103,561,562],{"class":284},"0",[103,564,254],{"class":113},[103,566,567,570,572,575],{"class":105,"line":305},[103,568,569],{"class":284},"    \"type\"",[103,571,275],{"class":113},[103,573,574],{"class":120},"\"video\"",[103,576,254],{"class":113},[103,578,579,582],{"class":105,"line":316},[103,580,581],{"class":284},"    \"task_info\"",[103,583,584],{"class":113},": {\n",[103,586,587,590,592,595],{"class":105,"line":322},[103,588,589],{"class":284},"        \"can_cancel\"",[103,591,275],{"class":113},[103,593,594],{"class":284},"true",[103,596,254],{"class":113},[103,598,599,602,604,607],{"class":105,"line":332},[103,600,601],{"class":284},"        \"estimated_time\"",[103,603,275],{"class":113},[103,605,606],{"class":284},"165",[103,608,254],{"class":113},[103,610,611,614,616],{"class":105,"line":345},[103,612,613],{"class":284},"        \"video_duration\"",[103,615,275],{"class":113},[103,617,618],{"class":284},"5\n",[103,620,621],{"class":105,"line":358},[103,622,319],{"class":113},[103,624,625,628],{"class":105,"line":371},[103,626,627],{"class":284},"    \"usage\"",[103,629,584],{"class":113},[103,631,632,635,637,640],{"class":105,"line":384},[103,633,634],{"class":284},"        \"billing_rule\"",[103,636,275],{"class":113},[103,638,639],{"class":120},"\"per_second\"",[103,641,254],{"class":113},[103,643,644,647,649,652],{"class":105,"line":395},[103,645,646],{"class":284},"        \"credits_reserved\"",[103,648,275],{"class":113},[103,650,651],{"class":284},"50",[103,653,254],{"class":113},[103,655,656,659,661],{"class":105,"line":401},[103,657,658],{"class":284},"        \"user_group\"",[103,660,275],{"class":113},[103,662,663],{"class":120},"\"default\"\n",[103,665,666],{"class":105,"line":407},[103,667,398],{"class":113},[103,669,670],{"class":105,"line":412},[103,671,672],{"class":113},"}\n",[15,674,675,676,679,680,683,684,687],{},"Note that ",[37,677,678],{},"billing_rule"," is always ",[37,681,682],{},"per_second"," — longer ",[37,685,686],{},"duration"," values cost more.",[48,689,691],{"id":690},"step-4-poll-for-the-video","Step 4: Poll for the Video",[15,693,694],{},"Every generation request is asynchronous. Use the task ID to poll for the result:",[82,696,698],{"className":207,"code":697,"language":209,"meta":90,"style":90},"import time\n\ntask_id = task[\"id\"]\n\nwhile True:\n    status = requests.get(\n        f\"https://api.evolink.ai/v1/tasks/{task_id}\",\n        headers={\"Authorization\": f\"Bearer {os.environ['EVOLINK_API_KEY']}\"}\n    )\n    result = status.json()\n\n    if result[\"status\"] == \"completed\":\n        print(f\"Video URL: {result['results'][0]}\")\n        break\n    if result[\"status\"] == \"failed\":\n        print(\"Generation failed\")\n        break\n\n    print(f\"Progress: {result['progress']}%\")\n    time.sleep(5)\n",[37,699,700,707,711,727,731,742,752,771,803,808,818,822,844,877,882,899,910,914,918,946],{"__ignoreMap":90},[103,701,702,704],{"class":105,"line":106},[103,703,216],{"class":109},[103,705,706],{"class":113}," time\n",[103,708,709],{"class":105,"line":222},[103,710,234],{"emptyLinePlaceholder":233},[103,712,713,716,718,721,724],{"class":105,"line":230},[103,714,715],{"class":113},"task_id ",[103,717,117],{"class":109},[103,719,720],{"class":113}," task[",[103,722,723],{"class":120},"\"id\"",[103,725,726],{"class":113},"]\n",[103,728,729],{"class":105,"line":237},[103,730,234],{"emptyLinePlaceholder":233},[103,732,733,736,739],{"class":105,"line":248},[103,734,735],{"class":109},"while",[103,737,738],{"class":284}," True",[103,740,741],{"class":113},":\n",[103,743,744,747,749],{"class":105,"line":257},[103,745,746],{"class":113},"    status ",[103,748,117],{"class":109},[103,750,751],{"class":113}," requests.get(\n",[103,753,754,757,760,762,765,767,769],{"class":105,"line":269},[103,755,756],{"class":109},"        f",[103,758,759],{"class":120},"\"https://api.evolink.ai/v1/tasks/",[103,761,285],{"class":284},[103,763,764],{"class":113},"task_id",[103,766,297],{"class":284},[103,768,300],{"class":120},[103,770,254],{"class":113},[103,772,773,776,778,780,783,785,787,789,791,793,795,797,799,801],{"class":105,"line":305},[103,774,775],{"class":260},"        headers",[103,777,117],{"class":109},[103,779,285],{"class":113},[103,781,782],{"class":120},"\"Authorization\"",[103,784,275],{"class":113},[103,786,278],{"class":109},[103,788,281],{"class":120},[103,790,285],{"class":284},[103,792,288],{"class":113},[103,794,291],{"class":120},[103,796,294],{"class":113},[103,798,297],{"class":284},[103,800,300],{"class":120},[103,802,672],{"class":113},[103,804,805],{"class":105,"line":316},[103,806,807],{"class":113},"    )\n",[103,809,810,813,815],{"class":105,"line":322},[103,811,812],{"class":113},"    result ",[103,814,117],{"class":109},[103,816,817],{"class":113}," status.json()\n",[103,819,820],{"class":105,"line":332},[103,821,234],{"emptyLinePlaceholder":233},[103,823,824,827,830,833,836,839,842],{"class":105,"line":345},[103,825,826],{"class":109},"    if",[103,828,829],{"class":113}," result[",[103,831,832],{"class":120},"\"status\"",[103,834,835],{"class":113},"] ",[103,837,838],{"class":109},"==",[103,840,841],{"class":120}," \"completed\"",[103,843,741],{"class":113},[103,845,846,849,851,853,856,858,861,864,867,869,871,873,875],{"class":105,"line":358},[103,847,848],{"class":284},"        print",[103,850,429],{"class":113},[103,852,278],{"class":109},[103,854,855],{"class":120},"\"Video URL: ",[103,857,285],{"class":284},[103,859,860],{"class":113},"result[",[103,862,863],{"class":120},"'results'",[103,865,866],{"class":113},"][",[103,868,562],{"class":284},[103,870,294],{"class":113},[103,872,297],{"class":284},[103,874,300],{"class":120},[103,876,404],{"class":113},[103,878,879],{"class":105,"line":371},[103,880,881],{"class":109},"        break\n",[103,883,884,886,888,890,892,894,897],{"class":105,"line":384},[103,885,826],{"class":109},[103,887,829],{"class":113},[103,889,832],{"class":120},[103,891,835],{"class":113},[103,893,838],{"class":109},[103,895,896],{"class":120}," \"failed\"",[103,898,741],{"class":113},[103,900,901,903,905,908],{"class":105,"line":395},[103,902,848],{"class":284},[103,904,429],{"class":113},[103,906,907],{"class":120},"\"Generation failed\"",[103,909,404],{"class":113},[103,911,912],{"class":105,"line":401},[103,913,881],{"class":109},[103,915,916],{"class":105,"line":407},[103,917,234],{"emptyLinePlaceholder":233},[103,919,920,923,925,927,930,932,934,937,939,941,944],{"class":105,"line":412},[103,921,922],{"class":284},"    print",[103,924,429],{"class":113},[103,926,278],{"class":109},[103,928,929],{"class":120},"\"Progress: ",[103,931,285],{"class":284},[103,933,860],{"class":113},[103,935,936],{"class":120},"'progress'",[103,938,294],{"class":113},[103,940,297],{"class":284},[103,942,943],{"class":120},"%\"",[103,945,404],{"class":113},[103,947,948,951,953],{"class":105,"line":423},[103,949,950],{"class":113},"    time.sleep(",[103,952,366],{"class":284},[103,954,404],{"class":113},[19,956,957],{},[15,958,959,962,963,966],{},[24,960,961],{},"Important:"," Generated video URLs are valid for ",[24,964,965],{},"24 hours",". Download and save them to your own storage promptly.",[15,968,969,970,974,975,978],{},"For production use, prefer ",[42,971,973],{"href":972},"/docs/webhooks","Webhooks"," (",[37,976,977],{},"callback_url",") over polling.",[48,980,982],{"id":981},"common-pitfalls","Common Pitfalls",[130,984,985,998],{},[133,986,987],{},[136,988,989,992,995],{},[139,990,991],{},"Symptom",[139,993,994],{},"Cause",[139,996,997],{},"Fix",[146,999,1000,1022,1040,1062],{},[136,1001,1002,1011,1017],{},[151,1003,1004,1005,1008,1009],{},"400 ",[37,1006,1007],{},"invalid_request"," on ",[37,1010,39],{},[151,1012,1013,1014],{},"You wrote ",[37,1015,1016],{},"\"model\": \"seedance-2.0\"",[151,1018,1019,1020],{},"Use the full model ID, e.g. ",[37,1021,158],{},[136,1023,1024,1030,1035],{},[151,1025,1026,1027],{},"Error when passing ",[37,1028,1029],{},"image_urls",[151,1031,1032,1034],{},[37,1033,203],{}," doesn't accept media inputs",[151,1036,1037,1038],{},"Use ",[37,1039,168],{},[136,1041,1042,1048,1053],{},[151,1043,1044,1047],{},[37,1045,1046],{},"quality: \"1080p\""," rejected",[151,1049,1050],{},[24,1051,1052],{},"1080p is not supported",[151,1054,1037,1055,1058,1059],{},[37,1056,1057],{},"480p"," or ",[37,1060,1061],{},"720p",[136,1063,1064,1067,1070],{},[151,1065,1066],{},"Image > 30 MB or > 6000 px rejected",[151,1068,1069],{},"Exceeds image input limits",[151,1071,1072,1073,65],{},"Compress to the allowed range (see ",[42,1074,1076],{"href":1075},"/docs/image-to-video#image-input-requirements","image-to-video",[48,1078,1080],{"id":1079},"next-steps","Next Steps",[53,1082,1083,1088,1095,1110,1117],{},[56,1084,1085,1087],{},[42,1086,45],{"href":44}," — Full 6-model matrix and decision tree",[56,1089,1090,1094],{},[42,1091,1093],{"href":1092},"/docs/authentication","Authentication"," — Bearer token details",[56,1096,1097,1101,1102,1101,1106],{},[42,1098,1100],{"href":1099},"/docs/text-to-video","Text-to-Video"," / ",[42,1103,1105],{"href":1104},"/docs/image-to-video","Image-to-Video",[42,1107,1109],{"href":1108},"/docs/reference-to-video","Reference-to-Video",[56,1111,1112,1116],{},[42,1113,1115],{"href":1114},"/docs/async-tasks","Async Tasks"," — Polling endpoint details",[56,1118,1119,1121,1122,1124],{},[42,1120,973],{"href":972}," — ",[37,1123,977],{}," real-time notifications",[1126,1127,1128],"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 .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 .s9osk, html code.shiki .s9osk{--shiki-default:#FFAB70}html pre.shiki code .sDLfK, html code.shiki .sDLfK{--shiki-default:#79B8FF}",{"title":90,"searchDepth":222,"depth":222,"links":1130},[1131,1132,1133,1134,1135,1138,1139,1140],{"id":50,"depth":222,"text":51},{"id":79,"depth":222,"text":80},{"id":93,"depth":222,"text":94},{"id":124,"depth":222,"text":125},{"id":196,"depth":222,"text":197,"children":1136},[1137],{"id":481,"depth":230,"text":482},{"id":690,"depth":222,"text":691},{"id":981,"depth":222,"text":982},{"id":1079,"depth":222,"text":1080},"From zero to your first Seedance 2.0 API call in 5 minutes: get an API key, pick the right model ID, submit a task, retrieve the video.","md",{},"/en/docs/getting-started",{"title":5,"description":1141},"en/docs/getting-started","2UwT8FoEiTwAiValsdS-uS69rE9Q9f7UAmn6jOqW9dw",1776086322145]