Bir Message oluştur

POST

messages

import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://api.cometapi.com",
    api_key=os.environ["COMETAPI_KEY"],
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    system="You are a helpful assistant.",
    messages=[
        {"role": "user", "content": "Hello, world"}
    ],
)

print(message.content[0].text)

{
  "id": "<string>",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "text": "<string>",
      "thinking": "<string>",
      "signature": "<string>",
      "id": "<string>",
      "name": "<string>",
      "input": {}
    }
  ],
  "model": "<string>",
  "stop_sequence": "<string>",
  "usage": {
    "input_tokens": 123,
    "output_tokens": 123,
    "cache_creation_input_tokens": 123,
    "cache_read_input_tokens": 123,
    "cache_creation": {
      "ephemeral_5m_input_tokens": 123,
      "ephemeral_1h_input_tokens": 123
    },
    "output_tokens_details": {
      "thinking_tokens": 123
    }
  }
}

CometAPI, Anthropic Messages API’yi yerel olarak destekler ve size Anthropic’e özgü özelliklerle Claude modellerine doğrudan erişim sağlar. Adaptif düşünme, prompt caching ve effort control gibi Claude yetenekleri için bu endpoint’i kullanın.

Tam parametre listesi, yanıt şeması ve Claude’a özgü davranışlar için yetkili kaynak olarak resmi Anthropic Messages API referansını kullanın. Bu CometAPI sayfası, bu istek biçiminin CometAPI üzerinden nasıl gönderileceğini açıklar.

Claude özellikleri geliştikçe Anthropic istek parametreleri ve yanıt alanları değişebilir. En güncel ve eksiksiz parametre listesi ile sağlayıcıya özgü davranışlar için Anthropic Messages API documentation sayfasını kontrol edin.

Birçok yeni Claude modeli, Messages API’de varsayılan olmayan temperature, top_p ve top_k değerlerini reddeder. Seçilen model için desteği doğrulamadığınız sürece bu örnekleme alanlarını kullanmayın. Bir model desteklenmeyen veya kullanımdan kaldırılmış parametre hatası döndürürse, alanı isteğinizden kaldırın.

Kimlik doğrulama için hem x-api-key hem de Authorization: Bearer header’ları desteklenir. Resmi Anthropic SDK’leri varsayılan olarak x-api-key kullanır.

Hızlı başlangıç

Resmi Anthropic SDK’yi CometAPI ile kullanmak için base URL’i ayarlayın:

import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://api.cometapi.com",
    api_key=os.environ["COMETAPI_KEY"],
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content[0].text)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
    apiKey: process.env.COMETAPI_KEY,
    baseURL: "https://api.cometapi.com",
});

const message = await client.messages.create({
    model: "claude-sonnet-5",
    max_tokens: 1024,
    messages: [{ role: "user", content: "Hello!" }],
});
console.log(message.content[0].text);

Adaptif düşünmeyi kontrol edin

Claude’un bir yanıta ne kadar çalışma uygulayacağını kontrol etmek için output_config.effort ile adaptif düşünmeyi kullanın. Daha yeni Claude modelleri, eski manuel düşünme biçimi olan thinking={"type": "enabled", "budget_tokens": ...} yapısını reddeder.

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=4096,
    thinking={"type": "adaptive"},
    output_config={"effort": "xhigh"},
    messages=[
        {
            "role": "user",
            "content": "Analyze the trade-offs between a monolithic architecture and microservices for a small engineering team.",
        }
    ],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

Thinking token’ları max_tokens sınırınıza dahil edilir. Daha yüksek effort düzeyleri kullandığınızda hem düşünme hem de nihai yanıt için max_tokens değerini yeterince yüksek ayarlayın.

Prompt’ları önbelleğe alma

