Pāriet uz saturu
Latviešu
Iegūt API atslēgu
API rokasgrāmata

Kļūdas

Skatīt kā Markdown Atjaunināts

Katrs galapunkts neizdodas vienādi: HTTP statuss un viens JSON aploksnes objekts.

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"
  }
}
Lauks Nozīme
type Plaša kļūdas kategorija. Pēc tās nosakiet, kā rīkoties.
code Precīzs iemesls, stabils un mašīnlasāms. Katram kodam tālāk ir atsevišķa sadaļa; doc_url ved uz to.
message Cilvēkam saprotams skaidrojums, ko droši reģistrēt vai parādīt izstrādātājam.
param Kļūdainais ievades parametrs vai galvene, ja tāds ir.
details Ievades kļūdām — visas atrastās problēmas: [{ "param", "message" }].
request_id Saistītais pieprasījums, ja tāds pastāv.

Par izsaukumu, kas atgriež kļūdu, nekas netiek iekasēts. Pieprasījums, kas neizdodas pēc pieņemšanas, saglabā statusu failed, pieprasījuma objektā satur error: { "type", "code", "message" } un tiek automātiski atmaksāts.

Tipi

Tips HTTP statuss Rīcība
invalid_request 400, 413 vai 422 Izlabojiet pieprasījumu. Atkārtots tāds pats izsaukums atkal neizdosies.
authentication_error 401 Nosūtiet derīgu atslēgu laukā Authorization: Bearer <key>.
permission_error 403 Izmantojiet atslēgu ar nepieciešamo tvērumu.
not_found 404 Pārbaudiet modeļa ID vai pieprasījuma ID.
insufficient_credits 402 Papildiniet API atlikumu (top_up_url kļūdā).
budget_exceeded 402 Atslēgas budžets ir iztērēts. Rīcība: lūdziet atslēgas īpašniekam to palielināt.
conflict 409 Resurss nav stāvoklī, kas ļauj veikt šo izsaukumu.
rate_limited 429 Uzgaidiet Retry-After sekundes un mēģiniet vēlreiz.
upstream_error 502 Modeļa aizmugursistēma neizdevās. Droši mēģiniet vēlreiz ar to pašu Idempotency-Key: izsaukums tiks palaists vēlreiz; maksa netika iekasēta.
service_unavailable 503 API ir apturēts vai nedarbojas kāda atkarība. Mēģiniet vēlāk.
internal_error 500 Mūsu kļūda. Mēģiniet vēlreiz; ja tā atkārtojas, sazinieties ar atbalsta dienestu, norādot laiku un request_id.

Kodi

invalid_request

Vispārīgs nepareizi veidots pieprasījums (400).

invalid_json

Ķermenis nav derīgs JSON (400).

invalid_body

Ķermenis ir derīgs JSON, bet nav objekts; modeļa ievadei jābūt JSON objektam (400).

body_too_large

Ķermenis ir lielāks par 16 MB (413). Augšupielādējiet lielus failus un tā vietā nododiet to URL (skatiet Faili).

invalid_parameter

Vaicājuma parametram ir nepareiza vērtība, piemēram, limit ir ārpus 1 līdz 100, wait nav skaitlis, nezināms status vai category, vai storage nav permanent / temporary (400). param to norāda.

invalid_category

GET /openapi.json?category= norāda kategoriju, kas nepastāv (400). GET https://api.doitong.com/v1/categories tās uzskaita.

invalid_cursor

Saraksta izsaukuma cursor nepieder šim sarakstam (400). Sāciet no jauna bez kursora.

invalid_idempotency_key

Idempotency-Key galvene ir tukša vai garāka par 255 rakstzīmēm (400).

invalid_arguments

MCP rīka izsaukumam trūkst arguments vai tas ir nepareizi veidots (tikai MCP). param norāda argumentu.

invalid_input

Modeļa ievade neiztur validāciju (422): nezināms parametrs (ziņojums iesaka tuvāko derīgo nosaukumu), trūkstošs obligātais parametrs, nepareizs tips, vērtība ārpus atļautā saraksta vai diapazona, vai arī norādīts gan kanoniskais, gan vietējais nosaukums ar atšķirīgām vērtībām. param ir pirmais kļūdainais parametrs, bet details uzskaita visus. Nekas netiek iekasēts.

unsupported_file

