API-leiðbeiningar

Villur

Skoða sem Markdown Uppfært 2026-10-22

Allir endapunktar bregðast við á sama hátt: HTTP-staða og eitt JSON-umslag.

JSON

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_input",
    "message": "duration must be one of 5, 10.",
    "param": "duration",
    "details": [ { "param": "duration", "message": "duration must be one of 5, 10." } ],
    "request_id": null,
    "doc_url": "https://doitong.com/developers/docs/errors#invalid_input"
  }
}

Fær	Merking
`type`	Yfirflokkur villunnar. Ákveddu út frá þessu hvað skuli gera.
`code`	Nákvæm ástæða, stöðug og véllesanleg. Allir kóðar eiga sinn kafla hér að neðan; `doc_url` tengir í hann.
`message`	Mannlesanleg skýring, örugg til skráningar eða birtingar fyrir þróunaraðila.
`param`	Inntaksfæribreytan eða hausinn sem veldur vandanum, ef slíkt er til staðar.
`details`	Fyrir inntaksvillur, öll vandamál sem fundust: `[{ "param", "message" }]`.
`request_id`	Beiðnin sem þetta varðar, ef hún er til.

Ekkert er rukkað fyrir kall sem skilar villu. Beiðni sem bregst eftir að hún hefur verið samþykkt heldur stöðunni failed, inniheldur error: { "type", "code", "message" } í beiðnishlutnum og er endurgreidd sjálfkrafa.

Tegundir

Tegund	HTTP-staða	Hvað skal gera
`invalid_request`	400, 413 eða 422	Lagfærðu beiðnina. Sama kall bregst aftur við endurtekningu.
`authentication_error`	401	Sendu gildan lykil í `Authorization: Bearer <key>`.
`permission_error`	403	Notaðu lykil með nauðsynlegu umfangi.
`not_found`	404	Athugaðu auðkenni líkans eða beiðni.
`insufficient_credits`	402	Gerðu áfyllingu á API-stöðunni (`top_up_url` í villunni).
`budget_exceeded`	402	Fjárhagsrammi lykilsins er uppurinn. Að lokum: biddu eiganda lykilsins að hækka hann.
`conflict`	409	Tilfangið er ekki í stöðu sem leyfir þetta kall.
`rate_limited`	429	Bíddu í `Retry-After` sekúndur og reyndu svo aftur.
`upstream_error`	502	Bakendi líkansins brást. Öruggt er að reyna aftur með sama `Idempotency-Key`: það keyrir aftur; ekkert var rukkað.
`service_unavailable`	503	Gervigreindarforritaskilin eru í bið eða háð þjónusta liggur niðri. Reyndu aftur síðar.
`internal_error`	500	Villa hjá okkur. Reyndu aftur; ef hún heldur áfram skaltu hafa samband við þjónustuver með tímasetningu og `request_id`.

Kóðar

`invalid_request`

Almenn ógild beiðni (400).

`invalid_json`

Meginmálið er ekki gilt JSON (400).

`invalid_body`

Meginmálið er gilt JSON en ekki hlutur; inntak líkans verður að vera JSON-hlutur (400).

`body_too_large`

Meginmálið er stærra en 16 MB (413). Hladdu upp stórum skrám og sendu URL þeirra í staðinn (sjá Skrár).

`invalid_parameter`

Færibreyta fyrirspurnar hefur rangt gildi, til dæmis limit utan bilsins 1 til 100, wait er ekki tala, óþekkt status eða category, eða storage annað en permanent / temporary (400). param nefnir hana.

`invalid_category`

GET /openapi.json?category= nefnir flokk sem er ekki til (400). GET https://api.doitong.com/v1/categories sýnir þá.

`invalid_cursor`

cursor í listakalli tilheyrir ekki þessum lista (400). Byrjaðu aftur án bendils.

`invalid_idempotency_key`

Idempotency-Key-hausinn er tómur eða lengri en 255 stafir (400).

`invalid_arguments`

MCP-verkfæra- kall vantar færibreytu eða hún er gölluð (aðeins MCP). param nefnir færibreytuna.

`invalid_input`

Inntak líkans stenst ekki sannprófun (422): óþekkt færibreyta (skilaboðin leggja til næsta gilda heiti), skyldufæribreytu vantar, rangt gagnagerð, gildi er utan leyfðs lista eða bils, eða bæði staðlaða og innbyggða heitið eru gefin með ólíkum gildum. param er fyrsta færibreytan sem veldur vandanum og details sýnir þær allar. Ekkert er rukkað.

`unsupported_file`

Skrá er af tegund sem við tökum ekki við (422), til dæmis upphleðsla með óstuddu viðskeyti eða content_type sem passar ekki við viðskeytið.

`invalid_webhook_url`

webhook_url er ekki opinbert https:// URL (422). Einkareikningar, staðbundin vistföng og venjuleg http://-vistföng eru höfnuð.

`missing_api_key`

Endapunkturinn þarfnast API-lykils en enginn var sendur (401).

