پلتفرم API
Claude را با کلید، بودجه و صورتحساب خودتان به محصولتان وصل کنید.
- Messages API متنی، با پاسخ استریم یا یکجا
- کلید جدا برای هر پروژه، با محدودیت مدل و IP
- بودجهٔ ماهانه، سقف خروجی و نقشهای تیمی
- کیف پول پیشپرداخت، داشبورد مصرف و فاکتور
پیش از عرضه · عضویت در فهرست دسترسی زودهنگام باز است
هر پروژه کلید جدا، بودجهٔ مشخص و صورتحسابی دقیق تا سطح توکن خواهد داشت. کلاود ایران فقط از راه API کار میکند و عرضه را تنها پس از قطعیشدن تأمین مورد تأیید و قرارداد آغاز میکند.
سه پیشنهاد عملی: ۱. پرسشهای ساده و تکراری را به مدل سبکتر بسپارید و مدل قویتر را برای موارد پیچیده نگه دارید. ۲. برای طول پاسخ سقف بگذارید تا جوابها بیدلیل بلند نشوند. ۳. بهجای کل تاریخچهٔ گفتوگو، فقط چند پیام آخر و اطلاعات لازم را بفرستید. با این سه تغییر، توکنهای ورودی و خروجی هر گفتوگو کم میشود و در بیشتر موارد کیفیت پاسخها هم حفظ میشود.
نمونهٔ نمایشی؛ اعداد واقعی نیستند.
دفتر این درخواست
فقط مصرف واقعی کسر شد و باقیماندهٔ رزرو به موجودی در دسترس برگشت.
هر پروژه کلید خودش را دارد؛ یک بار نمایش، ابطال در هر لحظه.
بودجهٔ ماهانه و سقف خروجی، پیش از رسیدن درخواست به مدل اعمال میشوند.
فقط مصرف واقعی کسر میشود و هیچ درخواستی دو بار حساب نمیشود.
کلید اصلی پشت سرور، دادههای هر سازمان جدا، پرامپتها بهطور پیشفرض بیرون از لاگ.
این راهها در شروع سادهاند؛ هزینهشان وقتی پیدا میشود که محصول به آنها تکیه کرده است.
ریسک: مالکیت حساب روشن نیست و دسترسی ممکن است بیخبر قطع شود.
فقط API، با تأمین مورد تأیید و قرارداد؛ هیچ حسابی خرید و فروش نمیشود.
ریسک: مصرف هیچکس جدا نیست و یک نشت، همهٔ سرویسها را با هم متوقف میکند.
کلید جدا برای هر پروژه؛ کلید لورفته را همان لحظه باطل میکنید و بقیه کار میکنند.
ریسک: سهم ورودی و خروجی پنهان است و معلوم نیست قطع استریم چطور حساب میشود.
نرخ نسخهدار ورودی و خروجی، تخمین پیش از ارسال و کسر فقط مصرف واقعی.
حساب، کیف پول و دفتر کل برای هر سه یکی است. فاز اول پلتفرم API است و فضای کار وب و اپ دسکتاپ پس از آن میآیند.
Claude را با کلید، بودجه و صورتحساب خودتان به محصولتان وصل کنید.
گفتوگو با Claude در مرورگر، با هزینهٔ هر نوبت پیش چشم.
همان فضای کار روی Windows و macOS، با ورود امن و پیشنویس آفلاین.
این مسیر کار پس از عرضه است. امروز تنها گام ممکن، عضویت در فهرست دسترسی زودهنگام است.
حساب بسازید، سازمان و پروژههایتان را تعریف کنید و اعضای تیم را با نقش مشخص اضافه کنید.
کیف پول پیشپرداخت را شارژ کنید؛ اعتبار فقط پس از تأیید پرداخت در سمت سرور مینشیند.
برای پروژه کلید بسازید و مدلها و سقفهایش را تعیین کنید؛ کلید کامل فقط یک بار نمایش داده میشود.
اولین درخواست را بفرستید و مصرف و هزینهاش را تا سطح توکن در داشبورد ببینید.
تعیین کنید هر کلید به کدام مدل برسد، چقدر خرج کند و چه کسی مدیریتش کند.
درخواست به مدلی که برای این کلید خاموش است، پیش از ارسال رد میشود.
با رسیدن مصرف به سقف، درخواستهای تازه پیش از ارسال به مدل متوقف میشوند.
طول هر پاسخ محدود میماند و سقف هزینهٔ هر درخواست با همین عدد حساب میشود.
مالک، مدیر، توسعهدهنده، مالی و مشاهدهگر؛ نقش مالی به کلیدها دسترسی ندارد.
support-bot-prodنامی بگذارید که بعداً بدانید این کلید کجا استفاده میشود.mhv_••••••••3f9aکلید کامل فقط هنگام ساخت نمایش داده میشود.این یک نمونهٔ نمایشی است و به حساب واقعی وصل نیست.
سقف هزینه پیش از ارسال رزرو میشود و پس از پاسخ، فقط مصرف واقعی کسر میشود. اگر نتیجه روشن نباشد، بهجای حدس، با شواهد بررسی میکنیم.
سقف هزینه با نرخ همان لحظه از موجودی در دسترس کنار گذاشته میشود؛ بدون موجودی کافی، درخواستی فرستاده نمیشود.
درخواست فقط یک بار به مدل میرود و شناسهاش ثبت میشود؛ پاسخ، استریم یا یکجا، به شما میرسد.
مصرف واقعی با همان نسخهٔ نرخ در دفتر کل دوطرفه ثبت میشود و باقیماندهٔ رزرو به موجودی در دسترس برمیگردد.
اگر ارتباط قطع شود و نتیجه نامعلوم بماند، درخواست کورکورانه تکرار نمیشود و رزرو تا روشنشدن نتیجه با شواهد کنار میماند؛ هیچ تخمینی خودکار به هزینهٔ قطعی تبدیل نمیشود.
چند نمونه از کارهایی که با Messages API متنی شدنی است. اینها امکاناند، نه تجربهٔ مشتریان.
پیشنویس پاسخ تیکتها را بسازید تا کارشناس پیش از ارسال بازبینی کند.
گزارش، صورتجلسه یا قرارداد را بهصورت متن بفرستید و خلاصهای ساختیافته بگیرید.
دادههای خلاصهشدهٔ فروش یا عملیات را بفرستید و گزارشی خوانا برای مدیران بگیرید.
توضیح، بازبینی و پیشنویس کد را در ابزارهای داخلی تیمتان به کار بگیرید.
در نسخهٔ اول، ورودی متنی است.
مسیرها نسخهدارند، هر خطا کد ثابت دارد و هر پاسخ با request_id پیگیری میشود. ورودی پشتیبانینشده بیصدا نادیده گرفته نمیشود.
# sample base URL and key; take the model id from GET /v1/models
curl https://api.mehvar.example/v1/messages \
-H "Authorization: Bearer $MEHVAR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-1042-reply" \
-d '{
"model": "MODEL_ID",
"max_tokens": 1024,
"stream": true,
"messages": [{ "role": "user", "content": "سلام" }]
}'import os, requests
res = requests.post(
"https://api.mehvar.example/v1/messages",
headers={
"Authorization": f"Bearer {os.environ['MEHVAR_API_KEY']}",
"Idempotency-Key": "order-1042-reply",
},
json={
"model": "MODEL_ID", # from GET /v1/models
"max_tokens": 1024,
"messages": [{"role": "user", "content": "سلام"}],
},
)
print(res.status_code, res.json())const res = await fetch("https://api.mehvar.example/v1/messages", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.MEHVAR_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": "order-1042-reply",
},
body: JSON.stringify({
model: "MODEL_ID", // from GET /v1/models
max_tokens: 1024,
messages: [{ role: "user", content: "سلام" }],
}),
});
console.log(res.status, await res.json());سازگاری با قالب OpenAI فقط برای زیرمجموعهای از قابلیتهاست؛ آنچه پشتیبانی نشود با خطای 422 برمیگردد و ادعای جایگزینی کامل برای همهٔ SDKها نداریم.
Idempotency-Key، تکرار همان درخواست دوباره هزینه کسر نمیکند.error میآید، نه با تغییر کد HTTP.GET /v1/modelsمدلهایی که کلید شما به آنها دسترسی دارد، با قابلیتها و نرخ نسخهدار هر کدام.POST /v1/messagesارسال پیام متنی، با پاسخ استریم (SSE) یا یکجا؛ همشکل با زیرمجموعهای از قالب Messages API.GET /v1/usageمصرف توکن و هزینهٔ پروژهها و کلیدهای شما.GET /v1/walletموجودی ثبتشده، مبلغ رزروشده و موجودی در دسترس.POST /v1/chat/completionsاختیاری · زیرمجموعهزیرمجموعهٔ اختیاری با قالب OpenAI، برای مهاجرت سادهتر کد موجود؛ جایگزین کامل نیست.| کد | عنوان و معنی |
|---|---|
| 402 | موجودی کافی نیست موجودی در دسترس برای سقف هزینهٔ این درخواست کافی نیست؛ درخواست به مدل نمیرود و هزینهای ندارد. |
| 409 | تعارض کلید یکتاسازی همان Idempotency-Key با محتوای متفاوت آمده است؛ درخواست اجرا نمیشود و چیزی کسر نمیشود. |
| 422 | ورودی پشتیبانینشده پارامتر یا قابلیتی فرستادهاید که این مسیر یا مدل پشتیبانی نمیکند؛ صریح رد میشود، نه بیصدا نادیده. |
| 429 | سقف نرخ درخواست به سقف درخواست یا توکن در این بازهٔ زمانی رسیدهاید؛ زمان تلاش دوباره در هدر Retry-After آمده است. |
برای هر کلید تعیین کنید به کدام مدل برسد. نرخ ورودی و خروجی هر مدل در کاتالوگ پنل پیداست.
کارهای سبک و پرتکرار، مثل دستهبندی، استخراج و پاسخهای کوتاه، که هزینهٔ هر درخواست در آنها تعیینکننده است.
بیشتر کارهای روزمرهٔ تولید متن، تحلیل و کدنویسی، با توازن میان کیفیت، سرعت و هزینه.
دشوارترین کارهای تحلیلی و چندمرحلهای، وقتی دقت بیشتر ارزش هزینهٔ بالاتر را دارد.
نرخها نسخهدارند: نرخ هر درخواست در لحظهٔ پذیرش قفل میشود و تغییر تعرفه پیش از اعمال در پنل اعلام میشود. وضعیت هر مدل، از جمله منسوخشدن، در کاتالوگ آمده است.
کلید اصلی تأمینکننده از زیرساخت ما بیرون نمیرود و دادهٔ هر سازمان از بقیه جداست. این هشت کنترل در معماری سرویس پیشبینی شدهاند.
کلید تأمینکننده فقط در زیرساخت امن میماند و هرگز به کلاینت، مرورگر یا لاگها نمیرسد.
کلیدهای مجازی بهصورت HMAC digest ذخیره میشوند؛ برای همین فقط یک بار نمایش داده میشوند و بازیابیشدنی نیستند.
جدایی دادهها با Row Level Security در خود پایگاه داده اعمال میشود و سازمان از روی کلید و در سمت سرور تشخیص داده میشود.
محتوای درخواست و پاسخ بهطور پیشفرض در لاگها و دادههای ردگیری ثبت نمیشود.
همهٔ ارتباطات عمومی روی HTTPS است و فایلها و اسرار رمزگذاریشده نگهداری میشوند.
فایلها فقط با لینک امضاشده و کوتاهعمر در دسترساند، نه با آدرس عمومی ثابت.
ساخت و ابطال کلید، تغییر نقشها و هر رویداد مالی با زمان، انجامدهنده و شناسهٔ درخواست ثبت میشود.
درخواست حذف را اجرا میکنیم و میگوییم چه چیزی کجا حذف میشود؛ حذف آنی از نسخههای پشتیبان تغییرناپذیر را وعده نمیدهیم.
قیمتها هنوز اعلام نشدهاند، اما اصولشان از حالا روشن است.
پیش از مصرف شارژ میکنید و هزینهٔ هر درخواست از همان موجودی کسر میشود.
نرخ ورودی و خروجی جدا اعلام میشود و هر تغییر تعرفه پیش از اعمال خبر داده میشود.
مبالغ همیشه با واحد مشخص نمایش داده میشوند و هزینهٔ تخمینی را پیش از ارسال میبینید.
بستهای مثل «۱ میلیون توکن» بیتفکیک ورودی و خروجی، و طرحی بیسقف هزینه در کار نیست.
قیمتها و روشهای پرداخت پیش از عرضه اعلام میشوند.
هنوز در دسترس نیست و پس از پلتفرم API عرضه میشود. آنچه میبینید طرح اولیه است.
با ویرایش یا تولید دوباره، شاخهٔ تازه ساخته میشود و نسخهٔ قبلی سر جایش میماند.
هر مرحله فقط پس از پذیرش مرحلهٔ قبل با شواهد واقعی آغاز میشود؛ برای همین تاریخ اعلام نمیکنیم.
روشنکردن تأمین مورد تأیید، قرارداد، پرداخت و قواعد پردازش داده، پیش از هر عرضه.
گروه کوچکی از کاربران، پلتفرم API را در شرایط واقعی میآزمایند: تسویه، بار، بازیابی و پشتیبانی.
کاتالوگ مدلها، کلیدها، سهمیه، مصرف، صورتحساب، مستندات و پنل مدیریت، برای عرضهٔ عمومی فاز اول.
گفتوگو، پروژه، فایلهای محدود و جستجو، روی همان حساب و کیف پول.
Windows و macOS، با ورود امن، همگامسازی و بهروزرسانی امضاشده.
نه. کلاود ایران سرویسی مستقل است و وابسته به Anthropic، نمایندهٔ مجاز یا شریک آن نیست. Claude و Anthropic نشانهای تجاری Anthropic هستند و این نامها فقط برای معرفی مدلهایی آمدهاند که قرار است کلاود ایران از راه API به آنها دسترسی دهد.
فقط از راه API و بر پایهٔ تأمین مورد تأیید و قرارداد؛ عرضه تنها پس از قطعیشدن این دو آغاز میشود. کلاود ایران حساب مصرفکننده مثل Pro یا Max، اشتراک مشترک یا فعالسازی حساب نمیفروشد و کلید اصلی تأمینکننده هرگز به دست کاربر نمیرسد؛ هر کاربر کلید مجازی پروژهٔ خودش را میگیرد.
پیش از ارسال، سقف هزینهٔ درخواست با نرخ همان لحظه از کیف پول رزرو میشود؛ درخواست یک بار به مدل میرود و پس از پاسخ فقط مصرف واقعی کسر و باقی رزرو آزاد میشود. اگر استریم قطع شود و مصرف نهایی معلوم باشد، همان ثبت میشود؛ اگر معلوم نباشد، درخواست «در انتظار تطبیق» میماند و نه دوباره فرستاده میشود، نه تخمینی بهعنوان بدهی قطعی کسر میشود. نتیجهٔ بررسی با شواهد در پنل ثبت میشود و میتوانید به آن اعتراض کنید.
پیشنهادش نمیکنیم و لازم هم نیست. در کلاود ایران هر پروژه کلید مجازی خودش را دارد و هر عضو با نقش خودش کار میکند: مالک، مدیر، توسعهدهنده، مالی یا مشاهدهگر. اگر کلیدی لو برود، فقط همان باطل یا جایگزین میشود و بقیهٔ پروژهها کارشان را ادامه میدهند.
بله. برای هر مشتری یا سرویس یک پروژه بسازید تا کلید، بودجه و گزارش مصرف خودش را داشته باشد. برای هر کلید هم میتوانید مدلهای مجاز، محدودیت IP و سقف خروجی تعیین کنید.
روشهای پرداخت هنوز نهایی نشدهاند و پیش از عرضه اعلام میشوند. آنچه از حالا روشن است: کیف پول پیشپرداخت، مبالغ با واحد مشخص به تومان یا ریال و فاکتور و رسید برای هر شارژ. هر پرداخت هم فقط یک بار در کیف پول ثبت میشود، حتی اگر تأییدیهاش چند بار برسد.
قیمتها پیش از عرضه اعلام میشوند و تا آن زمان عددی منتشر نمیکنیم. اصولشان از حالا روشن است: کیف پول پیشپرداخت، نرخ نسخهدار جدا برای ورودی و خروجی، نمایش مبالغ به تومان یا ریال، و نه بستهٔ مبهم «۱ میلیون توکن» و نه طرح «نامحدود». هر تغییر تعرفه هم پیش از اعمال اعلام میشود و فقط بر درخواستهای بعدی اثر دارد.
در پلتفرم API، محتوای پرامپت و پاسخ بهطور پیشفرض در لاگها ثبت نمیشود؛ برای صورتحساب و ممیزی، دادههایی مثل تعداد توکنها، مدل و شناسهٔ درخواست نگه داشته میشود. درخواستها طبق شروط تأمینکننده پردازش میشوند و جزئیات نگهداری داده در سیاست حریم خصوصی میآید.
تا حدی. مسیر اختیاری POST /v1/chat/completions زیرمجموعهای از قالب OpenAI را پشتیبانی میکند تا مهاجرت کدهای ساده آسانتر شود، اما جایگزین کامل نیست، چون دو قالب در نقشها، ابزارها و جزئیات استریم یکسان نیستند. ورودی پشتیبانینشده با خطای 422 برمیگردد و ادعای سازگاری کامل با همهٔ SDKها یا ابزارهایی مثل Claude Code وجود ندارد.
تاریخی اعلام نشده است. هر دو روی همان هستهٔ پلتفرم API ساخته میشوند و عرضهٔ عمومیشان فقط پس از راهاندازی موفق فاز اول آغاز میشود. اعضای فهرست دسترسی زودهنگام خبرش را با ایمیل میگیرند.
پایلوت دورهای محدود است که پس از قطعیشدن تأمین مورد تأیید و قرارداد آغاز میشود و در آن گروه کوچکی از کاربران پلتفرم API را در شرایط واقعی میآزمایند تا تسویهٔ مالی، پایداری و پشتیبانی پیش از عرضهٔ عمومی سنجیده شود. ظرفیت محدود است و پذیرش مرحلهای از میان اعضای فهرست دسترسی زودهنگام انجام میشود؛ عضویت به معنی پذیرش قطعی نیست.
بله؛ پشتیبانی از راه تیکت داخل پنل و به زبان فارسی است. هر درخواست API یک request_id دارد و پشتیبانی با همین شناسه، بدون نیاز به متن پرامپت شما، خطا را بررسی میکند. وضعیت سرویس هم در صفحهٔ وضعیت، جدا برای سرویس کلاود ایران و تأمینکننده، نمایش داده میشود.
با عضویت در فهرست دسترسی زودهنگام، خبر پذیرش مرحلهای پایلوت را به ایمیلتان میفرستیم. عضویت هزینه و تعهدی ندارد.
هر خبری دربارهٔ پذیرش پایلوت را به همین ایمیل میفرستیم.
این ایمیل از قبل در فهرست دسترسی زودهنگام است؛ لازم نیست دوباره عضو شوید.