Mesaj oluşturma
Claude’u metin ve görüntü girdisi, uyarlanabilir düşünme, prompt önbelleğe alma, Streaming ve araçlarla CometAPI Messages uç noktası üzerinden çağırın.
POST /v1/messages kullanarak Claude isteklerini Anthropic Messages formatında gönderin.
Örnekler, resmi Anthropic SDK’yi CometAPI temel URL’siyle yapılandırır ve
API anahtarınızı $COMETAPI_KEY üzerinden okur.
x-api-key veya Authorization: Bearer ile kimlik doğrulaması yapın. Anthropic SDK şu anahtarı kullanır:
x-api-key. HTTP örnekleri anthropic-version: 2023-06-01 içerir.Hızlı başlangıç
Aşağıdaki örnekler üç arama sorgusu ister.$COMETAPI_KEY değerini ayarlayın, ardından
bunları çalıştırın. Python için anthropic veya JavaScript için @anthropic-ai/sdk yükleyin:
content dizisi içerir. type değeri text olan blokları okuyun;
düşünme ve araç blokları metinden önce görünebilir.
Uyarlanabilir düşünmeyi denetleme
thinking.type değerini adaptive olarak ayarlayın ve bir output_config.effort değeri seçin.
Aşağıdaki örnek xhigh kullanır ve tamamlanan iletiyi bir akıştan okur:
max_tokens çıktı sınırına katkıda bulunur. Nihai
yanıtın yanı sıra düşünme için de yer bırakın. Bir yanıt, görünür bir
düşünme bloğu olmadan metin içerebilir. Döndürülen tüm düşünme bloklarını sohbet
geçmişinde değiştirmeden koruyun.
Modele özgü düşünme yapılandırması için
Düşünme bölümüne bakın..
Örneklerde temperature, top_p ve top_k kullanılmamıştır; örnekleme denetimleri eklemeden önce seçilen
modelin parametre belgelerine başvurun.
Prompt’ları önbelleğe alma
İstekler arasında yeniden kullandığınız referans materyaline bir önbellek kesme noktası yerleştirin. Referans materyalinizi UTF-8reference.txt dosyasına bu
örneği çalıştırmadan önce kaydedin. Seçilen modelin
önbelleğe alınabilir minimum uzunluğunu karşılayan bir önek kullanın.:
cache_creation_input_tokensönbelleğe yazılan token’ları sayar.cache_read_input_tokensönbellekten okunan token’ları sayar.input_tokensbu önbellek sayaçlarının dışında işlenen giriş token’larını sayar.
cache_read_input_tokens, kaç giriş token’ının
önbellekten okunduğunu bildirir. OpenAPI Prompt Cache
örneği, eksiksiz bir kurgusal referans içerir; bunu
reference.txt olarak kaydederek örneği deneyebilirsiniz.
Yanıtları akış olarak iletin
Server-Sent Events içinstream: true ayarlayın. SDK, metin parçalarını ulaştıkça sunar
:
message_start, içerik bloğu etkinlikleri, message_delta,
ve message_stop içerir. İçerik blokları metin, düşünme veya araç etkinliği içerebilir.
Bir metin bloğu için content_block_delta, bir text_delta içerir. Nihai kullanım bilgilerini okuyun
ve durma nedenini message_delta öğesinden okuyun.
Çaba denetimi
Akıl yürütme miktarını yönlendirmek içinoutput_config.effort ayarlayın. Bu örnekte
low kısa bir açıklama için kullanılır ve tamamlanmış akış mesajı beklenir:
max_tokens öğesini ayrı olarak ayarlayın.
Sunucu araçlarını kullanın
Sunucu araçları API isteği sırasında çalışır ve sonuç bloklarını Claude’un yanıtıyla birlikte döndürür.- Web Fetch
- Web Search
web_fetch_tool_result bloğunu inceler:server_tool_use bloğunu bir web_fetch_tool_result bloğuyla eşleştirir.
Bu blok, getirilen belgeyi veya bir araç hatasını içerir.İstemci aracı sonuçlarını döndürme
Bir istemci aracı için Claude,tool_use bloğu döndürür. Uygulama işlevinizi çalıştırın
ve sonucunu bir tool_result bloğunda, eşleşen tool_use_id ile gönderin.
İki istek arasındaki asistan içeriğinin tamamını koruyun.
Bu örnek, kurgusal bir sipariş sonucu sağlar ve Claude’dan bu sonucu kullanmasını ister:
Yanıt örneği
Streaming olmayan bir istek bir mesaj nesnesi döndürür. Aşağıdaki örnek bunun açıklayıcı bir mesaj tanımlayıcısıyla metin ve kullanım alanlarını gösterir:end_turn yanıtı tamamlar,
max_tokens çıktının sınıra ulaştığı anlamına gelir ve tool_use bir istemci aracı
sonucu ister. pause_turn döndüren bir sunucu aracı turunda,
döndürülen asistan içeriğiyle değişiklik yapmadan devam edin.Yetkilendirmeler
Your CometAPI key passed via the x-api-key header. Authorization: Bearer $COMETAPI_KEY is also supported.
Başlıklar
The Anthropic API version to use. Defaults to 2023-06-01.
"2023-06-01"
Comma-separated feature identifiers required by a specific beta API feature. Omit this header for the examples on this page.
Gövde
The Claude model to use. See the Models page for available Claude model IDs.
"claude-opus-5"
Conversation history. Use user and assistant messages with text strings or content-block arrays. Return complete assistant content blocks when continuing a tool call.
The maximum number of tokens to generate. The model may stop before reaching this limit. When using thinking, the thinking tokens count towards this limit.
x >= 11024
System prompt providing context and instructions to Claude. Can be a plain string or an array of content blocks (useful for prompt caching).
Sampling temperature. The examples omit sampling overrides.
0 <= x <= 1Nucleus sampling threshold. The examples omit sampling overrides.
0 <= x <= 1Limits sampling to the k most likely tokens. The examples omit sampling overrides.
x >= 0If true, stream the response incrementally using Server-Sent Events (SSE). Events include message_start, content_block_start, content_block_delta, content_block_stop, message_delta, and message_stop.
Custom strings that cause the model to stop generating when encountered. The stop sequence is not included in the response.
Thinking configuration. The adaptive example uses type adaptive and sets output_config.effort separately.
Client tools define a name and input_schema. Server tools use a versioned type and name, such as the web_fetch and web_search examples on this page.
Controls how the model uses tools.
Request metadata for tracking and analytics.
Configuration for reasoning effort and structured output.
The service tier to use. auto tries priority capacity first, standard_only uses only standard capacity.
auto, standard_only Yanıt
Successful response. When stream is true, the response is a stream of SSE events.
Message identifier returned by the API.
Always message.
message Always assistant.
assistant The response content blocks. May include text, thinking, tool_use, and other block types.
Model ID reported by the response.
Why the model stopped generating. refusal can be returned as a successful HTTP response when the model declines a request.
end_turn, max_tokens, stop_sequence, tool_use, pause_turn, refusal The stop sequence that caused the model to stop, if applicable.
Token usage statistics.