Model-id's en varianten

Model-id's op api14 hebben de vorm provider/model, bijvoorbeeld openai/gpt-5-mini. Geef het id mee in het veld model van elk request.

{ "model": "anthropic/claude-sonnet-4.5" }

Model-id's vinden

• Blader door de modellenpagina: elk model met zijn id, prijzen, contextlengte en mogelijkheden.
• Roep GET /models aan vanuit code; filter op categorie met ?category=image. Zie Modellen.

Enkele voorbeelden:

Id's zijn hoofdlettergevoelig. Een onbekend of uitgeschakeld id geeft 404 model_not_found.

Varianten

Een variant is een achtervoegsel na een dubbele punt dat verandert hoe het request wordt afgehandeld. Varianten werken met hetzelfde basismodel; de beschikbaarheid en allowlistregels van het basismodel zijn van toepassing.

{ "model": "openai/gpt-5-mini:online" }

:nitro en :floor zijn snelkoppelingen voor het sorteren van providers, hetzelfde als provider: { sort: "throughput" } en provider: { sort: "price" }. Zie Provider routing en fallbacks.

Model-fallbacks

Stuur een models-array mee om andere modellen te proberen wanneer het eerste mislukt of niet beschikbaar is:

{
  "model": "anthropic/claude-sonnet-4.5",
  "models": ["openai/gpt-5-mini", "google/gemini-2.5-flash"],
  "messages": [{ "role": "user", "content": "Hello" }]
}

Elk model in de lijst moet beschikbaar en toegestaan zijn voor je key en abonnement, anders wordt het request geweigerd voordat het wordt verstuurd. Het veld model in de response vertelt welk model heeft geantwoord, en je betaalt de prijs van dat model.

Allowlists en abonnementen

• Een key met een modelallowlist kan alleen de vermelde id's gebruiken; andere id's geven 403 model_not_allowed.
• Elk abonnement, ook Free, dekt alle modelcategorieën, inclusief video en muziek/audio. Een abonnement dat tot bepaalde categorieën beperkt is, geeft voor de rest 403 plan_required. Zie Prijzen en facturering.

Modelwijzigingen

De catalogus wordt automatisch bijgewerkt. Nieuwe modellen verschijnen vanzelf; verwijderde modellen geven 404 model_not_found. Leg in productie exacte id's vast en gebruik models-fallbacks voor veerkracht.