[{"data":1,"prerenderedAt":840},["ShallowReactive",2],{"docs-/zh/docs/error-codes":3},{"id":4,"title":5,"body":6,"description":833,"extension":834,"meta":835,"navigation":491,"path":836,"seo":837,"stem":838,"__hash__":839},"content/zh/docs/error-codes.md","错误码 - Seedance 2.0 API",{"type":7,"value":8,"toc":824},"minimark",[9,13,17,22,130,133,136,242,245,324,327,468,471,775,778,801,804,820],[10,11,12],"h1",{"id":12},"错误码",[14,15,16],"p",{},"API 使用标准 HTTP 状态码，并以统一的响应格式返回详细的错误信息。",[18,19,21],"h2",{"id":20},"http-状态码","HTTP 状态码",[23,24,25,38],"table",{},[26,27,28],"thead",{},[29,30,31,35],"tr",{},[32,33,34],"th",{},"状态码",[32,36,37],{},"含义",[39,40,41,50,58,66,74,82,90,98,106,114,122],"tbody",{},[29,42,43,47],{},[44,45,46],"td",{},"200",[44,48,49],{},"成功",[29,51,52,55],{},[44,53,54],{},"400",[44,56,57],{},"请求错误 — 参数无效",[29,59,60,63],{},[44,61,62],{},"401",[44,64,65],{},"未授权 — 令牌无效或已过期",[29,67,68,71],{},[44,69,70],{},"402",[44,72,73],{},"需要付款 — 配额不足",[29,75,76,79],{},[44,77,78],{},"403",[44,80,81],{},"禁止访问 — 无权访问该资源",[29,83,84,87],{},[44,85,86],{},"404",[44,88,89],{},"未找到 — 资源不存在",[29,91,92,95],{},[44,93,94],{},"413",[44,96,97],{},"请求体过大 — 请求体超出大小限制",[29,99,100,103],{},[44,101,102],{},"429",[44,104,105],{},"请求过多 — 超出速率限制",[29,107,108,111],{},[44,109,110],{},"500",[44,112,113],{},"服务器内部错误",[29,115,116,119],{},[44,117,118],{},"502",[44,120,121],{},"网关错误 — 上游 AI 服务不可用",[29,123,124,127],{},[44,125,126],{},"503",[44,128,129],{},"服务不可用 — 暂时过载",[18,131,132],{"id":132},"错误响应格式",[14,134,135],{},"所有错误返回统一的 JSON 结构：",[137,138,143],"pre",{"className":139,"code":140,"language":141,"meta":142,"style":142},"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","",[144,145,146,155,165,179,193,206,219,230,236],"code",{"__ignoreMap":142},[147,148,151],"span",{"class":149,"line":150},"line",1,[147,152,154],{"class":153},"s95oV","{\n",[147,156,158,162],{"class":149,"line":157},2,[147,159,161],{"class":160},"sDLfK","    \"error\"",[147,163,164],{"class":153},": {\n",[147,166,168,171,174,176],{"class":149,"line":167},3,[147,169,170],{"class":160},"        \"code\"",[147,172,173],{"class":153},": ",[147,175,54],{"class":160},[147,177,178],{"class":153},",\n",[147,180,182,185,187,191],{"class":149,"line":181},4,[147,183,184],{"class":160},"        \"message\"",[147,186,173],{"class":153},[147,188,190],{"class":189},"sU2Wk","\"Invalid prompt parameter\"",[147,192,178],{"class":153},[147,194,196,199,201,204],{"class":149,"line":195},5,[147,197,198],{"class":160},"        \"type\"",[147,200,173],{"class":153},[147,202,203],{"class":189},"\"invalid_request_error\"",[147,205,178],{"class":153},[147,207,209,212,214,217],{"class":149,"line":208},6,[147,210,211],{"class":160},"        \"param\"",[147,213,173],{"class":153},[147,215,216],{"class":189},"\"prompt\"",[147,218,178],{"class":153},[147,220,222,225,227],{"class":149,"line":221},7,[147,223,224],{"class":160},"        \"fallback_suggestion\"",[147,226,173],{"class":153},[147,228,229],{"class":189},"\"provide a valid prompt\"\n",[147,231,233],{"class":149,"line":232},8,[147,234,235],{"class":153},"    }\n",[147,237,239],{"class":149,"line":238},9,[147,240,241],{"class":153},"}\n",[18,243,244],{"id":244},"错误响应字段",[23,246,247,260],{},[26,248,249],{},[29,250,251,254,257],{},[32,252,253],{},"字段",[32,255,256],{},"类型",[32,258,259],{},"描述",[39,261,262,275,288,300,312],{},[29,263,264,269,272],{},[44,265,266],{},[144,267,268],{},"error.code",[44,270,271],{},"integer",[44,273,274],{},"HTTP 错误状态码",[29,276,277,282,285],{},[44,278,279],{},[144,280,281],{},"error.message",[44,283,284],{},"string",[44,286,287],{},"可读的错误描述",[29,289,290,295,297],{},[44,291,292],{},[144,293,294],{},"error.type",[44,296,284],{},[44,298,299],{},"错误类型分类（见下表）",[29,301,302,307,309],{},[44,303,304],{},[144,305,306],{},"error.param",[44,308,284],{},[44,310,311],{},"相关的参数名称（如适用）",[29,313,314,319,321],{},[44,315,316],{},[144,317,318],{},"error.fallback_suggestion",[44,320,284],{},[44,322,323],{},"建议的解决操作",[18,325,326],{"id":326},"错误类型",[23,328,329,339],{},[26,330,331],{},[29,332,333,335,337],{},[32,334,256],{},[32,336,21],{},[32,338,259],{},[39,340,341,353,365,384,396,408,420,432,444,456],{},[29,342,343,348,350],{},[44,344,345],{},[144,346,347],{},"invalid_request_error",[44,349,54],{},[44,351,352],{},"请求参数无效或缺失",[29,354,355,360,362],{},[44,356,357],{},[144,358,359],{},"authentication_error",[44,361,62],{},[44,363,364],{},"API 令牌无效或已过期",[29,366,367,372,374],{},[44,368,369],{},[144,370,371],{},"insufficient_quota_error",[44,373,70],{},[44,375,376,377],{},"账户积分不足。",[378,379,383],"a",{"href":380,"rel":381},"https://evolink.ai/dashboard/billing",[382],"nofollow","前往充值",[29,385,386,391,393],{},[44,387,388],{},[144,389,390],{},"permission_error",[44,392,78],{},[44,394,395],{},"无权访问该模型或资源",[29,397,398,403,405],{},[44,399,400],{},[144,401,402],{},"not_found_error",[44,404,86],{},[44,406,407],{},"请求的资源（模型、任务）未找到",[29,409,410,415,417],{},[44,411,412],{},[144,413,414],{},"request_too_large_error",[44,416,94],{},[44,418,419],{},"请求体超出大小限制",[29,421,422,427,429],{},[44,423,424],{},[144,425,426],{},"rate_limit_error",[44,428,102],{},[44,430,431],{},"请求过多 — 在建议的时间间隔后重试",[29,433,434,439,441],{},[44,435,436],{},[144,437,438],{},"internal_server_error",[44,440,110],{},[44,442,443],{},"服务器内部错误 — 请稍后重试",[29,445,446,451,453],{},[44,447,448],{},[144,449,450],{},"upstream_error",[44,452,118],{},[44,454,455],{},"上游 AI 服务不可用 — 尝试使用其他模型",[29,457,458,463,465],{},[44,459,460],{},[144,461,462],{},"service_unavailable_error",[44,464,126],{},[44,466,467],{},"服务暂时不可用 — 30 秒后重试",[18,469,470],{"id":470},"错误处理",[137,472,476],{"className":473,"code":474,"language":475,"meta":142,"style":142},"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",[144,477,478,487,493,504,511,522,532,537,541,558,569,604,619,626,638,652,664,672,689,732,747],{"__ignoreMap":142},[147,479,480,484],{"class":149,"line":150},[147,481,483],{"class":482},"snl16","import",[147,485,486],{"class":153}," requests\n",[147,488,489],{"class":149,"line":157},[147,490,492],{"emptyLinePlaceholder":491},true,"\n",[147,494,495,498,501],{"class":149,"line":167},[147,496,497],{"class":153},"response ",[147,499,500],{"class":482},"=",[147,502,503],{"class":153}," requests.post(\n",[147,505,506,509],{"class":149,"line":181},[147,507,508],{"class":189},"    \"https://api.evolink.ai/v1/videos/generations\"",[147,510,178],{"class":153},[147,512,513,517,519],{"class":149,"line":195},[147,514,516],{"class":515},"s9osk","    headers",[147,518,500],{"class":482},[147,520,521],{"class":153},"headers,\n",[147,523,524,527,529],{"class":149,"line":208},[147,525,526],{"class":515},"    json",[147,528,500],{"class":482},[147,530,531],{"class":153},"payload\n",[147,533,534],{"class":149,"line":221},[147,535,536],{"class":153},")\n",[147,538,539],{"class":149,"line":232},[147,540,492],{"emptyLinePlaceholder":491},[147,542,543,546,549,552,555],{"class":149,"line":238},[147,544,545],{"class":482},"if",[147,547,548],{"class":153}," response.status_code ",[147,550,551],{"class":482},"==",[147,553,554],{"class":160}," 200",[147,556,557],{"class":153},":\n",[147,559,561,564,566],{"class":149,"line":560},10,[147,562,563],{"class":153},"    task ",[147,565,500],{"class":482},[147,567,568],{"class":153}," response.json()\n",[147,570,572,575,578,581,584,587,590,593,596,599,602],{"class":149,"line":571},11,[147,573,574],{"class":160},"    print",[147,576,577],{"class":153},"(",[147,579,580],{"class":482},"f",[147,582,583],{"class":189},"\"Task created: ",[147,585,586],{"class":160},"{",[147,588,589],{"class":153},"task[",[147,591,592],{"class":189},"'id'",[147,594,595],{"class":153},"]",[147,597,598],{"class":160},"}",[147,600,601],{"class":189},"\"",[147,603,536],{"class":153},[147,605,607,610,612,614,617],{"class":149,"line":606},12,[147,608,609],{"class":482},"elif",[147,611,548],{"class":153},[147,613,551],{"class":482},[147,615,616],{"class":160}," 429",[147,618,557],{"class":153},[147,620,622],{"class":149,"line":621},13,[147,623,625],{"class":624},"sAwPA","    # Rate limited — back off and retry\n",[147,627,629,631,633,636],{"class":149,"line":628},14,[147,630,574],{"class":160},[147,632,577],{"class":153},[147,634,635],{"class":189},"\"Rate limited. Retrying...\"",[147,637,536],{"class":153},[147,639,641,643,645,647,650],{"class":149,"line":640},15,[147,642,609],{"class":482},[147,644,548],{"class":153},[147,646,551],{"class":482},[147,648,649],{"class":160}," 402",[147,651,557],{"class":153},[147,653,655,657,659,662],{"class":149,"line":654},16,[147,656,574],{"class":160},[147,658,577],{"class":153},[147,660,661],{"class":189},"\"Insufficient credits. Please top up at https://evolink.ai/dashboard/billing\"",[147,663,536],{"class":153},[147,665,667,670],{"class":149,"line":666},17,[147,668,669],{"class":482},"else",[147,671,557],{"class":153},[147,673,675,678,680,683,686],{"class":149,"line":674},18,[147,676,677],{"class":153},"    error ",[147,679,500],{"class":482},[147,681,682],{"class":153}," response.json().get(",[147,684,685],{"class":189},"\"error\"",[147,687,688],{"class":153},", {})\n",[147,690,692,694,696,698,701,703,706,709,712,714,717,719,721,724,726,728,730],{"class":149,"line":691},19,[147,693,574],{"class":160},[147,695,577],{"class":153},[147,697,580],{"class":482},[147,699,700],{"class":189},"\"Error [",[147,702,586],{"class":160},[147,704,705],{"class":153},"error.get(",[147,707,708],{"class":189},"'type'",[147,710,711],{"class":153},")",[147,713,598],{"class":160},[147,715,716],{"class":189},"]: ",[147,718,586],{"class":160},[147,720,705],{"class":153},[147,722,723],{"class":189},"'message'",[147,725,711],{"class":153},[147,727,598],{"class":160},[147,729,601],{"class":189},[147,731,536],{"class":153},[147,733,735,738,741,744],{"class":149,"line":734},20,[147,736,737],{"class":482},"    if",[147,739,740],{"class":153}," error.get(",[147,742,743],{"class":189},"\"fallback_suggestion\"",[147,745,746],{"class":153},"):\n",[147,748,750,753,755,757,760,762,764,767,769,771,773],{"class":149,"line":749},21,[147,751,752],{"class":160},"        print",[147,754,577],{"class":153},[147,756,580],{"class":482},[147,758,759],{"class":189},"\"Suggestion: ",[147,761,586],{"class":160},[147,763,705],{"class":153},[147,765,766],{"class":189},"'fallback_suggestion'",[147,768,711],{"class":153},[147,770,598],{"class":160},[147,772,601],{"class":189},[147,774,536],{"class":153},[18,776,777],{"id":777},"生成失败",[779,780,781,790,798],"ul",{},[782,783,784,785,789],"li",{},"视频生成失败",[786,787,788],"strong",{},"不会","从您的账户扣费",[782,791,792,793,797],{},"通过 ",[378,794,796],{"href":795},"/docs/async-tasks","异步任务"," 查看任务状态以了解失败详情",[782,799,800],{},"大多数错误可以通过调整参数并重试来解决",[18,802,803],{"id":803},"相关文档",[779,805,806,813],{},[782,807,808,812],{},[378,809,811],{"href":810},"/docs/rate-limits","速率限制"," — 了解速率限制机制",[782,814,815,819],{},[378,816,818],{"href":817},"/docs/authentication","身份认证"," — 解决认证问题",[821,822,823],"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":142,"searchDepth":157,"depth":157,"links":825},[826,827,828,829,830,831,832],{"id":20,"depth":157,"text":21},{"id":132,"depth":157,"text":132},{"id":244,"depth":157,"text":244},{"id":326,"depth":157,"text":326},{"id":470,"depth":157,"text":470},{"id":777,"depth":157,"text":777},{"id":803,"depth":157,"text":803},"Seedance 2.0 API 完整错误码参考。有效处理错误和边界情况。","md",{},"/zh/docs/error-codes",{"title":5,"description":833},"zh/docs/error-codes","omXsuXkNAPqcaMdLHOWGoQvpSopbJaDYM2OD2XDEeK0",1775067578571]