۱۰۰ هزار تومان هدیهٔ ثبت‌نام، تا ۱ میلیونبا ثبت‌نام گردونهٔ هدیه را بچرخان: دست‌کم ۱۰۰٬۰۰۰ تومان و تا ۱٬۰۰۰٬۰۰۰ تومان اعتبار هدیه، بدون کارت بانکیگردونهٔ هدیه۱ میلیون برای تو، ۱ میلیون برای دوستتدوستانت را دعوت کن: برای هر دوستی که فعال شود ۱٬۰۰۰٬۰۰۰ تومان اعتبار هدیه می‌گیری و خودش هم ۱٬۰۰۰٬۰۰۰ تومانجوایز
1xAi
مستندات API

مسیر نیتیو Anthropic: Messages API، کش پرامپت و Claude Code

POST https://1xai.ir/anthropic/v1/messages بدنهٔ درخواست را همان‌طور که هست به Messages API رسمی Anthropic می‌فرستد. قابلیت‌هایی که لایهٔ سازگاری OpenAI ندارد این‌جا کار می‌کنند: کش پرامپت با cache_control، فکر گسترده و استنادها. کتابخانهٔ رسمی Anthropic و Claude Code با عوض کردن آدرس پایه و گذاشتن کلید 1xai-* وصل می‌شوند.

آخرین به‌روزرسانی:

فهرست مستندات

Anthropic (نیتیو) · ۱

Messages: POST /anthropic/v1/messages

POST /anthropic/v1/messages
curl
curl https://1xai.ir/anthropic/v1/messages \
  -H "x-api-key: 1xai-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "سلام"}]
  }'

کتابخانهٔ رسمی Anthropic

Python
from anthropic import Anthropic

client = Anthropic(
    base_url="https://1xai.ir/anthropic",
    api_key="1xai-...",
)

resp = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "سلام"}],
)
print(resp.content[0].text)
  • max_tokens الزامی است؛ بدون آن خطای 400 با کد invalid_request می‌گیری.
  • کلید در x-api-key یا Authorization: Bearer. هدرهای anthropic-version و anthropic-beta به Anthropic می‌رسند؛ اگر نسخه را نفرستی 2023-06-01 فرستاده می‌شود.
  • همین مسیر روی POST /v1/messages هم هست، پس کتابخانه‌ای که آدرس پایه‌اش روی ریشهٔ سایت است هم کار می‌کند.
  • پاسخ، از جمله بخش usage، همان پاسخ Anthropic است. فقط مدل‌های claude-*؛ مدل سازندهٔ دیگر خطای 400 می‌گیرد و پیام می‌گوید آن را روی /v1 صدا بزنی.
  • اگر Anthropic 429، 503 یا 529 بدهد، دروازه پیش از برگرداندن پاسخ تا ۳ بار تلاش می‌کند.

Anthropic (نیتیو) · ۲

کش پرامپت

cache_control روی یک بلوک system

curl
curl https://1xai.ir/anthropic/v1/messages \
  -H "x-api-key: 1xai-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "system": [{
      "type": "text",
      "text": "متن بلند راهنما که در همهٔ تماس‌ها تکرار می‌شود…",
      "cache_control": {"type": "ephemeral"}
    }],
    "messages": [{"role": "user", "content": "خلاصه‌ای از این راهنما بده."}]
  }'
  • usage.cache_read_input_tokens توکن‌هایی است که از کش خوانده شده و با نرخ ارزان‌تر کش همان مدل حساب می‌شود.
  • usage.cache_creation_input_tokens توکن‌هایی است که در کش نوشته شده و نرخ نوشتن کش را دارد؛ کش یک‌ساعته نرخ خودش را دارد.
  • این نرخ‌ها همان نسبت‌هایی هستند که Anthropic منتشر کرده، به‌علاوهٔ کارمزد همان مدل (صورت‌حساب).
  • روی /v1/chat/completions فیلد cache_control وجود ندارد؛ برای کش پرامپت Claude همین مسیر را به کار ببر.

Anthropic (نیتیو) · ۳

فکر گسترده و ابزارها

  • فیلد thinking با بودجه‌اش همان‌طور که هست فرستاده می‌شود. اگر اعتبار کفاف خروجی بیشتر از بودجهٔ فکر را ندهد، خطای 402 می‌گیری.
  • ابزارهای خودت (tools با input_schema) و tool_choice عبور می‌کنند.
  • ابزارهای سمت سرور web_search و web_fetch مجازند؛ جست‌وجو به‌ازای هر جست‌وجو حساب می‌شود. code_execution رد می‌شود (ابزارهای سمت سرور).
  • استریم با "stream": true رویدادهای خود Anthropic را می‌دهد.

Anthropic (نیتیو) · ۴

شمارش توکن و فهرست مدل‌ها

  • POST /anthropic/v1/messages/count_tokens توکن‌های یک درخواست را پیش از فرستادن می‌شمارد و رایگان است.
  • GET /anthropic/v1/models فهرست مدل‌های Claude را به شکل Anthropic برمی‌گرداند و رایگان است.

