Pierwsze kroki

Identyfikatory modeli i warianty

Identyfikatory modeli mają format provider/model i obsługują warianty :free, :online, :nitro oraz :floor, a także zapasowe modele.

Identyfikatory modeli w api14 mają postać provider/model, na przykład openai/gpt-5-mini. Przekaż identyfikator w polu model dowolnego żądania.

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

Jak znaleźć identyfikatory modeli

Przeglądaj stronę modeli: każdy model z identyfikatorem, cenami, długością kontekstu i możliwościami.
Wywołaj GET /models z kodu; filtruj po kategorii przez ?category=image. Zobacz Modele.

Kilka przykładów:

Kategoria	Przykładowe identyfikatory
Tekst	`openai/gpt-5-mini`, `anthropic/claude-sonnet-4.5`, `google/gemini-2.5-pro`, `deepseek/deepseek-chat`
Obraz	`openai/gpt-5.4-image-2`, `google/gemini-2.5-flash-image`
Wideo	`google/veo-3.1-fast`, `openai/sora-2-pro`
Mowa (TTS)	`openai/gpt-4o-mini-tts`
Transkrypcja	`openai/whisper-1`, `openai/gpt-4o-transcribe`
Embeddingi	`openai/text-embedding-3-small`
Rerank	`cohere/rerank-v3.5`

W identyfikatorach wielkość liter ma znaczenie. Nieznany lub wyłączony identyfikator zwraca 404 model_not_found.

Warianty

Wariant to przyrostek po dwukropku, który zmienia sposób obsługi żądania. Warianty działają z tym samym modelem bazowym; obowiązują zasady dostępności i listy dozwolonych modeli dla modelu bazowego.

Przyrostek	Efekt
`:free`	Bezpłatny endpoint modelu, jeśli istnieje. Bezpłatne endpointy mają surowsze limity zapytań po stronie dostawcy.
`:online`	Dodaje do promptu wyniki wyszukiwania w sieci. Zobacz Wyszukiwanie w sieci.
`:nitro`	Kieruje do najszybszych dostawców (najwyższa przepustowość).
`:floor`	Kieruje do najtańszych dostawców.

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

:nitro i :floor to skróty sortowania dostawców, takie same jak provider: { sort: "throughput" } i provider: { sort: "price" }. Zobacz Routing dostawców i modele zapasowe.

Zapasowe modele

Wyślij tablicę models, aby wypróbować inne modele, gdy pierwszy zawiedzie lub jest niedostępny:

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

Każdy model z listy musi być dostępny i dozwolony dla Twojego klucza i planu, w przeciwnym razie żądanie zostanie odrzucone przed wysłaniem. Pole model w odpowiedzi informuje, który model odpowiedział, a płacisz cenę tego modelu.

Listy dozwolonych modeli i plany

Klucz z listą dozwolonych modeli może używać tylko wymienionych identyfikatorów; inne zwracają 403 model_not_allowed.
Każdy plan, także Free, obejmuje wszystkie kategorie modeli, w tym wideo i muzykę/audio. Plan ograniczony do wybranych kategorii zwraca dla pozostałych 403 plan_required. Zobacz Ceny i rozliczenia.

Zmiany w modelach

Katalog aktualizuje się automatycznie. Nowe modele pojawiają się same; usunięte modele zwracają 404 model_not_found. W produkcji przypinaj dokładne identyfikatory i używaj zapasowych modeli w models dla większej odporności.