Vi använder cookies. Cookies och webbläsarlagring håller dig inloggad och kommer ihåg dina preferenser. Med ditt tillstånd mäter vi också hur webbplatsen används. Du kan när som helst. Läs vår cookiepolicy.

Fel och felkoder

Konto

Fel och felkoder

Alla felkoder som api14-gatewayen returnerar i OpenAI:s felformat, vad varje kod betyder och hur du hanterar fel i din kod.

Fel använder OpenAI:s felformat, så de officiella SDK:erna gör om dem till sina vanliga undantag (APIError, RateLimitError, AuthenticationError och så vidare). Förgrena på code; message är en läsbar förklaring på engelska.

{
  "error": {
    "message": "This request may cost up to $0.0123 but your balance is $0.0040. Add funds at /pricing.",
    "type": "insufficient_quota",
    "code": "insufficient_balance"
  }
}

Misslyckade anrop debiteras inte. Alla svar med en 4xx- eller 5xx-status kostar ingenting.

Gatewayens felkoder

StatuscodetypeBetydelse
400model_requiredinvalid_request_errorFältet model saknas.
400invalid_jsoninvalid_request_errorBodyn är inte ett JSON-objekt.
400invalid_bodyinvalid_request_errorMultipart-bodyn kunde inte läsas.
400max_tokens_too_largeinvalid_request_errorEtt testanrop från playground bad om för många utdata-tokens.
401invalid_api_keyauthentication_errorNyckeln saknas, är felformaterad eller har återkallats.
402insufficient_balanceinsufficient_quotaDitt USD-saldo är $0 eller lägre än den uppskattade maxkostnaden för anropet (indata, utdatagräns, bilder eller videolängd). Anropet skickas inte.
403model_not_allowedpermission_errorNyckelns lista över tillåtna modeller innehåller inte den här modellen.
403plan_requiredpermission_errorDin plan omfattar inte den här modellkategorin.
404model_not_foundnot_found_errorModell-id:t är okänt, inaktiverat eller borttaget.
404not_foundnot_found_errorOkänd endpoint, eller ett videojobb eller en generering som inte är din.
413payload_too_largeinvalid_request_errorAnropets body överskrider storleksgränsen (25 MB som standard).
429rate_limitedrate_limit_errorAntalet anrop per minut har överskridits. Skickas med Retry-After: 60.
429daily_limit_reachedrate_limit_errorNyckeln har nått sin dagliga utgiftsgräns i USD.
409idempotency_conflictapi_errorEn förfrågan med denna Idempotency-Key har redan skickats. Använd en ny nyckel för en annan förfrågan. Hastighetsgränser.
403site_not_allowedpermission_errorEndast widgets: sidans webbplats finns inte bland dina tillåtna widgetwebbplatser. Widgets.
429widget_daily_limitrate_limit_errorEndast widgets: widgeten, eller alla widgets tillsammans, har nått den dagliga utgiftsgränsen i USD.
429visitor_daily_limitrate_limit_errorEndast widgets: besökaren har nått den dagliga gränsen för förfrågningar i widgetinställningarna.
502upstream_unavailableapi_errorLeverantören uppströms gick inte att nå.
4xx/502content_unavailablevarierarEn videos innehåll kunde inte hämtas än (statusen speglar uppströms, 502 om ingen finns).
503maintenanceservice_unavailableUnderhållsläge, genererings-endpoints är pausade, GET-endpoints fungerar fortfarande.
503not_configuredservice_unavailableGatewayen är inte konfigurerad än.

Fel från uppströms

Fel som returneras av leverantören uppströms, till exempel en ogiltig parameter för en viss modell, överskriden kontextlängd, en vägran på grund av innehållspolicy eller en leverantörs egen 429, skickas vidare med sin ursprungliga statuskod och samma { error: {... } }-format.

Vad du ska göra

StatusFörsöka igen?Åtgärd
400NejRätta anropets body.
401NejKontrollera nyckeln och headern Authorization: Bearer. Se Autentisering.
402NejFyll på saldot eller slå på automatisk påfyllning.
403NejAnvänd en tillåten modell, ändra nyckelns lista över tillåtna modeller eller uppgradera din plan.
404NejKontrollera modell-id:t på modellsidan.
413NejSkicka en mindre body, eller skicka filer via URL i stället för base64.
429Senarerate_limited: vänta enligt Retry-After. daily_limit_reached: vänta till nästa UTC-dygn eller höj nyckelns gräns. Se Hastighetsgränser.
502JaFörsök igen med backoff, eller lägg till reservmodeller.
503JaFörsök igen senare.

Hantera fel i koden

import OpenAI from 'openai'

const client = new OpenAI({ baseURL: 'https://api14.com/api/v1', apiKey: process.env.API14_API_KEY })

try {
  await client.chat.completions.create({ model: 'openai/gpt-5-mini', messages: [{ role: 'user', content: 'Hi' }] })
} catch (err) {
  if (err instanceof OpenAI.APIError) {
    console.error(err.status, err.code, err.message)
    if (err.code === 'insufficient_balance') {
      // prompt the user to add funds
    }
  } else {
    throw err
  }
}
from openai import OpenAI, APIStatusError

client = OpenAI(base_url="https://api14.com/api/v1", api_key="sk-api14-...")

try:
    client.chat.completions.create(model="openai/gpt-5-mini", messages=[{"role": "user", "content": "Hi"}])
except APIStatusError as e:
    print(e.status_code, e.code, e.message)

Fel som uppstår efter att en ström har startat kommer inuti strömmen. Se Streaming.