`invalid_api_key`

Lykillinn er óþekktur, afturkallaður eða útrunninn (401).

`insufficient_scope`

Lykilinn skortir umfangið sem þetta kall þarfnast (403), til dæmis models:run fyrir keyrslu eða models:read til að lesa beiðnir og stöðu. Sjá Auðkenning.

`account_disabled`

Reikningnum hefur verið lokað eða hann settur í bið (403). Lyklar hans virka ekki lengur.

`not_found`

Slóðin er ekki til (404).

`model_not_found`

Ekkert opinbert líkan hefur þetta auðkenni (404). Sýndu líkön með GET https://api.doitong.com/v1/models.

`request_not_found`

Engin beiðni með þessu auðkenni er til á reikningnum þínum (404). Beiðnir annarra reikninga eru aldrei sýnilegar.

`insufficient_credits`

API-staða reikningsins (API-inneign, 1.000 API-inneignir = 1 $ — ekki inneign Doitong-forritanna) nær ekki yfir verð þessa kalls (402). Svarið er sent áður en nokkuð er rukkað. Villan inniheldur top_up_url; bættu við fé á https://doitong.com/developers/dashboard#balance og reyndu aftur.

JSON

{ "error": { "type": "insufficient_credits", "code": "insufficient_credits",
             "message": "This request costs 560 API credits ($0.56); the API balance is 120 API credits ($0.12). Top up at https://doitong.com/developers/dashboard#balance",
             "top_up_url": "https://doitong.com/developers/dashboard#balance", "doc_url": "https://doitong.com/developers/docs/errors#insufficient_credits" } }

`budget_exceeded`

Kallið myndi fara yfir eigin fjárhagsramma API-lykilsins í API-inneign (402). Eigandi lykilsins stillir fjárhagsrammann; endurtekning hjálpar ekki fyrr en hann er hækkaður.

`conflict`

Kallið stangast á við núverandi stöðu tilfangsins (409).

`idempotency_mismatch`

Idempotency-Key var þegar notað með öðru meginmáli (409). Notaðu nýjan lykil fyrir nýja aðgerð.

`idempotency_in_progress`

Beiðni með sama Idempotency-Key er í vinnslu núna (409). Reyndu aftur eftir augnablik til að sækja hana.

`request_active`

Beiðnin er enn queued eða running og því eru engar skrár til að eyða enn (409). Eyddu þeim þegar hún er búin.

`not_cancelable`

Beiðnin er þegar succeeded eða failed og ekki er hægt að hætta við hana (409).

`rate_limited`

Lykillinn sendi of margar beiðnir í núverandi glugga (429). Sjá hausana X-RateLimit-* og Retry-After.

`too_many_inflight`

Reikningurinn hefur þegar 10 beiðnir queued eða running (429). Byrjaðu næstu þegar ein þeirra lýkur.

`upstream_error`

Bakendi líkansins hafnaði beiðninni eða brást (502 við keyrslu, eða failed með þessum kóða á beiðninni). API-inneignin er endurgreidd. Ef bakendinn hafnaði sjálfu inntakinu skilar kallið 422 invalid_input með skilaboðum þess í stað.

`upstream_lost`

Bakendi líkansins þekkir ekki lengur beiðnina, svo niðurstaða berst aldrei. Hún endar sem failed með þessum kóða (tegund upstream_error) og er endurgreidd. Keyrðu hana aftur.

`timeout`

Beiðnin keyrði lengur en leyfilegt er (15 mínútur fyrir myndir, 60 fyrir myndband, 30 annars) og var stöðvuð. Hún endar sem failed með þessum kóða og er endurgreidd.

`service_unavailable`

Gervigreindarforritaskilin eru tímabundið í bið eða háð þjónusta á borð við skráaupphleðslur liggur niðri (503). Reyndu aftur síðar.

`internal_error`

Eitthvað bilaði hjá okkur (500). Reyndu aftur; ef það heldur áfram skaltu hafa samband við þjónustuver.

`charge_failed`

Ekki tókst að rukka reikninginn vegna innri vandamáls (500). Beiðnin er merkt failed; ekkert var tekið. Reyndu aftur.

`pricing_unavailable`

Verð líkansins er ekki stillt og því er ekki hægt að gefa upp verð eða keyra það núna (500).

Tegundir#

Kóðar#

invalid_request#

invalid_json#

invalid_body#

body_too_large#

invalid_parameter#

invalid_category#

invalid_cursor#

invalid_idempotency_key#

invalid_arguments#

invalid_input#

unsupported_file#

invalid_webhook_url#

missing_api_key#

invalid_api_key#

insufficient_scope#

account_disabled#

not_found#

model_not_found#

request_not_found#

insufficient_credits#

budget_exceeded#

conflict#

idempotency_mismatch#

idempotency_in_progress#

request_active#

not_cancelable#

rate_limited#

too_many_inflight#

upstream_error#

upstream_lost#

timeout#

service_unavailable#

internal_error#

charge_failed#

pricing_unavailable#