Messages API، ابزارها، بینایی، استریم SSE، کش کردن پرامپت

Claude API by Anthropic - پیام‌ها، ابزارها، بینایی، استریمینگ

از Messages API برای ارسال لیست‌های پیام ساختاریافته با بلوک‌های متنی و تصویری، استریم پاسخ‌ها از طریق SSE و اتصال ابزارها برای جریان‌های کاری قابل اعتماد استفاده کنید.

انتخاب یک مدل Claude

مدلی را انتخاب کنید که با نیازهای شما از نظر تأخیر، هزینه و استدلال مطابقت دارد.

Claude Sonnet 4.5

عملکرد و هزینه متعادل برای چت عمومی، تحلیل و جریان‌های کاری محتوا.

مشاهده جزئیات مدل

Claude Opus 4.1

نسخه پایدار برای وظایف استدلال پیچیده و موارد استفاده در سطح تولید.

مشاهده جزئیات مدل

Claude Opus 4.5

قوی‌ترین قابلیت‌ها برای تحلیل عمیق، برنامه‌ ریزی و جریان‌های کاری چندمرحله‌ای.

مشاهده جزئیات مدل

دموی آنلاین (Qwen)

این دمو فقط جریان کاری پیام‌ها را نشان می‌دهد و از مدل‌های Claude استفاده نمی‌کند.

توجه: دموی زیر برای نمایش جریان تعامل است. برای تولید (Production)، لطفاً یک مدل Claude انتخاب کنید و Claude API را فراخوانی کنید.

انتخاب مدل Claude

در حال بارگذاری دمو...

Claude API چیست؟

Claude API پلتفرم توسعه‌دهندگان Anthropic برای ساخت با مدل‌های Claude از طریق Messages API است که از پرامپت‌های ساختاریافته، ورودی چندوجهی و استفاده از ابزار پشتیبانی می‌کند.

Messages API

یک آرایه از پیام‌ها را به /v1/messages با یک مدل و max_tokens ارسال کنید. API بدون وضعیت (stateless) است، بنابراین تاریخچه کامل مکالمه را برای برنامه‌های چند نوبته (multi-turn) شامل کنید.

بینایی و ورودی چندوجهی

بلوک‌های متنی و تصویری را با هم شامل کنید. تصاویر از منابع base64 یا URL و انواع image/jpeg، image/png، image/gif و image/webp پشتیبانی می‌کنند.

پاسخ‌های جریانی (SSE)

stream: true را تنظیم کنید تا رویدادهای ارسال شده توسط سرور را دریافت کرده و پاسخ‌ها را به صورت افزایشی رندر کنید.

استفاده از ابزار با JSON Schema

ابزارها را در پارامتر tools با نام، توضیحات و input_schema (JSON Schema) تعریف کنید تا Claude بتواند توابع شما را فراخوانی کند.

چرا Claude API را انتخاب کنیم؟

پریمیتیوهای مدرن API طراحی شده برای برنامه‌های تولید قابل اعتماد و جریان‌های کاری عامل.

مکالمات بدون وضعیت، قابل تکرار

پیام‌ها بدون وضعیت هستند. تاریخچه کامل را در هر نوبت ارسال کنید تا جریان‌های کاری چندمرحله‌ای قطعی و اشکال‌زدایی آن‌ها آسان باشد.

کش کردن پرامپت برای استفاده مجدد

cache_control را اضافه کنید تا از پیشوندهای پرامپت استفاده مجدد کنید. طول عمر پیش‌فرض کش ۵ دقیقه است با یک کش اختیاری ۱ ساعته برای پرامپت‌های طولانی و تکراری.

استریم SSE برای UX بلادرنگ

خروجی را از طریق SSE برای تجربیات چت و دستیار با خروجی افزایشی استریم کنید.

اتوماسیون آماده ابزار

ابزارها را با ورودی JSON Schema تعریف کنید و اجازه دهید Claude در صورت نیاز آن‌ها را فراخوانی کند.

راهنمای شروع سریع

از کلید API تا اولین درخواست Messages شما در چند دقیقه.

  • ایجاد یک کلید API

    یک کلید API در کنسول ایجاد کنید و آن را به صورت امن ذخیره کنید.

  • فراخوانی /v1/messages

    یک درخواست POST با مدل، max_tokens و آرایه پیام ارسال کنید. تاریخچه کامل را برای مکالمات چند نوبته شامل کنید.

  • افزودن استریمینگ، ابزارها و تصاویر

    stream: true را برای SSE فعال کنید، ابزارها را با JSON Schema تعریف کنید و بلوک‌های تصویر (base64 یا URL) را در صورت نیاز شامل کنید.

curl --request POST \
  --url https://api.evolink.ai/v1/messages \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "claude-sonnet-4-5-20250929",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello, world" }
    ]
  }'

سوالات متداول

آماده شروع با Claude API هستید؟

مدل مناسب را انتخاب کنید، کلید API خود را دریافت کنید و اولین درخواست Messages خود را همین امروز ارسال کنید.

انتخاب یک مدل