[{"data":1,"prerenderedAt":848},["ShallowReactive",2],{"docs-/docs/error-codes":3},{"id":4,"title":5,"body":6,"description":841,"extension":842,"meta":843,"navigation":497,"path":844,"seo":845,"stem":846,"__hash__":847},"content/en/docs/error-codes.md","Error Codes - Seedance 2.0 API",{"type":7,"value":8,"toc":832},"minimark",[9,14,18,23,131,135,138,244,248,327,331,473,477,781,785,808,812,828],[10,11,13],"h1",{"id":12},"error-codes","Error Codes",[15,16,17],"p",{},"The API uses standard HTTP status codes and returns detailed error information in a consistent response format.",[19,20,22],"h2",{"id":21},"http-status-codes","HTTP Status Codes",[24,25,26,39],"table",{},[27,28,29],"thead",{},[30,31,32,36],"tr",{},[33,34,35],"th",{},"Code",[33,37,38],{},"Meaning",[40,41,42,51,59,67,75,83,91,99,107,115,123],"tbody",{},[30,43,44,48],{},[45,46,47],"td",{},"200",[45,49,50],{},"Success",[30,52,53,56],{},[45,54,55],{},"400",[45,57,58],{},"Bad Request — invalid parameters",[30,60,61,64],{},[45,62,63],{},"401",[45,65,66],{},"Unauthorized — invalid or expired token",[30,68,69,72],{},[45,70,71],{},"402",[45,73,74],{},"Payment Required — insufficient quota",[30,76,77,80],{},[45,78,79],{},"403",[45,81,82],{},"Forbidden — access denied for this resource",[30,84,85,88],{},[45,86,87],{},"404",[45,89,90],{},"Not Found — resource does not exist",[30,92,93,96],{},[45,94,95],{},"413",[45,97,98],{},"Payload Too Large — request body too large",[30,100,101,104],{},[45,102,103],{},"429",[45,105,106],{},"Too Many Requests — rate limit exceeded",[30,108,109,112],{},[45,110,111],{},"500",[45,113,114],{},"Internal Server Error",[30,116,117,120],{},[45,118,119],{},"502",[45,121,122],{},"Bad Gateway — upstream AI service unavailable",[30,124,125,128],{},[45,126,127],{},"503",[45,129,130],{},"Service Unavailable — temporary overload",[19,132,134],{"id":133},"error-response-format","Error Response Format",[15,136,137],{},"All errors return a consistent JSON structure:",[139,140,145],"pre",{"className":141,"code":142,"language":143,"meta":144,"style":144},"language-json shiki shiki-themes github-dark","{\n    \"error\": {\n        \"code\": 400,\n        \"message\": \"Invalid prompt parameter\",\n        \"type\": \"invalid_request_error\",\n        \"param\": \"prompt\",\n        \"fallback_suggestion\": \"provide a valid prompt\"\n    }\n}\n","json","",[146,147,148,157,167,181,195,208,221,232,238],"code",{"__ignoreMap":144},[149,150,153],"span",{"class":151,"line":152},"line",1,[149,154,156],{"class":155},"s95oV","{\n",[149,158,160,164],{"class":151,"line":159},2,[149,161,163],{"class":162},"sDLfK","    \"error\"",[149,165,166],{"class":155},": {\n",[149,168,170,173,176,178],{"class":151,"line":169},3,[149,171,172],{"class":162},"        \"code\"",[149,174,175],{"class":155},": ",[149,177,55],{"class":162},[149,179,180],{"class":155},",\n",[149,182,184,187,189,193],{"class":151,"line":183},4,[149,185,186],{"class":162},"        \"message\"",[149,188,175],{"class":155},[149,190,192],{"class":191},"sU2Wk","\"Invalid prompt parameter\"",[149,194,180],{"class":155},[149,196,198,201,203,206],{"class":151,"line":197},5,[149,199,200],{"class":162},"        \"type\"",[149,202,175],{"class":155},[149,204,205],{"class":191},"\"invalid_request_error\"",[149,207,180],{"class":155},[149,209,211,214,216,219],{"class":151,"line":210},6,[149,212,213],{"class":162},"        \"param\"",[149,215,175],{"class":155},[149,217,218],{"class":191},"\"prompt\"",[149,220,180],{"class":155},[149,222,224,227,229],{"class":151,"line":223},7,[149,225,226],{"class":162},"        \"fallback_suggestion\"",[149,228,175],{"class":155},[149,230,231],{"class":191},"\"provide a valid prompt\"\n",[149,233,235],{"class":151,"line":234},8,[149,236,237],{"class":155},"    }\n",[149,239,241],{"class":151,"line":240},9,[149,242,243],{"class":155},"}\n",[19,245,247],{"id":246},"error-response-fields","Error Response Fields",[24,249,250,263],{},[27,251,252],{},[30,253,254,257,260],{},[33,255,256],{},"Field",[33,258,259],{},"Type",[33,261,262],{},"Description",[40,264,265,278,291,303,315],{},[30,266,267,272,275],{},[45,268,269],{},[146,270,271],{},"error.code",[45,273,274],{},"integer",[45,276,277],{},"HTTP status error code",[30,279,280,285,288],{},[45,281,282],{},[146,283,284],{},"error.message",[45,286,287],{},"string",[45,289,290],{},"Human-readable error description",[30,292,293,298,300],{},[45,294,295],{},[146,296,297],{},"error.type",[45,299,287],{},[45,301,302],{},"Error type category (see below)",[30,304,305,310,312],{},[45,306,307],{},[146,308,309],{},"error.param",[45,311,287],{},[45,313,314],{},"The related parameter name (when applicable)",[30,316,317,322,324],{},[45,318,319],{},[146,320,321],{},"error.fallback_suggestion",[45,323,287],{},[45,325,326],{},"Suggested action to resolve the error",[19,328,330],{"id":329},"error-types","Error Types",[24,332,333,344],{},[27,334,335],{},[30,336,337,339,342],{},[33,338,259],{},[33,340,341],{},"HTTP Code",[33,343,262],{},[40,345,346,358,370,389,401,413,425,437,449,461],{},[30,347,348,353,355],{},[45,349,350],{},[146,351,352],{},"invalid_request_error",[45,354,55],{},[45,356,357],{},"Request parameter is invalid or missing",[30,359,360,365,367],{},[45,361,362],{},[146,363,364],{},"authentication_error",[45,366,63],{},[45,368,369],{},"Invalid or expired API token",[30,371,372,377,379],{},[45,373,374],{},[146,375,376],{},"insufficient_quota_error",[45,378,71],{},[45,380,381,382],{},"Account has insufficient credits. ",[383,384,388],"a",{"href":385,"rel":386},"https://evolink.ai/dashboard/billing",[387],"nofollow","Top up here",[30,390,391,396,398],{},[45,392,393],{},[146,394,395],{},"permission_error",[45,397,79],{},[45,399,400],{},"No permission to access this model or resource",[30,402,403,408,410],{},[45,404,405],{},[146,406,407],{},"not_found_error",[45,409,87],{},[45,411,412],{},"Requested resource (model, task) not found",[30,414,415,420,422],{},[45,416,417],{},[146,418,419],{},"request_too_large_error",[45,421,95],{},[45,423,424],{},"Request body exceeds size limits",[30,426,427,432,434],{},[45,428,429],{},[146,430,431],{},"rate_limit_error",[45,433,103],{},[45,435,436],{},"Too many requests — retry after the suggested interval",[30,438,439,444,446],{},[45,440,441],{},[146,442,443],{},"internal_server_error",[45,445,111],{},[45,447,448],{},"Internal server error — try again later",[30,450,451,456,458],{},[45,452,453],{},[146,454,455],{},"upstream_error",[45,457,119],{},[45,459,460],{},"Upstream AI service unavailable — try a different model",[30,462,463,468,470],{},[45,464,465],{},[146,466,467],{},"service_unavailable_error",[45,469,127],{},[45,471,472],{},"Service temporarily unavailable — retry after 30 seconds",[19,474,476],{"id":475},"handling-errors","Handling Errors",[139,478,482],{"className":479,"code":480,"language":481,"meta":144,"style":144},"language-python shiki shiki-themes github-dark","import requests\n\nresponse = requests.post(\n    \"https://api.evolink.ai/v1/videos/generations\",\n    headers=headers,\n    json=payload\n)\n\nif response.status_code == 200:\n    task = response.json()\n    print(f\"Task created: {task['id']}\")\nelif response.status_code == 429:\n    # Rate limited — back off and retry\n    print(\"Rate limited. Retrying...\")\nelif response.status_code == 402:\n    print(\"Insufficient credits. Please top up at https://evolink.ai/dashboard/billing\")\nelse:\n    error = response.json().get(\"error\", {})\n    print(f\"Error [{error.get('type')}]: {error.get('message')}\")\n    if error.get(\"fallback_suggestion\"):\n        print(f\"Suggestion: {error.get('fallback_suggestion')}\")\n","python",[146,483,484,493,499,510,517,528,538,543,547,564,575,610,625,632,644,658,670,678,695,738,753],{"__ignoreMap":144},[149,485,486,490],{"class":151,"line":152},[149,487,489],{"class":488},"snl16","import",[149,491,492],{"class":155}," requests\n",[149,494,495],{"class":151,"line":159},[149,496,498],{"emptyLinePlaceholder":497},true,"\n",[149,500,501,504,507],{"class":151,"line":169},[149,502,503],{"class":155},"response ",[149,505,506],{"class":488},"=",[149,508,509],{"class":155}," requests.post(\n",[149,511,512,515],{"class":151,"line":183},[149,513,514],{"class":191},"    \"https://api.evolink.ai/v1/videos/generations\"",[149,516,180],{"class":155},[149,518,519,523,525],{"class":151,"line":197},[149,520,522],{"class":521},"s9osk","    headers",[149,524,506],{"class":488},[149,526,527],{"class":155},"headers,\n",[149,529,530,533,535],{"class":151,"line":210},[149,531,532],{"class":521},"    json",[149,534,506],{"class":488},[149,536,537],{"class":155},"payload\n",[149,539,540],{"class":151,"line":223},[149,541,542],{"class":155},")\n",[149,544,545],{"class":151,"line":234},[149,546,498],{"emptyLinePlaceholder":497},[149,548,549,552,555,558,561],{"class":151,"line":240},[149,550,551],{"class":488},"if",[149,553,554],{"class":155}," response.status_code ",[149,556,557],{"class":488},"==",[149,559,560],{"class":162}," 200",[149,562,563],{"class":155},":\n",[149,565,567,570,572],{"class":151,"line":566},10,[149,568,569],{"class":155},"    task ",[149,571,506],{"class":488},[149,573,574],{"class":155}," response.json()\n",[149,576,578,581,584,587,590,593,596,599,602,605,608],{"class":151,"line":577},11,[149,579,580],{"class":162},"    print",[149,582,583],{"class":155},"(",[149,585,586],{"class":488},"f",[149,588,589],{"class":191},"\"Task created: ",[149,591,592],{"class":162},"{",[149,594,595],{"class":155},"task[",[149,597,598],{"class":191},"'id'",[149,600,601],{"class":155},"]",[149,603,604],{"class":162},"}",[149,606,607],{"class":191},"\"",[149,609,542],{"class":155},[149,611,613,616,618,620,623],{"class":151,"line":612},12,[149,614,615],{"class":488},"elif",[149,617,554],{"class":155},[149,619,557],{"class":488},[149,621,622],{"class":162}," 429",[149,624,563],{"class":155},[149,626,628],{"class":151,"line":627},13,[149,629,631],{"class":630},"sAwPA","    # Rate limited — back off and retry\n",[149,633,635,637,639,642],{"class":151,"line":634},14,[149,636,580],{"class":162},[149,638,583],{"class":155},[149,640,641],{"class":191},"\"Rate limited. Retrying...\"",[149,643,542],{"class":155},[149,645,647,649,651,653,656],{"class":151,"line":646},15,[149,648,615],{"class":488},[149,650,554],{"class":155},[149,652,557],{"class":488},[149,654,655],{"class":162}," 402",[149,657,563],{"class":155},[149,659,661,663,665,668],{"class":151,"line":660},16,[149,662,580],{"class":162},[149,664,583],{"class":155},[149,666,667],{"class":191},"\"Insufficient credits. Please top up at https://evolink.ai/dashboard/billing\"",[149,669,542],{"class":155},[149,671,673,676],{"class":151,"line":672},17,[149,674,675],{"class":488},"else",[149,677,563],{"class":155},[149,679,681,684,686,689,692],{"class":151,"line":680},18,[149,682,683],{"class":155},"    error ",[149,685,506],{"class":488},[149,687,688],{"class":155}," response.json().get(",[149,690,691],{"class":191},"\"error\"",[149,693,694],{"class":155},", {})\n",[149,696,698,700,702,704,707,709,712,715,718,720,723,725,727,730,732,734,736],{"class":151,"line":697},19,[149,699,580],{"class":162},[149,701,583],{"class":155},[149,703,586],{"class":488},[149,705,706],{"class":191},"\"Error [",[149,708,592],{"class":162},[149,710,711],{"class":155},"error.get(",[149,713,714],{"class":191},"'type'",[149,716,717],{"class":155},")",[149,719,604],{"class":162},[149,721,722],{"class":191},"]: ",[149,724,592],{"class":162},[149,726,711],{"class":155},[149,728,729],{"class":191},"'message'",[149,731,717],{"class":155},[149,733,604],{"class":162},[149,735,607],{"class":191},[149,737,542],{"class":155},[149,739,741,744,747,750],{"class":151,"line":740},20,[149,742,743],{"class":488},"    if",[149,745,746],{"class":155}," error.get(",[149,748,749],{"class":191},"\"fallback_suggestion\"",[149,751,752],{"class":155},"):\n",[149,754,756,759,761,763,766,768,770,773,775,777,779],{"class":151,"line":755},21,[149,757,758],{"class":162},"        print",[149,760,583],{"class":155},[149,762,586],{"class":488},[149,764,765],{"class":191},"\"Suggestion: ",[149,767,592],{"class":162},[149,769,711],{"class":155},[149,771,772],{"class":191},"'fallback_suggestion'",[149,774,717],{"class":155},[149,776,604],{"class":162},[149,778,607],{"class":191},[149,780,542],{"class":155},[19,782,784],{"id":783},"failed-generations","Failed Generations",[786,787,788,797,805],"ul",{},[789,790,791,792,796],"li",{},"Failed video generations are ",[793,794,795],"strong",{},"not charged"," to your account",[789,798,799,800,804],{},"Check the task status via ",[383,801,803],{"href":802},"/docs/async-tasks","Async Tasks"," for failure details",[789,806,807],{},"Most errors can be resolved by adjusting parameters and retrying",[19,809,811],{"id":810},"related","Related",[786,813,814,821],{},[789,815,816,820],{},[383,817,819],{"href":818},"/docs/rate-limits","Rate Limits"," — Understand rate limiting",[789,822,823,827],{},[383,824,826],{"href":825},"/docs/authentication","Authentication"," — Fix auth issues",[829,830,831],"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 pre.shiki code .sDLfK, html code.shiki .sDLfK{--shiki-default:#79B8FF}html pre.shiki code .sAwPA, html code.shiki .sAwPA{--shiki-default:#6A737D}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":144,"searchDepth":159,"depth":159,"links":833},[834,835,836,837,838,839,840],{"id":21,"depth":159,"text":22},{"id":133,"depth":159,"text":134},{"id":246,"depth":159,"text":247},{"id":329,"depth":159,"text":330},{"id":475,"depth":159,"text":476},{"id":783,"depth":159,"text":784},{"id":810,"depth":159,"text":811},"Complete error code reference for Seedance 2.0 API. Handle errors and edge cases effectively.","md",{},"/en/docs/error-codes",{"title":5,"description":841},"en/docs/error-codes","L9cm1mlE3_bgk5FJSz7CgWBoUG4RFsKJ_26YneG-xWs",1775067575523]