Failam ir neatbalstīts tips (422), piemēram, augšupielādei ir neatbalstīts paplašinājums vai content_type, kas neatbilst paplašinājumam.

invalid_webhook_url

webhook_url nav publisks https:// URL (422). Privātas, lokālas un vienkāršas http:// adreses tiek noraidītas.

missing_api_key

Galapunktam nepieciešama API atslēga, bet tā nav nosūtīta (401).

invalid_api_key

Atslēga nav zināma, atsaukta vai beigusies (401).

insufficient_scope

Atslēgai nav šim izsaukumam nepieciešamā tvēruma (403), piemēram, models:run palaišanai vai models:read, lai lasītu pieprasījumus un atlikumu. Skatiet Autentifikācija.

account_disabled

Konts ir slēgts vai apturēts (403). Tā atslēgas vairs nedarbojas.

not_found

Ceļš nepastāv (404).

model_not_found

Publiska modeļa ar šo ID nav (404). Uzskaitiet modeļus ar GET https://api.doitong.com/v1/models.

request_not_found

Jūsu kontā nav pieprasījuma ar šo ID (404). Citu kontu pieprasījumi nekad nav redzami.

insufficient_credits

Konta API atlikums (API kredīti, 1000 API kredītu = 1 $ — nevis Doitong lietotņu kredīti) nesedz šī izsaukuma cenu (402). Atbilde tiek nosūtīta, pirms kaut kas tiek iekasēts. Kļūdā ir top_up_url; papildiniet atlikumu vietnē https://doitong.com/developers/dashboard#balance un mēģiniet vēlreiz.

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

Izsaukums pārsniegtu API atslēgas budžetu API kredītos (402). Budžetu iestata atslēgas īpašnieks; atkārtots mēģinājums nepalīdzēs, līdz īpašnieks to palielinās.

conflict

Izsaukums konfliktē ar pašreizējo resursa stāvokli (409).

idempotency_mismatch

Idempotency-Key jau tika izmantota ar citu ķermeni (409). Jaunai darbībai izmantojiet jaunu atslēgu.

idempotency_in_progress

Tieši tagad tiek izveidots pieprasījums ar tādu pašu Idempotency-Key (409). Pēc brīža mēģiniet vēlreiz, lai to saņemtu.

request_active

Pieprasījums joprojām ir queued vai running, tāpēc tajā vēl nav dzēšamu failu (409). Izdzēsiet tos, kad pieprasījums būs pabeigts.

not_cancelable

Pieprasījums jau ir succeeded vai failed un to nevar atcelt (409).

rate_limited

Atslēga pašreizējā periodā veikusi pārāk daudz pieprasījumu (429). Skatiet X-RateLimit-* un Retry-After galvenes.

too_many_inflight

Kontā jau ir 10 queued vai running pieprasījumi (429). Sāciet nākamo, kad kāds no tiem būs pabeigts.

upstream_error

Modeļa aizmugursistēma noraidīja vai neizpildīja pieprasījumu (502 palaišanas laikā vai failed ar šo kodu pieprasījumā). API kredīti tiek atmaksāti. Ja aizmugursistēma pati noraidīja ievadi, izsaukums atgriež 422 invalid_input ar attiecīgo ziņojumu.

upstream_lost

Modeļa aizmugursistēma vairs nezina par pieprasījumu, tāpēc rezultāts nekad neienāks. Tas beidzas ar failed un šo kodu (tips upstream_error) un tiek atmaksāts. Palaidiet to vēlreiz.

timeout

Pieprasījums darbojās ilgāk par atļauto laiku (15 minūtes attēliem, 60 video, 30 citos gadījumos) un tika apturēts. Tas beidzas ar failed un šo kodu un tiek atmaksāts.

service_unavailable

API īslaicīgi ir apturēts vai nedarbojas kāda atkarība, piemēram, failu augšupielāde (503). Mēģiniet vēlāk.

internal_error

Mūsu pusē radās kļūme (500). Mēģiniet vēlreiz; ja tā atkārtojas, sazinieties ar atbalsta dienestu.

charge_failed

Iekšējas problēmas dēļ no konta nevarēja iekasēt maksu (500). Pieprasījums atzīmēts kā failed; nekas netika paņemts. Mēģiniet vēlreiz.

pricing_unavailable

Modeļa cena nav konfigurēta, tāpēc to pašlaik nevar aprēķināt vai modeli palaist (500).