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 /modelsfrån kod och filtrera efter kategori med?category=image. Se Modeller.
Några exempel:
| Kategori | Exempel-id |
|---|---|
| Text | openai/gpt-5-mini, anthropic/claude-sonnet-4.5, google/gemini-2.5-pro, deepseek/deepseek-chat |
| Bild | openai/gpt-5.4-image-2, google/gemini-2.5-flash-image |
| Video | google/veo-3.1-fast, openai/sora-2-pro |
| Tal (TTS) | openai/gpt-4o-mini-tts |
| Transkribering | openai/whisper-1, openai/gpt-4o-transcribe |
| Embeddings | openai/text-embedding-3-small |
| Rerank | cohere/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.
| Suffix | Effekt |
|---|---|
:free | Modellens kostnadsfria endpoint, där en sådan finns. Kostnadsfria endpoints har strängare hastighetsgränser uppströms. |
:online | Lägger till webbsökresultat i prompten. Se Webbsökning. |
:nitro | Routar till de snabbaste leverantörerna (högst genomströmning). |
:floor | Routar 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_requiredfö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.