Sonraki isteklerde gecikmeyi ve maliyeti azaltmak için büyük system prompt’larını veya konuşma öneklerini önbelleğe alın. Önbelleğe alınması gereken content bloklarına cache_control ekleyin:

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    system=[
        {
            "type": "text",
            "text": "You are an expert code reviewer. [Long detailed instructions...]",
            "cache_control": {"type": "ephemeral"},
        }
    ],
    messages=[{"role": "user", "content": "Review this code..."}],
)

Önbellek kullanımı, yanıttaki usage alanında raporlanır:

cache_creation_input_tokens — önbelleğe yazılan tokens (daha yüksek bir ücretlendirme oranıyla faturalandırılır)
cache_read_input_tokens — önbellekten okunan tokens (indirimli bir ücretlendirme oranıyla faturalandırılır)

Prompt caching, önbelleğe alınan content bloğunda en az 1,024 tokens gerektirir. Bundan daha kısa içerik önbelleğe alınmaz.

Yanıtları stream etme

Server-Sent Events (SSE) kullanarak yanıtları stream etmek için stream: true ayarlayın. Olaylar şu sırayla gelir:

message_start — mesaj meta verilerini ve ilk kullanım bilgisini içerir
content_block_start — her bir content bloğunun başlangıcını işaretler
content_block_delta — artımlı metin parçaları (text_delta)
content_block_stop — her bir content bloğunun sonunu işaretler
message_delta — nihai stop_reason ve tam usage
message_stop — stream’in sonunu bildirir

with client.messages.stream(
    model="claude-sonnet-5",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="")

Çabayı kontrol etme

Claude’un bir yanıt oluştururken ne kadar çaba harcayacağını kontrol etmek için output_config.effort kullanın:

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=4096,
    messages=[
        {"role": "user", "content": "Summarize this briefly."}
    ],
    output_config={"effort": "low"},  # "low", "medium", "high", "xhigh", or "max"
)

Sunucu araçlarını kullanma

Claude, Anthropic altyapısında çalışan sunucu tarafı araçları destekler:

Web Fetch
Web Search

URL’lerden içerik getirip analiz edin:

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Analyze the content at https://arxiv.org/abs/1512.03385"}
    ],
    tools=[
        {"type": "web_fetch_20250910", "name": "web_fetch", "max_uses": 5}
    ],
)

Gerçek zamanlı bilgi için web’de arama yapın:

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "What are the latest developments in AI?"}
    ],
    tools=[
        {"type": "web_search_20250305", "name": "web_search", "max_uses": 5}
    ],
)

Yanıt örneği

CometAPI’nin Anthropic endpoint’inden tipik bir yanıt:

{
  "id": "msg_bdrk_01UjHdmSztrL7QYYm7CKBDFB",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello!"
    }
  ],
  "model": "claude-sonnet-5",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 19,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "cache_creation": {
      "ephemeral_5m_input_tokens": 0,
      "ephemeral_1h_input_tokens": 0
    },
    "output_tokens": 4
  }
}

OpenAI-compatible endpoint ile karşılaştırma

Özellik	Anthropic Messages (`/v1/messages`)	OpenAI-Compatible (`/v1/chat/completions`)
Uyarlanabilir düşünme	`type: "adaptive"` ve `output_config.effort` ile `thinking`	Kullanılamaz
Prompt önbellekleme	content bloklarında `cache_control`	Kullanılamaz
Efor kontrolü	`output_config.effort`	Kullanılamaz
Web getirme/arama	Sunucu araçları (`web_fetch`, `web_search`)	Kullanılamaz
Auth başlığı	`x-api-key` veya `Bearer`	Yalnızca `Bearer`
Yanıt biçimi	Anthropic biçimi (`content` blokları)	OpenAI biçimi (`choices`, `message`)
Modeller	Yalnızca Claude	Çoklu sağlayıcı (GPT, Claude, Gemini, vb.)

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 list of beta features to enable. Examples: max-tokens-3-5-sonnet-2024-07-15, pdfs-2024-09-25, output-128k-2025-02-19.

Gövde

application/json

model

string

gerekli

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

Örnek:

"claude-sonnet-5"

messages

object[]

gerekli

