Ana içeriğe atla

​
Genel Bakış

AI Sonar, doğal Anthropic Messages API yolunu destekler; böylece Claude modelleri için resmi Anthropic SDK’yı doğrudan kullanabilirsiniz.
Anthropic SDK için base URL olarak https://api.aisonar.dev kullanın; /v1 ekini kendiniz eklemeyin.
Tür: Native SDKBirincil yol: Anthropic-nativeDestek seviyesi: Güçlü native path
Belgelenen SDK yolları arasında bu, Claude yerel özellikleri için en güçlü şekilde desteklenen AI Sonar yollarından biridir.

​
Kurulum

pip install anthropic

​
Client’ı Yapılandırın

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-your-api-key",
    base_url="https://api.aisonar.dev",
)

​
Temel Kullanım

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Explain AI Sonar in one sentence."}
    ]
)

print(message.content[0].text)

​
Streaming

with client.messages.stream(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Write a short poem about coding."}]
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

​
Vision

import base64

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "What's in this image?"},
            {
                "type": "image",
                "source": {
                    "type": "url",
                    "url": "https://example.com/image.jpg"
                }
            }
        ]
    }]
)

with open("image.png", "rb") as f:
    image_data = base64.b64encode(f.read()).decode()

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "Describe this image"},
            {
                "type": "image",
                "source": {
                    "type": "base64",
                    "media_type": "image/png",
                    "data": image_data
                }
            }
        ]
    }]
)

​
Tool Kullanımı

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    tools=[{
        "name": "get_weather",
        "description": "Get the weather for a location",
        "input_schema": {
            "type": "object",
            "properties": {
                "location": {"type": "string"}
            },
            "required": ["location"]
        }
    }],
    messages=[{"role": "user", "content": "What's the weather in Tokyo?"}]
)

for block in message.content:
    if block.type == "tool_use":
        print(block.name)
        print(block.input)

​
Genişletilmiş Düşünme

message = client.messages.create(
    model="claude-opus-4-6",
    max_tokens=16000,
    thinking={
        "type": "enabled",
        "budget_tokens": 10000
    },
    messages=[{"role": "user", "content": "Solve this complex problem step by step."}]
)

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

​
Önerilen Claude Modelleri

ModelEn Uygun Olduğu Alan
claude-opus-4-6Derin muhakeme, uzun biçimli analiz
claude-sonnet-4-6Kodlama, genel asistan görevleri
claude-haiku-4-5Hızlı, hafif yanıtlar

​
Sorun Giderme

  • https://api.aisonar.dev kullanın
  • Anthropic SDK’yı yapılandırırken /v1 ekini manuel olarak eklemeyin
  • AI Sonar API anahtarınızın sk- ile başladığını kontrol edin
  • Anahtarın AI Sonar dashboard içinde aktif olduğunu doğrulayın
  • Özel header’ları manuel olarak eklemek yerine auth header’ını Anthropic SDK’nın yönetmesine izin verin
  • Claude model adını tam olarak doğrulayın
  • AI Sonar model kataloğundaki güncel kullanılabilirliği kontrol edin