Skip to main content
POST
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.
Alan tanımları ve modele özgü seçenekler için resmi Messages API referansına bakın. OpenAI uyumlu istekler için bkz. Chat Completions.
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:
Yanıt bir 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:
Düşünme, 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-8 reference.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.:
İsteği aynı model, referans metni ve düşünme ayarlarıyla yeniden çalıştırın. İsteğin bir öneki yeniden kullanıp kullanmadığını belirlemek için kullanım sayaçlarını inceleyin:
  • cache_creation_input_tokens önbelleğe yazılan token’ları sayar.
  • cache_read_input_tokens önbellekten okunan token’ları sayar.
  • input_tokens bu önbellek sayaçlarının dışında işlenen giriş token’larını sayar.
Yinelenen isteklerde 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çin stream: true ayarlayın. SDK, metin parçalarını ulaştıkça sunar :
Bir mesaj akışı 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çin output_config.effort ayarlayın. Bu örnekte low kısa bir açıklama için kullanılır ve tamamlanmış akış mesajı beklenir:
Resmî çaba başvurusunu bir çaba düzeyi seçmek için kullanın. Çıktı uzunluğunu sınırlamak için 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.
Bir makaleyi getirin ve Claude’dan alınan belgeyi yanıtında kullanmasını isteyin. Bu örnek, yanıtı Streaming ile alır ve hem son metni hem de web_fetch_tool_result bloğunu inceler:
Yanıt, bir 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:
Durdurma nedeni sonraki eylemi açıklar. 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

x-api-key
string
header
gerekli

Your CometAPI key passed via the x-api-key header. Authorization: Bearer $COMETAPI_KEY is also supported.

Başlıklar

anthropic-version
string
varsayılan:2023-06-01

The Anthropic API version to use. Defaults to 2023-06-01.

Örnek:

"2023-06-01"

anthropic-beta
string

Comma-separated feature identifiers required by a specific beta API feature. Omit this header for the examples on this page.

Gövde

application/json
model
string
varsayılan:claude-opus-5
gerekli

The Claude model to use. See the Models page for available Claude model IDs.

Örnek:

"claude-opus-5"

messages
object[]
gerekli

Conversation history. Use user and assistant messages with text strings or content-block arrays. Return complete assistant content blocks when continuing a tool call.

max_tokens
integer
gerekli

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.

Gerekli aralık: x >= 1
Örnek:

1024

system

System prompt providing context and instructions to Claude. Can be a plain string or an array of content blocks (useful for prompt caching).

temperature
number

Sampling temperature. The examples omit sampling overrides.

Gerekli aralık: 0 <= x <= 1
top_p
number

Nucleus sampling threshold. The examples omit sampling overrides.

Gerekli aralık: 0 <= x <= 1
top_k
integer

Limits sampling to the k most likely tokens. The examples omit sampling overrides.

Gerekli aralık: x >= 0
stream
boolean
varsayılan:false

If 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.

stop_sequences
string[]

Custom strings that cause the model to stop generating when encountered. The stop sequence is not included in the response.

thinking
object

Thinking configuration. The adaptive example uses type adaptive and sets output_config.effort separately.

tools
object[]

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.

tool_choice
object

Controls how the model uses tools.

metadata
object

Request metadata for tracking and analytics.

output_config
object

Configuration for reasoning effort and structured output.

service_tier
enum<string>

The service tier to use. auto tries priority capacity first, standard_only uses only standard capacity.

Mevcut seçenekler:
auto,
standard_only

Yanıt

Successful response. When stream is true, the response is a stream of SSE events.

id
string

Message identifier returned by the API.

type
enum<string>

Always message.

Mevcut seçenekler:
message
role
enum<string>

Always assistant.

Mevcut seçenekler:
assistant
content
object[]

The response content blocks. May include text, thinking, tool_use, and other block types.

model
string

Model ID reported by the response.

stop_reason
enum<string>

Why the model stopped generating. refusal can be returned as a successful HTTP response when the model declines a request.

Mevcut seçenekler:
end_turn,
max_tokens,
stop_sequence,
tool_use,
pause_turn,
refusal
stop_sequence
string | null

The stop sequence that caused the model to stop, if applicable.

usage
object

Token usage statistics.

Son değiştirilme tarihi 8 Eylül 2026