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.

Modell-id och varianter

Kom igång

Modell-id och varianter

Modell-id använder formatet provider/model, med varianterna :free, :online, :nitro och :floor, plus reservmodeller, tillåtelselistor och planer.

Modell-id i api14 har formen provider/model, till exempel openai/gpt-5-mini. Skicka id:t i fältet model i vilket anrop som helst.

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

Hitta modell-id

  • Bläddra på modellsidan: varje modell med id, priser, kontextlängd och funktioner.
  • Anropa GET /models från kod och filtrera efter kategori med ?category=image. Se Modeller.

Några exempel:

KategoriExempel-id
Textopenai/gpt-5-mini, anthropic/claude-sonnet-4.5, google/gemini-2.5-pro, deepseek/deepseek-chat
Bildopenai/gpt-5.4-image-2, google/gemini-2.5-flash-image
Videogoogle/veo-3.1-fast, openai/sora-2-pro
Tal (TTS)openai/gpt-4o-mini-tts
Transkriberingopenai/whisper-1, openai/gpt-4o-transcribe
Embeddingsopenai/text-embedding-3-small
Rerankcohere/rerank-v3.5

Id:n är skiftlägeskänsliga. Ett okänt eller inaktiverat id returnerar 404 model_not_found.

Varianter

En variant är ett suffix efter ett kolon som ändrar hur anropet hanteras. Varianter fungerar med samma basmodell, och basmodellens tillgänglighet och tillåtelselistor gäller.

SuffixEffekt
:freeModellens kostnadsfria endpoint, där en sådan finns. Kostnadsfria endpoints har strängare hastighetsgränser uppströms.
:onlineLägger till webbsökresultat i prompten. Se Webbsökning.
:nitroRoutar till de snabbaste leverantörerna (högst genomströmning).
:floorRoutar till de billigaste leverantörerna.
{ "model": "openai/gpt-5-mini:online" }

:nitro och :floor är genvägar för sortering av leverantörer, på samma sätt som provider: { sort: "throughput" } och provider: { sort: "price" }. Se Leverantörsroutning och reservval.

Reservmodeller

Skicka en models-array för att prova andra modeller när den första misslyckas eller inte är tillgänglig:

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

Varje modell i listan måste vara tillgänglig och tillåten för din nyckel och plan, annars avvisas anropet innan det skickas. Fältet model i svaret visar vilken som svarade, och du betalar den modellens pris.

Tillåtelselistor och planer

  • En nyckel med en modelltillåtelselista kan bara använda de listade id:na. Andra id:n returnerar 403 model_not_allowed.
  • Alla planer, även Free, omfattar alla modellkategorier, däribland video och musik/ljud. En plan som är begränsad till vissa kategorier returnerar 403 plan_required för resten. Se Priser och fakturering.

Modelländringar

Katalogen uppdateras automatiskt. Nya modeller dyker upp av sig själva och borttagna modeller returnerar 404 model_not_found. Fäst exakta id:n i produktion och använd models-reservval för robusthet.