Hoppa till innehåll
Svenska
Hämta API-nyckel
API-guide

Fel

Visa som Markdown Uppdaterad

Alla ändpunkter misslyckas på samma sätt: en HTTP-status och ett JSON-kuvert.

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ält Betydelse
type Övergripande felklass. Utgå från denna när du avgör vad som ska göras.
code Exakt orsak, stabil och maskinläsbar. Varje kod har ett avsnitt nedan; doc_url länkar till det.
message Läsbar förklaring som är säker att logga eller visa för en utvecklare.
param Indataparametern eller headern som orsakar felet, när en sådan finns.
details För indatafel: alla upptäckta problem: [{ "param", "message" }].
request_id Begäran som det gäller, när en sådan finns.

Inget debiteras för ett anrop som returnerar ett fel. En begäran som misslyckas efter att den har accepterats behåller statusen failed, innehåller error: { "type", "code", "message" } i begärandeobjektet och återbetalas automatiskt.

Typer

Typ HTTP-status Åtgärd
invalid_request 400, 413 eller 422 Korrigera begäran. Om samma anrop försöks igen misslyckas det på nytt.
authentication_error 401 Skicka en giltig nyckel i Authorization: Bearer <key>.
permission_error 403 Använd en nyckel med rätt scope.
not_found 404 Kontrollera modell-id:t eller begärande-id:t.
insufficient_credits 402 Gör en påfyllning av API-saldot (top_up_url i felet).
budget_exceeded 402 Nyckelns eget budget är förbrukat. Slutlig åtgärd: be nyckelägaren höja det.
conflict 409 Resursen befinner sig inte i ett tillstånd som tillåter detta anrop.
rate_limited 429 Vänta Retry-After sekunder och försök sedan igen.
upstream_error 502 Modellens backend misslyckades. Det är säkert att försöka igen med samma Idempotency-Key: körningen görs om och du debiterades inte.
service_unavailable 503 API:t är pausat eller en beroendetjänst ligger nere. Försök igen senare.
internal_error 500 Ett fel hos oss. Försök igen; om det kvarstår kontaktar du supporten med tidpunkten och request_id.

Koder

invalid_request

Allmänt felaktigt utformad begäran (400).

invalid_json

Brödtexten är inte giltig JSON (400).

invalid_body

Brödtexten är giltig JSON men inte ett objekt; modellindata måste vara ett JSON-objekt (400).

body_too_large

Brödtexten är större än 16 MB (413). Ladda upp stora filer och skicka deras URL i stället (se Filer).

invalid_parameter

En frågeparameter har ett felaktigt värde, till exempel limit utanför 1 till 100, wait som inte är ett tal, en okänd status eller category, eller storage annat än permanent / temporary (400). param anger vilken.

invalid_category

GET /openapi.json?category= anger en kategori som inte finns (400). GET https://api.doitong.ru/v1/categories listar dem.

invalid_cursor

cursor i ett listanrop hör inte till denna lista (400). Börja om utan en cursor.

invalid_idempotency_key

Headern Idempotency-Key är tom eller längre än 255 tecken (400).

invalid_arguments

Ett MCP-verktygsanrop saknar ett argument eller innehåller ett felaktigt argument (endast MCP). param anger argumentet.

invalid_input

Modellindata klarar inte valideringen (422): en okänd parameter (meddelandet föreslår närmaste giltiga namn), en obligatorisk parameter saknas, fel typ, ett värde utanför den tillåtna listan eller intervallet, eller både det kanoniska och det inhemska namnet har angetts med olika värden. param är den första felaktiga parametern och details listar alla. Inget debiteras.

unsupported_file

En fil har en typ som vi inte accepterar (422), till exempel en uppladdning med ett tillägg som inte stöds eller en content_type som inte stämmer överens med tillägget.

invalid_webhook_url

webhook_url är inte en offentlig https://-URL (422). Privata, lokala och vanliga http://-adresser avvisas.

missing_api_key

Ändpunkten behöver en API-nyckel men ingen skickades (401).

invalid_api_key

Nyckeln är okänd, återkallad eller utgången (401).

insufficient_scope

Nyckeln saknar det scope som anropet behöver (403), till exempel models:run för en körning eller models:read för att läsa begäranden och saldot. Se Autentisering.

account_disabled

Kontot är stängt eller avstängt (403). Dess nycklar fungerar inte längre.

not_found

Sökvägen finns inte (404).

model_not_found

Ingen offentlig modell har detta id (404). Lista modeller med GET https://api.doitong.ru/v1/models.

request_not_found

Ingen begäran med detta id finns i ditt konto (404). Andra kontons begäranden är aldrig synliga.

insufficient_credits

Kontots API-saldo (API-krediter, 1 000 API-krediter = 1 $ – inte krediterna i Doitong-apparna) täcker inte priset för detta anrop (402). Svaret skickas innan något debiteras. Felet innehåller top_up_url; fyll på pengar på https://doitong.ru/developers/dashboard#balance och försök igen.

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.ru/developers/dashboard#balance",
             "top_up_url": "https://doitong.ru/developers/dashboard#balance", "doc_url": "https://doitong.com/developers/docs/errors#insufficient_credits" } }

budget_exceeded

Anropet skulle överskrida API-nyckelns eget budget i API-krediter (402). Budgeten ställs in av nyckelägaren; nya försök hjälper inte förrän ägaren höjer den.

conflict

Anropet står i konflikt med resursens aktuella tillstånd (409).

idempotency_mismatch

Idempotency-Key har redan använts med en annan brödtext (409). Använd en ny nyckel för en ny åtgärd.

idempotency_in_progress

En begäran med samma Idempotency-Key skapas just nu (409). Försök igen om ett ögonblick för att hämta den.

request_active

Begäran är fortfarande queued eller running, så den har ännu inga filer att ta bort (409). Ta bort dem när den har slutförts.

not_cancelable

Begäran är redan succeeded eller failed och kan inte avbrytas (409).

rate_limited

Nyckeln skickade för många begäranden under det aktuella tidsfönstret (429). Se headerna X-RateLimit-* och Retry-After.

too_many_inflight

Kontot har redan 10 begäranden som är queued eller running (429). Starta nästa när en av dem har slutförts.

upstream_error

Modellens backend avvisade eller misslyckades med begäran (502 vid körning, eller failed med denna kod på begäran). API-krediterna återbetalas. Om backend själv avvisade indata returnerar anropet i stället 422 invalid_input med sitt meddelande.

upstream_lost

Modellens backend känner inte längre till begäran, så inget resultat kommer någonsin. Den avslutas som failed med denna kod (typen upstream_error) och återbetalas. Kör den igen.

timeout

Begäran kördes längre än gränsen (15 minuter för bilder, 60 för video, annars 30) och stoppades. Den avslutas som failed med denna kod och återbetalas.

service_unavailable

API:t är tillfälligt pausat eller en beroendetjänst, till exempel filuppladdningar, ligger nere (503). Försök igen senare.

internal_error

Något gick fel hos oss (500). Försök igen; om det kvarstår kontaktar du supporten.

charge_failed

Kontot kunde inte debiteras på grund av ett internt problem (500). Begäran markeras som failed; inget togs. Försök igen.

pricing_unavailable

Modellens pris är inte konfigurerat, så den kan inte prisberäknas eller köras just nu (500).