Buduj z CometAPIPotrzebujesz jednego API dla wielu modeli?Przetestuj proces w Playground, a potem utwórz klucz API, gdy model i koszt pasują do Twojego zastosowania.
Jak korzystać z Claude Fable 5.2 API: kompletny przewodnik 2026
Poznaj API Claude Fable 5.2 wraz z oficjalną konfiguracją Anthropic i CometAPI, przykładami w Pythonie, strumieniowaniem, wejściem obrazu, cennikiem oraz najlepszymi praktykami produkcyjnymi.
API Claude Fable 5.2 umożliwia dodanie zaawansowanego rozumowania do asystentów programistycznych, przepływów pracy badawczych oraz aplikacji wymagających długotrwałej, wieloetapowej pracy. Możesz łączyć się bezpośrednio z Anthropic albo skorzystać z CometAPI — w zależności od tego, jak chcesz zarządzać dostępem do modelu i integracją.
Dla niższych kosztów tokenów i prostszej integracji z wieloma modelami, Claude Fable 5.2 API przez CometAPI to praktyczny punkt startowy: opublikowane stawki wejścia i wyjścia są o 20% niższe niż standardowe stawki API Anthropic, a Ty zachowujesz format żądań Anthropic Messages w ujednoliconym przepływie dostępu do modeli i rozliczeń. Wybierz bezpośredni dostęp Anthropic, gdy kluczowe są dostawco-specyficzne kontrole konta lub natywna funkcja.
Ten przewodnik obejmuje oba warianty, a następnie prowadzi przez żądania w Pythonie, strumieniowanie, historię konwersacji, wejście obrazów i kontrolę gotowości produkcyjnej. Potrzebujesz Pythona 3.10 lub nowszego, klucza API dla wybranej ścieżki i dostępu do claude-fable-5-2.
Sprawdzone pod kątem przejrzystości, atrybucji źródeł i aktualnej terminologii API.
Key Takeaways
API Claude Fable 5.2 używa identyfikatora modelu claude-fable-5-2 na obu pokazanych ścieżkach.
Bezpośredni dostęp Anthropic i CometAPI wykorzystują oddzielne klucze i rozliczenia; wybierz ścieżkę przed wysłaniem żądania.
CometAPI pasuje do aplikacji wielodostawczych dzięki współdzielonym poświadczeniom, rozliczeniom i kompatybilnym interfejsom API.
Zacznij od jednego żądania tekstowego, a następnie dodawaj ustawienia rozumowania, strumieniowanie, historię konwersacji i obrazy — w razie potrzeby.
CometAPI obniża opłaty tokenowe Claude Fable 5.2 o 20% względem oficjalnych stawek standardowych pokazanych poniżej, w tym wymienionych operacji cache.
What Is the Claude Fable 5.2 API?
Claude Fable 5.2 to model rozumowania Anthropic do wymagającej pracy technicznej. Został wydany 9 listopada 2026 r.. API zapewnia Twojej aplikacji dostęp do modelu bez konieczności samodzielnego utrzymywania infrastruktury modelu.
Typowe projekty startowe obejmują przegląd zmian w repozytorium, analizę zbioru dokumentów oraz objaśnianie złożonego projektu systemu. Każdy zaczyna się od żądania i odpowiedzi; narzędzia i dłuższe pętle konwersacji można dodać, gdy ta ścieżka działa.
Claude Fable 5.2 API specifications
Specyfikacja
Oficjalne specyfikacje Claude Fable 5.2
Model ID
claude-fable-5-2
Okno kontekstu
1M tokenów
Maksymalna długość wyjścia
128K tokenów
Wejście / wyjście
Tekst i obrazy / tekst
Rozumowanie
Adaptacyjne; zawsze włączone
Domyślny poziom wysiłku API
high
Główny format żądania w tym guide
Anthropic Messages
Limity kontekstu i wyjścia opisują pojemność, a nie sugerowane rozmiary żądań. Użyj krótkiego promptu i umiarkowanego budżetu wyjścia, gdy weryfikujesz poświadczenia i obsługę odpowiedzi.
What Is New in Claude Fable 5.2 API Compared with Fable 5.1?
Jeśli już używasz Fable 5.1, aktualizacja dotyczy głównie lepszej wydajności zadań, niższych standardowych cen tokenów oraz zmian w kompatybilności konwersacji i narzędzi. Poniższe porównanie używa Fable 5.1 jako poprzedniej generacji.
Stronger results on demanding technical tasks
W ocenach wydania Anthropic Fable 5.2 uzyskał 49,1% na FrontierCode 2.0 wobec 32,4% dla Fable 5.1, oba przy xhigh effort. Wyniki Chartography wzrosły z 44,8% do 73,4%. Anthropic raportuje także generowanie wyjścia do 30% szybsze niż 5.1 i opcjonalny tryb fast. To wyniki raportowane przez dostawcę; szybsze generowanie nie gwarantuje krótszego czasu żądania end-to-end dla Twojego obciążenia.
Dla przeglądu repozytorium lub trudnego zadania analizy dokumentów sprawdź, czy nowy model wychwytuje błędy, które umykają Twojemu obecnemu modelowi. Zachowaj spójne prompty, wejścia i kryteria oceny, aby porównanie odpowiadało na praktyczne pytanie: czy częściej poprawnie domyka realną pracę?
Lower standard prices than Fable 5.1
Opublikowane standardowe stawki Anthropic spadają z 10 USD do 8 USD za milion tokenów wejściowych i z 50 USD do 40 USD za milion tokenów wyjściowych. Odczyty z cache spadają z 0,25 USD do 0,20 USD. Każda pozycja to redukcja o 20%. To oficjalne ceny generacja-do-generacji; późniejsze porównanie CometAPI mierzy odrębną różnicę między dostawcami dostępu.
Przy niezmienionym użyciu 100 000 tokenów wejściowych i 10 000 tokenów wyjściowych, niekeszowane standardowe żądanie spada z 1,50 USD na Fable 5.1 do 1,20 USD na Fable 5.2. Rzeczywiste oszczędności zależą od wygenerowanych tokenów, ponowień, keszowania i trybów opcjonalnych.
Four compatibility changes to check
Oficjalny dziennik zmian identyfikuje cztery zmiany, które mogą wpłynąć na istniejącą integrację:
Kontrole konwersacji obejmują teraz każde konto. Odtwarzanie rozumowania po edycji wcześniejszych wiadomości, instrukcji systemowych lub narzędzi może się nie powieść, także na starszych kontach, które wcześniej przechodziły.
Rollback nie zachowuje całego rozumowania. Tylko Fable 5.2 i Mythos 5.2 mogą czytać bloki rozumowania Fable 5.2. Przełączenie na 5.1 lub inny model może odrzucić to rozumowanie.
Computer use wymaga nowszego zestawu narzędzi. Stare computer_20251124 nie działa poza Amazon Bedrock; użyj computer_toolset_20260801 i dostosuj pętlę narzędzi.
Zmiany w kompatybilności advisor. Executor Fable 5.2 wymaga advisor Fable 5.2 lub Mythos 5.2.
What stays the same
Specyfikacja Fable 5.1 obejmowała już 1M-tokenowe okno kontekstu, maks. 128K tokenów wyjścia, wejście tekstowe i obrazowe, zawsze włączone adaptacyjne rozumowanie i wysoki domyślny wysiłek API. To wciąż użyteczne możliwości w 5.2, ale nie są nowym powodem migracji.
How to Migrate to Claude Fable 5.2 API—and Is It Worth It?
Zacznij od małej migracji, którą można zmierzyć i odwrócić. Udane pierwsze żądanie to dopiero początek: Twoja aplikacja musi także zachowywać stan konwersacji, domykać przepływy narzędzi i poprawnie obsługiwać fallback.
Zmień model w konfiguracji testowej. Ustaw MODEL na claude-fable-5-2 w client_config.py używanym poniżej. Trzymaj wybraną parę klucz + base URL razem. Najpierw uruchom świeżą, krótką rozmowę.
Przejrzyj opcje żądania. Dla starszych integracji usuń wyłączone lub ręcznie budżetowane rozumowanie, prefille asystenta i wymuszony wybór narzędzi. Pomiń temperature, top_p i top_k. Użyj output_config.effort do regulacji rozumowania.
Sprawdź obsługę historii. Odtwarzaj kompletne odpowiedzi asystenta w ich pierwotnej kolejności. Zachowaj wcześniejsze wiadomości, instrukcje systemowe i definicje narzędzi bez zmian; dopisuj nowe tury. Przećwicz kod przycinający historię lub odświeżający narzędzia.
Aktualizuj opcjonalne narzędzia razem. Zastosuj opisane wyżej zmiany dot. computer-use i advisor tam, gdzie dotyczą. Rozpocznij nową rozmowę po zmianie definicji narzędzi.
Przetestuj ścieżkę powrotną. Uruchom zadanie wieloturowe, rundę narzędzia i fallback do poprzedniego modelu. Udana odpowiedź fallback nie oznacza, że wcześniejsze rozumowanie przetrwało.
Korzystając z CometAPI, potwierdź dostępność modelu i wymagane funkcje opcjonalne na tej ścieżce, zanim włączysz je w produkcji. Sam kompatybilny interfejs Messages nie gwarantuje wsparcia dla każdej funkcji dostawcy.
Is migrating worth it?
From Fable 5.1: priorytetowo potraktuj pilota, jeśli złożona praca techniczna ma już wartość dla Twojej aplikacji. Niższe stawki standardowe czynią eksperyment atrakcyjnym, ale porównuj koszt ukończonych zadań, zamiast zakładać identyczne użycie tokenów w każdym żądaniu.
From Opus, Sonnet, or Haiku: zacznij od zadań, z którymi obecny model sobie nie radzi. Przeniesienie każdego żądania na Fable może zwiększyć wydatki bez poprawy prostych przypadków. Rutynowe żądania możesz zostawić na dotychczasowym modelu i ocenić Fable dla trudniejszych spraw.
Pozostań przy obecnym setupie, jeśli spełnia Twoje cele jakości i czasu odpowiedzi lub jeśli wymagane zmiany historii i narzędzi przewyższają zmierzoną korzyść. Aktualizacja powinna rozwiązywać konkretny, zidentyfikowany problem.
Anthropic Official API vs CometAPI:Why I chose the latter
Zarządzane w CometAPI w poprzek obsługiwanych modeli
Najlepsze dopasowanie
Usługi skoncentrowane na Claude wymagające kontroli u dostawcy
Aplikacje szukające niższych kosztów tokenów lub integracji modeli od kilku dostawców
Walidacja funkcji
Sprawdź wymagania modelu i konta w Anthropic
Sprawdź wymagania modelu i wybraną trasę przez gateway
Where CometAPI simplifies a multi-model application
CometAPI dokumentuje współdzielony klucz i warstwę rozliczeń dla wielu formatów API. Dla zespołu utrzymującego kilka integracji modeli może to zmniejszyć liczbę oddzielnych poświadczeń i przepływów kont, które trzeba obsługiwać. Korzyść rośnie, gdy Claude jest jednym z elementów szerszego produktu.
Możesz też zachować istniejącą integrację z SDK Anthropic: poniższa konfiguracja klienta zmienia klucz i base URL, podczas gdy treść żądania Messages pozostaje taka sama. Dla aplikacji już używających kompatybilnego interfejsu czatu CometAPI oferuje kolejny punkt wejścia; wybierz format, który zachowuje potrzebne funkcje.
Zacznij od CometAPI, gdy priorytetem jest redukcja wydatków na tokeny — niezależnie, czy używasz Claude samodzielnie, czy obok innych dostawców. Przetestuj reprezentatywne żądania swoim istniejącym kodem klienta, aby potwierdzić potrzebne funkcje. Wybierz bezpośredni dostęp Anthropic, gdy Twoje wymagania koncentrują się na dostawco-specyficznych kontrolach konta. Dla każdej ścieżki sprawdź skuteczność realizacji zadań, zużycie i opóźnienia, zanim przeniesiesz ruch produkcyjny.
How to Use Claude Fable 5.2 API Step by Step?
Wybierz jedną ścieżkę dostępu dla pierwszego żądania. Przykłady w Pythonie współdzielą mały plik konfiguracyjny, więc później możesz przetestować drugą ścieżkę bez przepisywania treści żądania.
Step 1: Create an API key
Dla dostępu oficjalnego postępuj zgodnie z konfiguracją klucza API Anthropic w Claude Console. Użyj klucza o zasięgu workspace dla tego tutorialu i potwierdź dostęp oraz rozliczenia na koncie. Zapisz go jako ANTHROPIC_API_KEY. Klucze bez zakresu workspace wymagają też nagłówka workspace opisanego w dokumentacji uwierzytelniania Anthropic.
Dla CometAPI utwórz klucz w panelu API i potwierdź dostęp do modelu oraz saldo. Zapisz go jako COMETAPI_KEY. Klucz od jednego dostawcy nie uwierzytelni się na endpointzie drugiego.
Przechowuj klucz bezpiecznie. Unikaj umieszczania poświadczeń bezpośrednio w źródłach aplikacji lub frontendowym JavaScript.
W macOS lub Linux uruchom odpowiednie przypisanie w powłoce, w której startujesz Pythona:
# Set the variable for the route you chose.
export ANTHROPIC_API_KEY="your_anthropic_api_key"
# Or, for CometAPI:
export COMETAPI_KEY="your_cometapi_api_key"
W Windows PowerShell użyj odpowiedniej zmiennej środowiskowej:
# Set the variable for the route you chose.
$env:ANTHROPIC_API_KEY = "your_anthropic_api_key"
# Or, for CometAPI:
$env:COMETAPI_KEY = "your_cometapi_api_key"
Step 2: Make a first request with cURL
To alternatywne polecenia Bash. Uruchom to dla wybranego konta, aby sprawdzić odpowiedź HTTP przed wprowadzeniem Pythona.
Wyślij żądanie tekstowe bezpośrednio do Anthropic, używając klucza o zasięgu workspace:
Przykłady HTTP używają nagłówków wersji udokumentowanych dla każdej ścieżki: Wersje API Anthropic i format Messages CometAPI. SDK zarządza tymi nagłówkami za Ciebie; opcjonalne możliwości beta nadal wymagają weryfikacji specyficznej dla ścieżki.
Endpoint zwraca odpowiedź w stylu Anthropic zawierającą content, usage i stop_reason.
Utwórz client_config.py w folderze projektu. Wybierz dokładnie jedną z poniższych konfiguracji; wszystkie kolejne skrypty importują client i MODEL z tego pliku.
Konfiguracja CometAPI: zapisz to jako client_config.py przy użyciu konta CometAPI:
import os
from anthropic import Anthropic
MODEL = "claude-fable-5-2"
client = Anthropic(
api_key=os.environ["COMETAPI_KEY"],
auth_token=None,
base_url="https://api.cometapi.com",
)
Konfiguracja oficjalna: użyj tej wersji client_config.py dla bezpośredniego dostępu Anthropic:
import os
from anthropic import Anthropic
MODEL = "claude-fable-5-2"
client = Anthropic(
api_key=os.environ["ANTHROPIC_API_KEY"],
auth_token=None,
base_url="https://api.anthropic.com",
)
Dla Messages SDK te base URL nie mają sufiksu /v1. Porównując ścieżki, uruchamiaj oddzielne sesje z pasującym kluczem i konfiguracją klienta zamiast podmieniać poświadczenia w trakcie żywej rozmowy.
Step 4: Send a request with Python
Zapisz to jako fable52.py obok client_config.py. Żądanie działa z wybraną wcześniej konfiguracją:
from client_config import client, MODEL
response = client.messages.create(
model=MODEL,
max_tokens=4096,
messages=[{
"role": "user",
"content": "Explain synchronous and asynchronous Python.",
}],
)
for block in response.content:
if block.type == "text":
print(block.text)
print("Stop reason:", response.stop_reason)
print("Input tokens:", response.usage.input_tokens)
print("Output tokens:", response.usage.output_tokens)
Uruchom przykład w terminalu, w którym ustawiłeś klucz:
python fable52.py
Udane żądanie tylko-tekstowe wypisuje odpowiedź i usage. Sprawdź end_turn zanim uznasz odpowiedź za kompletną. Jeśli stop reason to max_tokens, przejrzyj częściowe wyjście i budżet; sukces HTTP nie oznacza sam w sobie, że żądana praca została ukończona.
How to Add Reasoning, Streaming, and Images to Claude Fable 5.2?
Zachowaj client_config.py z sekcji konfiguracji. Każdy skrypt poniżej używa wybranej ścieżki, więc możesz testować nowe funkcje bez zmiany podstawowego kodu połączenia.
Controlling reasoning effort
Fable 5.2 używa zawsze włączonego adaptacyjnego rozumowania. Możesz pominąć thinking lub ustawić jego typ na adaptive; wyłączone rozumowanie i ręczne budżety tokenów rozumowania nie są wspierane.
Parametr effort akceptuje wartości low, medium, high, xhigh i max. Zacznij od domyślnego API, high, i zmieniaj go dopiero po uzyskaniu użytecznego punktu odniesienia dla swojego zadania.
Zapisz to jako fable52_effort.py i uruchom python fable52_effort.py, aby ustawić effort explicite:
from client_config import client, MODEL
response = client.messages.create(
model=MODEL,
max_tokens=8192,
thinking={"type": "adaptive"},
output_config={"effort": "high"},
messages=[{
"role": "user",
"content": "Identify failure modes in a queue-based worker system.",
}],
)
for block in response.content:
if block.type == "text":
print(block.text)
print("Stop reason:", response.stop_reason)
Pomiń temperature, top_p i top_k w początkowym żądaniu. Fable 5.2 odrzuca też wymuszony wybór narzędzi; nie przenoś typów tool_choice any ani tool z innej integracji.
Streaming for interactive applications
Zamiast czekać na całą odpowiedź, Twoja aplikacja może wyświetlać generowany tekst na bieżąco.
Zapisz to jako fable52_stream.py i uruchom python fable52_stream.py:
from client_config import client, MODEL
with client.messages.stream(
model=MODEL,
max_tokens=8192,
messages=[{
"role": "user",
"content": "Design a fault-tolerant microservice architecture.",
}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)
final_message = stream.get_final_message()
print("\nStop reason:", final_message.stop_reason)
print("Usage:", final_message.usage)
Może pojawić się pauza przed pierwszym tekstem, gdy model rozumuje. Traktuj strumień jako zakończony dopiero po pomyślnym zakończeniu pomocnika; sam częściowy tekst nie potwierdza kompletnej odpowiedzi.
Preserving multi-turn conversation history
W przeciwieństwie do stanowego interfejsu czatu, standardowe Messages API polega na tym, że Twoja aplikacja dostarcza historię konwersacji.
Zapisz to jako fable52_history.py i uruchom python fable52_history.py, aby wykonać dwa powiązane żądania:
from client_config import client, MODEL
history = [{
"role": "user",
"content": "Design a scalable event-processing architecture.",
}]
first = client.messages.create(
model=MODEL,
max_tokens=8192,
output_config={"effort": "high"},
messages=history,
)
if first.stop_reason != "end_turn":
raise RuntimeError(f"First turn is incomplete: {first.stop_reason}")
history.append({
"role": "assistant",
"content": [block.model_dump() for block in first.content],
})
history.append({
"role": "user",
"content": "Now identify its three highest-risk failure scenarios.",
})
second = client.messages.create(
model=MODEL,
max_tokens=8192,
output_config={"effort": "high"},
messages=history,
)
for block in second.content:
if block.type == "text":
print(block.text)
print("Stop reason:", second.stop_reason)
Zwróć uwagę, że przykład zachowuje pełną zawartość asystenta z pierwszej odpowiedzi zamiast wyciągania tylko widocznego tekstu.
Fable 5.2 waliduje rozumowanie względem poprzedzającej je konwersacji. Zachowaj wcześniejsze wiadomości, instrukcje systemowe i definicje narzędzi bez zmian przy odtwarzaniu tych bloków. Dopisuj kolejną turę zamiast przebudowywać prefiks.
Ilustracja kontekstu i kompakcji Anthropic pokazuje, dlaczego długa sesja ostatecznie wymaga mniejszej roboczej historii. Diagram pochodzi z Claude Code; niestandardowa aplikacja API musi zaimplementować własne zarządzanie kontekstem.
Na potrzeby tego tutorialu zachowaj krótką historię w całości. Zanim dodasz kompakcję do dłuższej aplikacji, potwierdź, że Twój gateway wspiera udokumentowaną opcję po stronie serwera. Jeśli zaczynasz nową rozmowę z podsumowania, nie dołączaj podpisanych bloków rozumowania ze starego prefiksu.
Sending an image for analysis
Natywny format wejścia obrazu umieszcza blok obrazu obok tekstowej instrukcji. Ten przykład czyta lokalny plik PNG; przed użyciem większych wejść potwierdź obsługę obrazów i limity rozmiaru na wybranej trasie przez gateway.
Umieść dashboard.png obok skryptów, zapisz to jako fable52_vision.py i uruchom python fable52_vision.py:
import base64
from pathlib import Path
from client_config import client, MODEL
image_data = base64.b64encode(
Path("dashboard.png").read_bytes()
).decode("ascii")
response = client.messages.create(
model=MODEL,
max_tokens=4096,
messages=[{
"role": "user",
"content": [
{
"type": "image",
"source": {
"type": "base64",
"media_type": "image/png",
"data": image_data,
},
},
{
"type": "text",
"text": "Identify three usability issues in this dashboard.",
},
],
}],
)
for block in response.content:
if block.type == "text":
print(block.text)
print("Stop reason:", response.stop_reason)
Adding application-controlled tools
W pętli narzędzi po stronie klienta zdefiniuj narzędzia ze schematami wejścia, odczytuj zwrócone bloki tool_use, wykonuj dozwoloną operację w swojej aplikacji i wysyłaj pasujące bloki tool_result w kolejnej wiadomości użytkownika. Zachowaj pełną odpowiedź asystenta przed odesłaniem tych wyników.
Zacznij od narzędzia tylko-do-odczytu, np. wyszukania rekordu. Waliduj jego argumenty i traktuj tool_use jako kontynuację zadania. Samo wygenerowanie wywołania narzędzia przez model nie wykonuje Twojego kodu aplikacji.
How Much Does Claude Fable 5.2 API Cost?
Publikowane stawki CometAPI są o 20% niższe niż standardowe stawki Anthropic we wszystkich pięciu kategoriach tokenów poniżej. Ceny w USD za milion tokenów; porównuj tę samą kategorię na każdej ścieżce, gdy szacujesz obciążenie.
Stawka za 1M tokenów
Anthropic direct API
Stawka wyświetlana przez CometAPI
Standard input
8 USD
6,4 USD
Standard output
40 USD
32 USD
Cache write, TTL 5 minut
10 USD
8 USD
Cache write, TTL 1 godzina
16 USD
12,8 USD
Cache read
0,20 USD
0,16 USD
Stawki sprawdzono 10 listopada 2026 r. To porównanie używa opublikowanych standardowych stawek API, przed ewentualnymi umowami specyficznymi dla kont i dodatkowymi opłatami za narzędzia.
An uncached request estimate
Dla 100 000 tokenów wejściowych i 10 000 tokenów wyjściowych bez keszowania CometAPI kosztuje szacunkowo (0,1 x 6,40 USD) + (0,01 x 32 USD) = 0,96 USD. To samo użycie tokenów przy standardowych stawkach Anthropic kosztuje (0,1 x 8 USD) + (0,01 x 40 USD) = 1,20 USD. Oszczędzasz 0,24 USD na żądanie, czyli 20%, przed dodatkowymi opłatami narzędzi.
Przy 1000 żądań z takim użyciem tokenów szacunkowe wydatki na tokeny spadają z 1200 USD do 960 USD, pozostawiając 240 USD na dodatkowe uruchomienia lub inne obciążenia modelu. Dla budżetu produkcyjnego używaj rzeczywiście zafakturowanych liczb tokenów i uwzględnij ponowienia, operacje cache oraz oddzielnie rozliczane narzędzia.
Przewodnik CometAPI po fallbacku modelu i dostawcy to przydatny kolejny krok: kompatybilny model zapasowy może używać tego samego klucza CometAPI i base URL, z oddzielnie skonfigurowaną ścieżką oficjalną, jeśli jest potrzebna. Twoja aplikacja musi zaimplementować politykę; same identyfikatory modeli nie normalizują formatów treści ani nie gwarantują udanego odzyskania.
Limitations of Claude Fable 5.2
Pomimo zaawansowanych możliwości Fable 5.2 ma kilka praktycznych ograniczeń:
Wyższe koszty tokenów: przy 8 USD za milion tokenów wejściowych i 40 USD za milion tokenów wyjściowych jest znacząco droższy niż Opus 5.5.
Umiarkowane opóźnienia: zaawansowane rozumowanie i zdolności długiego horyzontu nie czynią go najlepszym wyborem dla aplikacji wrażliwych na latencję.
Adaptacyjne rozumowanie nie może być wyłączone: deweloperzy muszą zarządzać głębokością rozumowania przez ustawienia effort.
Ograniczenia w cyberbezpieczeństwie i biologii: Fable zawiera klasyfikatory bezpieczeństwa blokujące niektóre wysokiego ryzyka żądania z obszaru cyberbezpieczeństwa i badań biologicznych.
Ograniczenia parametrów API: wymuszenie wyboru narzędzia przy użyciu tool_choice typów any i tool zwraca błąd 400. Parametry próbkowania, takie jak temperature, top_p i top_k, powinny być pominięte.
Wymogi retencji danych: dokumentacja modelu Anthropic określa 30-dniową retencję danych dla Fable 5.2, chyba że udzielono wyraźnego wyjątku.
Common setup checks
Objaw
Pierwsze działanie
401 lub 403
Sprawdź, czy klucz należy do wybranego endpointu i ma dostęp do modelu.
Nieznany model lub 404
Sprawdź base URL i dokładny identyfikator modelu.
400 invalid request
Sprawdź treść błędu pod kątem niewspieranych pól lub nieprawidłowo zachowanego prefiksu.
stop reason max_tokens
Przejrzyj częściową odpowiedź i budżet wyjścia przed uruchomieniem kolejnego żądania.
W przypadku nieoczekiwanej awarii zanotuj czas, identyfikator modelu, status i identyfikator żądania, jeśli jest dostępny. Nie umieszczaj kluczy API ani wrażliwych promptów w rutynowych logach.
FAQ
How do I get access to the Claude Fable 5.2 API?
Wybierz bezpośredni dostęp Anthropic lub CometAPI, utwórz klucz API u tego dostawcy i skonfiguruj rozliczenia lub saldo. Wyślij pierwsze żądanie Messages z modelem claude-fable-5-2. Użyte w tym przewodniku endpointy to https://api.anthropic.com/v1/messages i https://api.cometapi.com/v1/messages. Użyj klucza wydanego przez dostawcę, do którego dzwonisz; klucze nie są wymienne. Postępuj zgodnie z sekcją konfiguracji powyżej i dokumentacją Messages CometAPI dla trasy przez gateway.
How much does the Claude Fable 5.2 API cost?
Standardowe ceny Anthropic to 8 USD za milion tokenów wejściowych i 40 USD za milion tokenów wyjściowych. CometAPI podaje odpowiednio 6,40 USD i 32 USD (sprawdzone 11 listopada 2026 r.). Przy tych stawkach 100 000 tokenów wejściowych plus 10 000 tokenów wyjściowych kosztuje 1,20 USD bezpośrednio lub 0,96 USD przez CometAPI, bez keszowania ani dodatkowych opłat. Operacje cache i tryby opcjonalne mają oddzielne stawki.
Can I use the Anthropic Python SDK with CometAPI?
Tak. CometAPI dokumentuje kompatybilny z Anthropic endpoint Messages. Skonfiguruj klienta Anthropic z kluczem CometAPI i base_url="https://api.cometapi.com", a następnie użyj client.messages.create. Base URL SDK w tym przewodniku nie ma sufiksu /v1. Zachowaj identyfikator modelu claude-fable-5-2 i weryfikuj każdą funkcję opcjonalną na wybranej trasie, zanim na niej polegniesz.
Can I disable thinking in the Claude Fable 5.2 API?
Nie. Fable 5.2 używa zawsze włączonego adaptacyjnego rozumowania. Kontroluj głębokość rozumowania przez output_config.effort; domyślna wartość API to high. Nie wysyłaj wyłączonego thinking ani ręcznej konfiguracji budget_tokens. Przewodnik migracji wyjaśnia wspierane ustawienia. Przetestuj niższy effort na reprezentatywnych zadaniach, jeśli chcesz zredukować koszt rozumowania lub latencję.
Does Claude Fable 5.2 support image input and a 1M-token context window?
Tak. Specyfikacja modelu obejmuje wejście tekstowe i obrazowe, wyjście tekstowe, 1M-tokenowe okno kontekstu i do 128K tokenów wyjścia. Wejście obrazu pozwala analizować istniejący obraz; nie czyni modelu generatorem obrazów. Przed wysyłką dużych ładunków potwierdź limity rozmiaru żądania na wybranej trasie.
Can I migrate from Fable 5.1 by changing only the model ID?
Proste, świeże żądanie tekstowe może wymagać jedynie zmiany modelu, ale integracja produkcyjna wymaga szerszych kontroli. Oficjalny przewodnik migracji wskazuje zmiany w walidacji prefiksu konwersacji, kompatybilności bloków rozumowania, computer use i wyborze advisor. Postępuj według sekcji migracji powyżej, zwłaszcza jeśli Twoja aplikacja edytuje historię, przełącza modele w trakcie rozmowy lub używa tych narzędzi.
Why does my Claude Fable 5.2 API request return a 400 error?
Najpierw przeczytaj komunikat błędu w odpowiedzi. Powszechne przyczyny to niewspierane ustawienia thinking, prefille asystenta, wymuszony wybór narzędzi lub odtwarzanie bloków rozumowania po zmianie poprzedzającej konwersacji. Przewodnik migracji Anthropic opisuje te ograniczenia. Odtwórz problem świeżym minimalnym żądaniem, a następnie stopniowo dodawaj swoje opcje i historię. Ponawianie tego samego nieprawidłowego żądania nie rozwiąże problemu.
How should I handle Claude Fable 5.2 API rate limits?
Zredukuj współbieżność i stosuj Retry-After, gdy gateway go zwraca. Konfiguracja retry w Python SDK pozwala ograniczyć automatyczne ponowienia; SDK już ponawia wybrane przejściowe błędy, w tym odpowiedzi 429. Unikaj nakładania nieograniczonej pętli ponowień aplikacji na wierzch. Jeśli błędy się utrzymują, sprawdź limit konta i saldo dla wybranej ścieżki zamiast zwiększać liczbę ponowień.
Conclusion
Wybierz ścieżkę, zapisz jej konfigurację klienta i uruchamiaj przykład tekstowy, aż będziesz w stanie wyjaśnić zwrócony stop reason i usage. Następnie weryfikuj po jednej dodatkowej funkcji naraz, używając wejść, które Twoje produkty faktycznie otrzymają.
Uruchom małego pilota produkcyjnego przez CometAPI i porównaj zarejestrowane opłaty tokenowe z powyższym oszacowaniem. Jeśli Twój roadmap obejmuje innych dostawców, dodaj drugi model, aby przetestować współdzielony dostęp i przepływ rozliczeń. Zachowaj bezpośredni dostęp Anthropic, gdy wymagana jest natywna funkcja, i rozwijaj tę konfigurację, która spełnia Twoje cele jakościowe i budżetowe.