پرش به محتوای اصلی
داتهوشورودشروع رایگان
یکپارچه‌سازی

اتصال Anthropic SDK به دات‌هوش

هر راهنما چند گام کوتاه دارد: کلید، آدرس پایه، شناسه مدل.

Anthropic SDK

Messages API
حدود ۱ دقیقهپروتکل Anthropic۳ گام

پیش‌نیاز: یک کلید API و موجودی کیف پول.

ساخت کلید

  1. کلید را در محیط بگذارید

    کلید را هرگز در کد ننویسید.

    terminal
    export DOTHOOSH_API_KEY="dh_live_…"

  2. آدرس پایه Anthropic

    برای SDK رسمی Anthropic از مسیر /anthropic استفاده کنید.

    app.py
    import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://gateway.dothoosh.com/anthropic",
    api_key=os.environ["DOTHOOSH_API_KEY"],
)

  3. شناسه مدل را بنویسید

    شناسه باید مدلی باشد که پروتکل Anthropic Messages برایش در کاتالوگ مدل‌ها آمده است.

    app.py
    msg = client.messages.create(
    model="claude-fable-5-1",
    max_tokens=1024,
    messages=[{"role": "user", "content": "سلام"}],
)
print(msg.content[0].text)

کار نکرد؟

401 · api_key_invalid

کلید اشتباه کپی شده، لغو شده یا غیرفعال است. کلید را دوباره از متغیر محیطی بخوانید و وضعیتش را در کنسول بررسی کنید.

400 · insufficient_available_balance

موجودی کیف پول کافی نیست. کیف پول را شارژ کنید؛ بدهی ایجاد نمی‌شود.

404 · model_not_found

شناسه مدل را از کاتالوگ مدل‌ها کپی کنید؛ شناسه‌ها پیشوند ارائه‌دهنده ندارند.

429 · api_key_rpm_exceeded

از سقف درخواست در دقیقه کلید عبور کرده‌اید. محدودیت‌های کلید بعد از ساخت ویرایش نمی‌شوند؛ برای سقف بالاتر، کلید تازه با RPM بالاتر بسازید.

401 · api_key_malformed

کلید در سرآیند Authorization رفته است، اما مسیر Anthropic فقط x-api-key را می‌پذیرد. کلید را با ANTHROPIC_API_KEY (یا api_key در SDK) بدهید.

400 · unsupported_capability

مدل انتخابی پروتکل Anthropic Messages ندارد. از کاتالوگ مدلی را بردارید که این پروتکل برایش آمده، یا از مسیر OpenAI استفاده کنید.