Anthropic (نیتیو) · ۵

دسته‌های پیام (Message Batches)

با Message Batches چند درخواست Messages را یک‌جا می‌فرستی و Anthropic آن‌ها را در پس‌زمینه اجرا می‌کند. مسیرها همان مسیرهای Anthropic‌اند، زیر /anthropic:

مسیرهای دسته‌های پیام
مسیرکار
POST /anthropic/v1/messages/batchesفرستادن یک دسته؛ پاسخ id آن را دارد (msgbatch_…)
GET /anthropic/v1/messages/batches/{id}وضعیت دسته؛ برای پیگیری همین را بخوان
GET /anthropic/v1/messages/batches/{id}/resultsنتیجه‌ها، یک خط JSON برای هر درخواست (JSONL)
POST /anthropic/v1/messages/batches/{id}/cancelلغو دسته
DELETE /anthropic/v1/messages/batches/{id}حذف دسته
POST /anthropic/v1/messages/batches
curl
curl https://1xai.ir/anthropic/v1/messages/batches \
  -H "x-api-key: 1xai-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "requests": [
      {"custom_id": "q-1", "params": {"model": "claude-sonnet-5", "max_tokens": 1024,
        "messages": [{"role": "user", "content": "سلام"}]}}
    ]
  }'

# وضعیت، با id پاسخ بالا
curl https://1xai.ir/anthropic/v1/messages/batches/msgbatch_... \
  -H "x-api-key: 1xai-..." -H "anthropic-version: 2023-06-01"

# نتیجه‌ها، وقتی processing_status برابر ended است
curl https://1xai.ir/anthropic/v1/messages/batches/msgbatch_.../results \
  -H "x-api-key: 1xai-..." -H "anthropic-version: 2023-06-01"
  • هر دسته فقط با کلیدهای همان حسابی که آن را ساخته خوانده می‌شود؛ دسته‌ای که با کلید یک فضای کاری شرکت ساخته شده فقط با کلیدهای همان فضای کاری. هر کلید دیگری برای آن دسته همان پاسخ شناسهٔ ناشناخته را می‌گیرد: 404 با کد not_found.
  • فهرست دسته‌ها (GET /anthropic/v1/messages/batches) از راه 1xAi در دسترس نیست و 404 با کد path_not_found می‌گیرد. id که هنگام فرستادن برمی‌گردد را نگه دار و وضعیت و نتیجه را با همان بخوان.
  • results_url در شیء دسته نشانی نتیجه‌های همان دسته روی 1xAi است: /anthropic/v1/messages/batches/{id}/results روی همان دامنه‌ای که درخواست را به آن فرستاده‌ای؛ تا نتیجه‌ها آماده نشده‌اند null است. پس در کتابخانهٔ Anthropic، messages.batches.results() با همان کلید 1xAi کار می‌کند، و یک درخواست GET به همین مسیر هم همان نتیجه‌ها را می‌دهد.
  • برای فرستادن دسته، اعتبار حساب باید مثبت باشد؛ وگرنه 402 با کد insufficient_balance. هنگام فرستادن مبلغی رزرو یا کم نمی‌شود.
  • هزینه یک بار حساب می‌شود: وقتی نتیجه‌های دسته برای اولین بار دانلود شود. توکن‌های هر درخواست موفق با ۵۰٪ قیمت توکنی رسمی همان مدل (نرخ دسته‌ای Anthropic)، به‌علاوهٔ کارمزد همان مدل، حساب می‌شوند. درخواست ناموفق، منقضی یا لغوشده هزینه‌ای ندارد و دانلودهای بعدی همان نتیجه‌ها رایگان‌اند. هزینه در گزارش مصرف، یک ردیف برای هر مدل دسته، می‌آید (صورت‌حساب).
  • مسیر با یا بدون / پایانی یکی خوانده می‌شود، و // یک / حساب می‌شود.
  • دسته‌ای که پیش از ثبت مالک دسته‌ها فرستاده شده مالکی در سابقه ندارد و 404 می‌گیرد؛ پشتیبانی پس از بررسی می‌تواند آن را به کلیدی که ساخته‌اش وصل کند.
  • کلیدی که فهرست مدل دارد زیر /anthropic/v1/messages/batches فقط فرستادن دسته و لغو آن را می‌تواند POST کند، و مدل هر درخواست دسته باید در فهرستش باشد؛ اگر یکی نباشد کل دسته با 403 و کد key_model_not_allowed رد می‌شود.

Anthropic (نیتیو) · ۶

Claude Code

Claude Code
export ANTHROPIC_BASE_URL="https://1xai.ir/anthropic"
export ANTHROPIC_AUTH_TOKEN="1xai-..."
claude

دو متغیر محیطی کافی است و حساب Anthropic لازم نیست. راهنمای گام‌به‌گام: اتصال Claude Code.