مسیر نیتیو Anthropic: Messages API، کش پرامپت و Claude Code
POST https://1xai.ir/anthropic/v1/messages بدنهٔ درخواست را همانطور که هست به Messages API رسمی Anthropic میفرستد. قابلیتهایی که لایهٔ سازگاری OpenAI ندارد اینجا کار میکنند: کش پرامپت با cache_control، فکر گسترده و استنادها. کتابخانهٔ رسمی Anthropic و Claude Code با عوض کردن آدرس پایه و گذاشتن کلید 1xai-* وصل میشوند.
آخرین بهروزرسانی:
فهرست مستندات
مسیرهای API
حساب، کلید و تیم
Anthropic (نیتیو) · ۱
Messages: POST /anthropic/v1/messages
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
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 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} | حذف دسته |
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
export ANTHROPIC_BASE_URL="https://1xai.ir/anthropic"
export ANTHROPIC_AUTH_TOKEN="1xai-..."
claudeدو متغیر محیطی کافی است و حساب Anthropic لازم نیست. راهنمای گامبهگام: اتصال Claude Code.