[{"data":1,"prerenderedAt":847},["ShallowReactive",2],{"docs-/ko/docs/error-codes":3},{"id":4,"title":5,"body":6,"description":840,"extension":841,"meta":842,"navigation":498,"path":843,"seo":844,"stem":845,"__hash__":846},"content/ko/docs/error-codes.md","오류 코드 - Seedance 2.0 API",{"type":7,"value":8,"toc":831},"minimark",[9,14,18,23,131,135,138,244,248,327,331,474,478,782,786,807,811,827],[10,11,13],"h1",{"id":12},"오류-코드","오류 코드",[15,16,17],"p",{},"API는 표준 HTTP 상태 코드를 사용하며 일관된 응답 형식으로 상세한 오류 정보를 반환합니다.",[19,20,22],"h2",{"id":21},"http-상태-코드","HTTP 상태 코드",[24,25,26,39],"table",{},[27,28,29],"thead",{},[30,31,32,36],"tr",{},[33,34,35],"th",{},"코드",[33,37,38],{},"의미",[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],{},"성공",[30,52,53,56],{},[45,54,55],{},"400",[45,57,58],{},"잘못된 요청 -- 유효하지 않은 파라미터",[30,60,61,64],{},[45,62,63],{},"401",[45,65,66],{},"인증 실패 -- 유효하지 않거나 만료된 토큰",[30,68,69,72],{},[45,70,71],{},"402",[45,73,74],{},"결제 필요 -- 잔액 부족",[30,76,77,80],{},[45,78,79],{},"403",[45,81,82],{},"접근 금지 -- 해당 리소스에 대한 접근이 거부됨",[30,84,85,88],{},[45,86,87],{},"404",[45,89,90],{},"찾을 수 없음 -- 리소스가 존재하지 않음",[30,92,93,96],{},[45,94,95],{},"413",[45,97,98],{},"페이로드 초과 -- 요청 본문이 너무 큼",[30,100,101,104],{},[45,102,103],{},"429",[45,105,106],{},"요청 과다 -- 속도 제한 초과",[30,108,109,112],{},[45,110,111],{},"500",[45,113,114],{},"내부 서버 오류",[30,116,117,120],{},[45,118,119],{},"502",[45,121,122],{},"잘못된 게이트웨이 -- 업스트림 AI 서비스를 사용할 수 없음",[30,124,125,128],{},[45,126,127],{},"503",[45,129,130],{},"서비스 사용 불가 -- 일시적 과부하",[19,132,134],{"id":133},"오류-응답-형식","오류 응답 형식",[15,136,137],{},"모든 오류는 일관된 JSON 구조로 반환됩니다:",[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},"오류-응답-필드","오류 응답 필드",[24,249,250,263],{},[27,251,252],{},[30,253,254,257,260],{},[33,255,256],{},"필드",[33,258,259],{},"타입",[33,261,262],{},"설명",[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 상태 오류 코드",[30,279,280,285,288],{},[45,281,282],{},[146,283,284],{},"error.message",[45,286,287],{},"string",[45,289,290],{},"사람이 읽을 수 있는 오류 설명",[30,292,293,298,300],{},[45,294,295],{},[146,296,297],{},"error.type",[45,299,287],{},[45,301,302],{},"오류 유형 카테고리 (아래 참조)",[30,304,305,310,312],{},[45,306,307],{},[146,308,309],{},"error.param",[45,311,287],{},[45,313,314],{},"관련 파라미터 이름 (해당되는 경우)",[30,316,317,322,324],{},[45,318,319],{},[146,320,321],{},"error.fallback_suggestion",[45,323,287],{},[45,325,326],{},"오류 해결을 위한 권장 조치",[19,328,330],{"id":329},"오류-유형","오류 유형",[24,332,333,345],{},[27,334,335],{},[30,336,337,340,343],{},[33,338,339],{},"유형",[33,341,342],{},"HTTP 코드",[33,344,262],{},[40,346,347,359,371,390,402,414,426,438,450,462],{},[30,348,349,354,356],{},[45,350,351],{},[146,352,353],{},"invalid_request_error",[45,355,55],{},[45,357,358],{},"요청 파라미터가 유효하지 않거나 누락됨",[30,360,361,366,368],{},[45,362,363],{},[146,364,365],{},"authentication_error",[45,367,63],{},[45,369,370],{},"유효하지 않거나 만료된 API 토큰",[30,372,373,378,380],{},[45,374,375],{},[146,376,377],{},"insufficient_quota_error",[45,379,71],{},[45,381,382,383],{},"계정의 크레딧이 부족합니다. ",[384,385,389],"a",{"href":386,"rel":387},"https://evolink.ai/dashboard/billing",[388],"nofollow","여기에서 충전하세요",[30,391,392,397,399],{},[45,393,394],{},[146,395,396],{},"permission_error",[45,398,79],{},[45,400,401],{},"해당 모델 또는 리소스에 대한 접근 권한이 없음",[30,403,404,409,411],{},[45,405,406],{},[146,407,408],{},"not_found_error",[45,410,87],{},[45,412,413],{},"요청한 리소스(모델, 작업)를 찾을 수 없음",[30,415,416,421,423],{},[45,417,418],{},[146,419,420],{},"request_too_large_error",[45,422,95],{},[45,424,425],{},"요청 본문이 크기 제한을 초과함",[30,427,428,433,435],{},[45,429,430],{},[146,431,432],{},"rate_limit_error",[45,434,103],{},[45,436,437],{},"요청이 너무 많음 -- 권장 간격 후 재시도하세요",[30,439,440,445,447],{},[45,441,442],{},[146,443,444],{},"internal_server_error",[45,446,111],{},[45,448,449],{},"내부 서버 오류 -- 나중에 다시 시도하세요",[30,451,452,457,459],{},[45,453,454],{},[146,455,456],{},"upstream_error",[45,458,119],{},[45,460,461],{},"업스트림 AI 서비스를 사용할 수 없음 -- 다른 모델을 시도하세요",[30,463,464,469,471],{},[45,465,466],{},[146,467,468],{},"service_unavailable_error",[45,470,127],{},[45,472,473],{},"서비스 일시적으로 사용 불가 -- 30초 후 재시도하세요",[19,475,477],{"id":476},"오류-처리","오류 처리",[139,479,483],{"className":480,"code":481,"language":482,"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,484,485,494,500,511,518,529,539,544,548,565,576,611,626,633,645,659,671,679,696,739,754],{"__ignoreMap":144},[149,486,487,491],{"class":151,"line":152},[149,488,490],{"class":489},"snl16","import",[149,492,493],{"class":155}," requests\n",[149,495,496],{"class":151,"line":159},[149,497,499],{"emptyLinePlaceholder":498},true,"\n",[149,501,502,505,508],{"class":151,"line":169},[149,503,504],{"class":155},"response ",[149,506,507],{"class":489},"=",[149,509,510],{"class":155}," requests.post(\n",[149,512,513,516],{"class":151,"line":183},[149,514,515],{"class":191},"    \"https://api.evolink.ai/v1/videos/generations\"",[149,517,180],{"class":155},[149,519,520,524,526],{"class":151,"line":197},[149,521,523],{"class":522},"s9osk","    headers",[149,525,507],{"class":489},[149,527,528],{"class":155},"headers,\n",[149,530,531,534,536],{"class":151,"line":210},[149,532,533],{"class":522},"    json",[149,535,507],{"class":489},[149,537,538],{"class":155},"payload\n",[149,540,541],{"class":151,"line":223},[149,542,543],{"class":155},")\n",[149,545,546],{"class":151,"line":234},[149,547,499],{"emptyLinePlaceholder":498},[149,549,550,553,556,559,562],{"class":151,"line":240},[149,551,552],{"class":489},"if",[149,554,555],{"class":155}," response.status_code ",[149,557,558],{"class":489},"==",[149,560,561],{"class":162}," 200",[149,563,564],{"class":155},":\n",[149,566,568,571,573],{"class":151,"line":567},10,[149,569,570],{"class":155},"    task ",[149,572,507],{"class":489},[149,574,575],{"class":155}," response.json()\n",[149,577,579,582,585,588,591,594,597,600,603,606,609],{"class":151,"line":578},11,[149,580,581],{"class":162},"    print",[149,583,584],{"class":155},"(",[149,586,587],{"class":489},"f",[149,589,590],{"class":191},"\"Task created: ",[149,592,593],{"class":162},"{",[149,595,596],{"class":155},"task[",[149,598,599],{"class":191},"'id'",[149,601,602],{"class":155},"]",[149,604,605],{"class":162},"}",[149,607,608],{"class":191},"\"",[149,610,543],{"class":155},[149,612,614,617,619,621,624],{"class":151,"line":613},12,[149,615,616],{"class":489},"elif",[149,618,555],{"class":155},[149,620,558],{"class":489},[149,622,623],{"class":162}," 429",[149,625,564],{"class":155},[149,627,629],{"class":151,"line":628},13,[149,630,632],{"class":631},"sAwPA","    # Rate limited — back off and retry\n",[149,634,636,638,640,643],{"class":151,"line":635},14,[149,637,581],{"class":162},[149,639,584],{"class":155},[149,641,642],{"class":191},"\"Rate limited. Retrying...\"",[149,644,543],{"class":155},[149,646,648,650,652,654,657],{"class":151,"line":647},15,[149,649,616],{"class":489},[149,651,555],{"class":155},[149,653,558],{"class":489},[149,655,656],{"class":162}," 402",[149,658,564],{"class":155},[149,660,662,664,666,669],{"class":151,"line":661},16,[149,663,581],{"class":162},[149,665,584],{"class":155},[149,667,668],{"class":191},"\"Insufficient credits. Please top up at https://evolink.ai/dashboard/billing\"",[149,670,543],{"class":155},[149,672,674,677],{"class":151,"line":673},17,[149,675,676],{"class":489},"else",[149,678,564],{"class":155},[149,680,682,685,687,690,693],{"class":151,"line":681},18,[149,683,684],{"class":155},"    error ",[149,686,507],{"class":489},[149,688,689],{"class":155}," response.json().get(",[149,691,692],{"class":191},"\"error\"",[149,694,695],{"class":155},", {})\n",[149,697,699,701,703,705,708,710,713,716,719,721,724,726,728,731,733,735,737],{"class":151,"line":698},19,[149,700,581],{"class":162},[149,702,584],{"class":155},[149,704,587],{"class":489},[149,706,707],{"class":191},"\"Error [",[149,709,593],{"class":162},[149,711,712],{"class":155},"error.get(",[149,714,715],{"class":191},"'type'",[149,717,718],{"class":155},")",[149,720,605],{"class":162},[149,722,723],{"class":191},"]: ",[149,725,593],{"class":162},[149,727,712],{"class":155},[149,729,730],{"class":191},"'message'",[149,732,718],{"class":155},[149,734,605],{"class":162},[149,736,608],{"class":191},[149,738,543],{"class":155},[149,740,742,745,748,751],{"class":151,"line":741},20,[149,743,744],{"class":489},"    if",[149,746,747],{"class":155}," error.get(",[149,749,750],{"class":191},"\"fallback_suggestion\"",[149,752,753],{"class":155},"):\n",[149,755,757,760,762,764,767,769,771,774,776,778,780],{"class":151,"line":756},21,[149,758,759],{"class":162},"        print",[149,761,584],{"class":155},[149,763,587],{"class":489},[149,765,766],{"class":191},"\"Suggestion: ",[149,768,593],{"class":162},[149,770,712],{"class":155},[149,772,773],{"class":191},"'fallback_suggestion'",[149,775,718],{"class":155},[149,777,605],{"class":162},[149,779,608],{"class":191},[149,781,543],{"class":155},[19,783,785],{"id":784},"실패한-생성","실패한 생성",[787,788,789,797,804],"ul",{},[790,791,792,793],"li",{},"실패한 비디오 생성은 계정에 ",[794,795,796],"strong",{},"과금되지 않습니다",[790,798,799,803],{},[384,800,802],{"href":801},"/docs/async-tasks","비동기 작업","을 통해 작업 상태에서 실패 세부 정보를 확인하세요",[790,805,806],{},"대부분의 오류는 파라미터를 조정하고 재시도하면 해결할 수 있습니다",[19,808,810],{"id":809},"관련-문서","관련 문서",[787,812,813,820],{},[790,814,815,819],{},[384,816,818],{"href":817},"/docs/rate-limits","속도 제한"," -- 속도 제한 이해하기",[790,821,822,826],{},[384,823,825],{"href":824},"/docs/authentication","인증"," -- 인증 문제 해결",[828,829,830],"style",{},"html pre.shiki code .s95oV, html code.shiki .s95oV{--shiki-default:#E1E4E8}html pre.shiki code .sDLfK, html code.shiki .sDLfK{--shiki-default:#79B8FF}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 .snl16, html code.shiki .snl16{--shiki-default:#F97583}html pre.shiki code .s9osk, html code.shiki .s9osk{--shiki-default:#FFAB70}html pre.shiki code .sAwPA, html code.shiki .sAwPA{--shiki-default:#6A737D}",{"title":144,"searchDepth":159,"depth":159,"links":832},[833,834,835,836,837,838,839],{"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":476,"depth":159,"text":477},{"id":784,"depth":159,"text":785},{"id":809,"depth":159,"text":810},"Seedance 2.0 API 전체 오류 코드 레퍼런스. 오류와 엣지 케이스를 효과적으로 처리합니다.","md",{},"/ko/docs/error-codes",{"title":5,"description":840},"ko/docs/error-codes","bsoj9o7j7AjJupMT8sgTZpVc5OUjX4Aj9ajlhtmXoUA",1775067575222]