The conversation messages. Must alternate between user and assistant roles. Each message's content can be a string or an array of content blocks (text, image, document, tool_use, tool_result). There is a limit of 100,000 messages per request.

Show child attributes

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

varsayılan:1

Model-dependent sampling control. Many newer Claude models reject non-default temperature values on the Messages API. Omit this field unless you have verified that the selected model accepts it; if the model returns an unsupported or deprecated-parameter error, remove the field instead of substituting another sampling value.

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

Örnek:

1

top_p

number

Model-dependent nucleus sampling control. Many newer Claude models reject non-default top_p values on the Messages API. Omit this field unless you have verified support for the selected model. Do not set temperature and top_p together.

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

Örnek:

1

top_k

integer

Model-dependent top-k sampling control. Many newer Claude models reject non-default top_k values on the Messages API. Omit this field unless you have verified support for the selected model.

Gerekli aralık: x >= 0

Örnek:

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

Controls Claude thinking when the selected model supports a configurable thinking mode. For newer adaptive-thinking models, use {"type":"adaptive"} with output_config.effort, or omit thinking when adaptive thinking is already the model default. Manual {"type":"enabled","budget_tokens":...} is supported only by older models and is rejected by newer Claude models.

Show child attributes

tools

object[]

Tools the model may use. Supports client-defined functions, web search (web_search_20250305), web fetch (web_fetch_20250910), code execution (code_execution_20250522), and more.

Show child attributes

tool_choice

object

Controls how the model uses tools.

Show child attributes

metadata

object

Request metadata for tracking and analytics.

Show child attributes

output_config

object

Configuration for response effort and output format. Field support depends on the selected Claude model.

Show child attributes

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

200 - application/json

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

string

Unique identifier for this message (e.g., msg_01XFDUDYJgAACzvnptvVoYEL).

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.

Show child attributes

model

string

The specific model version that generated this response, such as claude-sonnet-5.

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.

Show child attributes

Model yanıtı oluşturma

İçerik oluştur

import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://api.cometapi.com",
    api_key=os.environ["COMETAPI_KEY"],
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    system="You are a helpful assistant.",
    messages=[
        {"role": "user", "content": "Hello, world"}
    ],
)

print(message.content[0].text)

{
  "id": "<string>",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "text": "<string>",
      "thinking": "<string>",
      "signature": "<string>",
      "id": "<string>",
      "name": "<string>",
      "input": {}
    }
  ],
  "model": "<string>",
  "stop_sequence": "<string>",
  "usage": {
    "input_tokens": 123,
    "output_tokens": 123,
    "cache_creation_input_tokens": 123,
    "cache_read_input_tokens": 123,
    "cache_creation": {
      "ephemeral_5m_input_tokens": 123,
      "ephemeral_1h_input_tokens": 123
    },
    "output_tokens_details": {
      "thinking_tokens": 123
    }
  }
}

İçerik moderasyonu

API anahtarları

Hızlı başlangıç

Adaptif düşünmeyi kontrol edin

Prompt’ları önbelleğe alma

Yanıtları stream etme

Çabayı kontrol etme

Sunucu araçlarını kullanma

Yanıt örneği

OpenAI-compatible endpoint ile karşılaştırma

Yetkilendirmeler

Başlıklar

Gövde

Yanıt

​Hızlı başlangıç

​Adaptif düşünmeyi kontrol edin

​Prompt’ları önbelleğe alma

​Yanıtları stream etme

​Çabayı kontrol etme

​Sunucu araçlarını kullanma

​Yanıt örneği

​OpenAI-compatible endpoint ile karşılaştırma

Yetkilendirmeler

Başlıklar

Gövde

Yanıt

Hızlı başlangıç

Adaptif düşünmeyi kontrol edin

Prompt’ları önbelleğe alma

Yanıtları stream etme

Çabayı kontrol etme

Sunucu araçlarını kullanma

Yanıt örneği

OpenAI-compatible endpoint ile karşılaştırma