اطلاعات این صفحه تا چند لحظه دیگر نمایش داده می‌شود.
خانواده AIaaS پاستا شامل API مدل‌ها، Embedding، بازیابی RAG، پایگاه دانش مدیریت‌شده و پردازش صوت است. این راهنما قرارداد اتصال و محدودیت‌های فعلی هر سرویس را توضیح می‌دهد.
مدل‌های دارای نشان 🇮🇷 میزبانی‌شده در ایران و پیشوند Paasta، درخواست را در ایران پردازش می‌کنند. این مدل‌ها فقط هنگام فعال‌بودن تأمین‌کننده و نبود خطای ثبت‌شده در فهرست نمایش داده می‌شوند. در فهرست پیش‌فرض، پس از مدل‌های دارای تخفیف فعال قرار می‌گیرند و تعرفهٔ نهایی آن‌ها پیش از مصرف نمایش داده می‌شود.
شناسه‌ها: paasta/deepseek-v4-flash، paasta/gemma-4-31b و paasta/glm-5.3. اتصال با همان کلید و مسیر Chat Completions پاستا انجام می‌شود. امکانات فعال هر مدل را از فهرست مدل‌ها بخوانید؛ پشتیبانی تصویر و ویدئو برای این مسیرها اعلام نشده است.
DeepSeek همیشه با استدلال اجرا می‌شود. برای شروع max_tokens: 4096 بگذارید؛ توکن‌های استدلال نیز جزو خروجی قابل محاسبه‌اند. سقف کم می‌تواند با finish_reason: length و بدون پاسخ نهایی پایان یابد. پاسخ نهایی و فراخوانی ابزار پس از کامل‌شدن و بررسی قالب ارسال می‌شوند. خروجی JSON بر پایهٔ دستور متنی است؛ تضمین strict: true در این مدل پشتیبانی نمی‌شود.
این نشان محل پردازش مدل را مشخص می‌کند. ورود مدل به سازندهٔ سایت جداگانه به آزمون ساخت موفق نیاز دارد. در صورت پرشدن ظرفیت، خطای محدودیت درخواست برمی‌گردد؛ یک مسیر خارجی خودکار جای مدل دارای نشان ایران را نمی‌گیرد.
مدل‌های دارای تخفیف فعال در ابتدای فهرست پین می‌شوند؛ تغییر مرتب‌سازی، ترتیب مدل‌ها را در هر گروه تغییر می‌دهد. در صفحهٔ عمومی API، مدل‌های رایگان در انتهای فهرست هستند و با فیلتر «فقط رایگان» جداگانه دیده می‌شوند. درصد، قیمت قبلی و مهلت استفاده در کاتالوگ مشخص است. نرخ‌های ورودی و خروجی نمایش‌داده‌شده، قیمت نهایی با تخفیف هستند. تخفیف بدون واردکردن کد، پس از محاسبهٔ مصرف واقعی و هزینهٔ کش اعمال می‌شود؛ گردکردن مبلغ به تومان در پایان انجام می‌شود.
درصد هنگام پذیرش درخواست ثبت می‌شود. پایان بازه یا توقف تخفیف، درخواست پذیرفته‌شده، Batch و تسویهٔ بعدی همان درخواست را تغییر نمی‌دهد. تخفیف فقط برای مدل انتخاب‌شده است، با تخفیف دیگری جمع نمی‌شود و مدل رایگان را تغییر نمی‌دهد. مصرف مستقل AI Builder مشمول این تخفیف نیست.
زمان‌ها به ساعت تهران هستند. وضعیت مدل‌ها و تخفیف‌ها در هر بار بارگذاری کاتالوگ تازه می‌شود؛ نزدیک پایان بازه، صفحه را تازه کنید. فهرست API نیز فیلدهای discount_percent، discount_ends_at و قیمت‌های قبل با پیشوند original_ را برمی‌گرداند.
API سازگار با OpenAI و Anthropic برای متن، استریم، فراخوانی ابزار و خروجی JSON ساخت‌یافته؛ با قیمت نهایی تومانی و گزارش مصرف در همان فضای کاری.
در صفحهٔ API رایگان مدل‌ها را جست‌وجو کنید و برای ابزار کدنویسی کانفیگ بسازید؛ سازندهٔ کانفیگ فقط مدل‌های دارای پشتیبانی اعلام‌شده از ابزار را پیشنهاد می‌کند. در کاتالوگ کامل هم «فقط رایگان» را انتخاب و شناسهٔ دارای :free را کپی کنید. این مدل‌ها از همان کلید و مسیر Chat Completions استفاده می‌کنند، اما شناسهٔ جدا از مدل پولی دارند. کلید API همچنان لازم است؛ موجودی کیف پول برای این درخواست‌ها شرط نیست.
برای یک ابزار، کلید جدا با دسترسی محدود به مدل‌های رایگان و سقف روزانه و ماهانهٔ صفر بسازید. کلید صفر‌بودجه اجازهٔ درخواست پولی نمی‌دهد. شناسه‌های قبلی برای سازگاری تغییر نمی‌کنند؛ نام و لوگوی کاتالوگ مربوط به سازندهٔ مدل است، نه مسیر فنی تأمین آن.
سقف درخواست و توکن روزانه میان همهٔ کلیدهای فضای کاری مشترک است و در نیمه‌شب تهران بازنشانی می‌شود. مقدار جاری سهمیه را در کاتالوگ حساب و پاسخ GET /models ببینید: فیلدهای free_daily_requests و free_daily_tokens سقف روزانه را نشان می‌دهند؛ free_requests_per_minute نرخ ارسال و max_output_tokens سقف خروجی هر پاسخ است. این مقادیر قابل تنظیم‌اند و ممکن است با ظرفیت سرویس تغییر کنند. ورودی و سقف خروجی درخواست‌های در حال اجرا محافظه‌کارانه از سهمیه رزرو می‌شوند. تاریخچهٔ طولانی و کار چندمرحله‌ای Agentها سهمیهٔ بیشتری مصرف می‌کند.
با پایان سهمیهٔ روزانه، خطای ۴۲۹ دریافت می‌کنید. اگر مسیر رایگان به‌دلیل محدودیت یا اختلال پاسخ ندهد، پیام ظرفیت رایگان را می‌بینید؛ کد خطا همچنان نوع مشکل را برای عیب‌یابی مشخص می‌کند. درخواست ناموفق از سهمیهٔ روزانهٔ درخواست و ظرفیت توکن مشترک کم نمی‌کند. مدل پولی خودکار جایگزین نمی‌شود؛ انتخاب مدل پولی یک درخواست جداگانه و آگاهانه است. افزونه‌های پولی، انتخاب مسیر یا مدل جایگزین در درخواست رایگان مجاز نیستند. دسترسی رایگان به ظرفیت ارائه‌دهنده وابسته است و برای کار حساس یا ارسال دادهٔ محرمانه مناسب نیست.
برای Gemma 4 رایگان، شرایط Google اجازه می‌دهد محتوای ورودی و خروجی سهمیهٔ رایگان برای بهبود سرویس استفاده و گاهی توسط بازبین انسانی بررسی شود. دادهٔ شخصی یا محرمانه را با این مدل نفرستید.
برای development و production کلید جدا بسازید. تاریخ انقضا، سقف هزینه، نرخ درخواست و مدل‌های مجاز را همان ابتدا تعیین کنید.
کاتالوگ به‌صورت پیش‌فرض مدل‌ها را با رتبه هفتگی بازار بر پایه حجم توکن پردازش‌شده مرتب می‌کند؛ مدل‌های بدون داده معتبر بیرونی بر اساس قیمت کمتر نمایش داده می‌شوند. توضیح، نوع ورودی، ظرفیت متن و قابلیتهایی مثل ابزار و خروجی ساختاریافته را می‌توانید جست‌وجو و فیلتر کنید.
کلید را در مرورگر، Git، URL یا لاگ قرار ندهید. آن را فقط از سرور و متغیر محیطی بخوانید.
توکن ورودی، خروجی، استدلال و کش، مبلغ نهایی، زمان پاسخ و خطا در پنل ثبت می‌شوند. متن پیام و پاسخ ذخیره نمی‌شود.
در صفحه «اتصال ابزار توسعه» ابزار را انتخاب و مدل‌ها را با نام یا شناسه جست‌وجو کنید. قیمت ورودی و خروجی همان‌جا دیده می‌شود. پاستا یک کلید ۹۰روزه محدود به مدل انتخابی، سقف هزینه روزانه و تنظیم قابل کپی می‌سازد. مقدار کلید فقط همان یک‌بار دیده می‌شود و بعداً از صفحه کلیدهای API قابل لغو است.
OpenCode، Cursor، Codex، Claude Code، Hermes Agent و DeepSeek Harness آماده‌اند. Claude Code از Anthropic Messages، Codex از Responses و بقیه ابزارها از مسیر سازگار OpenAI استفاده می‌کنند.
مرتب‌سازی پیش‌فرض از رتبه رسمی most-popular در OpenRouter استفاده می‌کند که حجم توکن پردازش‌شده هر مدل در هفته گذشته را می‌سنجد. این رتبه در زمان همگام‌سازی کاتالوگ ثبت می‌شود؛ نبود رتبه به معنی نامحبوب‌بودن نیست و چنین مدل‌هایی فقط با قیمت کمتر مرتب می‌شوند.
مالک یا مدیر فضای کاری می‌تواند از صفحه مستقل Playground مدل‌ها را با نام، توضیح و نوع ورودی جست‌وجو کند، پیام سیستمی، Temperature و سقف خروجی را تنظیم کند و پاسخ واقعی بگیرد. قیمت مدل پیش از اجرا و توکن، زمان پاسخ، هزینه نهایی و شناسه درخواست پس از اجرا دیده می‌شوند. این اجرا از همان کیف پول و ثبت مصرف API استفاده می‌کند، اما متن گفتگو فقط در مرورگر می‌ماند.
برای عملیات قابل تکرار یک Idempotency-Key یکتا بفرستید. استفاده دوباره از همان شناسه با خطای 409 متوقف می‌شود و دوباره هزینه ایجاد نمی‌کند.
curl https://console.paasta.cloud/api/ai/v1/chat/completions \
-H "Authorization: Bearer $PAASTA_AI_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-summary-42" \
-d '{"model":"MODEL_ID","messages":[{"role":"user","content":"یک خلاصه کوتاه بنویس"}],"max_tokens":256}'شناسه هدر x-paasta-request-id را به GET /generation?id=... بدهید تا وضعیت، مدل، زمان پاسخ، توکن‌های ورودی، خروجی، استدلال و کش و مبلغ نهایی تومانی را بخوانید. فقط همان کلید API که درخواست را ساخته به این رکورد دسترسی دارد. متن درخواست و پاسخ، هزینه دلاری داخلی و شناسه ارائه‌دهنده برگردانده نمی‌شوند.
برای بررسی چند درخواست کنار هم، مالک یا مدیر فضای کاری می‌تواند در مصرف و لاگ‌ها فایل CSV یک، هفت یا سی روز اخیر را بگیرد. فایل شامل API، Playground و پاستا بوم است؛ متن گفتگو و هزینه داخلی ندارد. اگر بازه بیش از ۱۰٬۰۰۰ درخواست داشته باشد، خروجی ناقص تحویل داده نمی‌شود و باید بازه کوتاه‌تری انتخاب کنید.
curl "https://console.paasta.cloud/api/ai/v1/generation?id=REQUEST_ID" \
-H "Authorization: Bearer $PAASTA_AI_KEY"مسیر سازگار OpenAI در POST /embeddings متن، چند متن یا شناسه‌های توکن را می‌پذیرد. فهرست زنده مدل‌ها و قیمت ورودی از GET /embeddings/models دریافت می‌شود. بدنه هر درخواست حداکثر ۲ مگابایت و تعداد ورودی‌ها حداکثر ۲۰۴۸ مورد است. خطا یا پاسخ فاقد گزارش مصرف هزینه ندارد و مبلغ نهایی همان درخواست کنار پاسخ برمی‌گردد.
برای بررسی مدل، ابعاد بردار و هزینه واقعی بدون نوشتن کد، Embedding Playground را باز کنید. متن و بردار در گزارش پاستا ذخیره نمی‌شوند.
const response = await fetch("https://console.paasta.cloud/api/ai/v1/embeddings", {
method: "POST",
headers: { Authorization: "Bearer " + process.env.PAASTA_AI_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
model: "openai/text-embedding-3-small",
input: ["جست‌وجوی معنایی فارسی", "ساخت RAG با دادههای خودم"],
}),
});
const result = await response.json();
if (!response.ok) throw new Error(result.error?.message);
console.log(result.data[0].embedding, result.paasta.charged_toman);در صفحه پایگاه دانش یک مدل Embedding انتخاب کنید و متن مستقیم، آدرس یک صفحه عمومی یا فایل PDF دارای متن را اضافه کنید. پاستا متن را نرمال، به قطعه‌های هم‌پوشان تقسیم و همراه بردار آن رمز‌شده ذخیره می‌کند. سپس مسیر POST /knowledge-bases/{id}/search بخش‌های مرتبط، نام منبع و جزئیات رتبه‌بندی را برمی‌گرداند تا آن‌ها را به مدل گفت‌وگو بدهید.
آموزش سناریومحور ساخت چت‌بات RAG همین مسیر را از ساخت پایگاه تا گفت‌وگوی آزمایشی و نمایش منبع پاسخ، با کد قابل اجرا نشان می‌دهد.
روش پیش‌فرض hybrid است: شباهت برداری با تطبیق واژه‌های فارسی و انگلیسی ترکیب می‌شود تا نام محصول، شماره نسخه و کد خطا در رتبه‌بندی گم نشود. این کار فراخوانی مدل دیگری ندارد و هزینه آن با حالت semantic یکسان است. برای مقایسه یا حفظ رفتار قبلی، فیلد retrieval_mode را با مقدار semantic بفرستید. فیلدهای semantic_score، keyword_score و match_type دلیل رتبه هر نتیجه را روشن می‌کنند.
در پنل می‌توانید هر پرسش و بخش درست آن را به‌عنوان یک معیار ثبت کنید، سپس همان پرسش را بعد از تغییر منابع دوباره بیازمایید. رتبهٔ قطعهٔ موردانتظار و تغییر آن نسبت به اجرای قبلی نشان داده می‌شود. هر پایگاه حداکثر ۲۰ معیار دارد. ثبت معیار هزینهٔ مدل ندارد؛ هر اجرای دوباره یک جست‌وجوی واقعی و هزینه‌دار است. این معیارها فقط در پنل قابل مدیریت‌اند و هنوز API عمومی یا اجرای زمان‌بندی‌شده ندارند.
هر منبع حداکثر ۵۰ هزار نویسه، هر صفحه وب حداکثر ۵۱۲ کیلوبایت، هر PDF حداکثر ۴ مگابایت و ۱۰۰ صفحه، هر پایگاه حداکثر ۳۰۰ قطعه و هر جست‌وجو حداکثر ۱۰ نتیجه دارد. URL باید HTTPS عمومی و محتوای آن HTML، Markdown یا متن UTF-8 باشد. PDF رمزدار پذیرفته نمی‌شود و فایل اسکن‌شده باید پیش از بارگذاری OCR شود. صفحه وب یک‌بار دریافت می‌شود و همگام‌سازی خودکار ندارد. پردازش منبع و هر جست‌وجو جداگانه براساس مصرف واقعی مدل Embedding تسویه می‌شوند. کلید API باید اجازه استفاده از مدل Embedding همان پایگاه را داشته باشد.
پایگاه خالی هزینه نگهداری ندارد. اگر هزینه نگهداری فعال باشد، از زمانی که دست‌کم یک منبع آماده دارید، نرخ پایه ساعتی فضای کاری محاسبه می‌شود؛ یک گیگابایت در آن گنجانده شده و فضای مازاد نرخ جداگانه دارد. مبلغ هر دو نرخ پیش از افزودن منبع در پنل نمایش داده می‌شود. برداشت هر پنج دقیقه در کیف پول با عنوان «زیرساخت پایگاه دانش» ثبت می‌شود و هزینه پردازش و جست‌وجوی مدل جداست. اگر موجودی کافی نباشد، افزودن منبع و جست‌وجو متوقف می‌شوند، اما داده‌ها محفوظ می‌مانند و پس از افزایش اعتبار دسترسی برمی‌گردد.
برخلاف لاگ مصرف عمومی، متن منبع و پرسش‌های معیار برای کارکرد پایگاه دانش نگهداری می‌شوند. می‌توانید یک منبع را مستقل حذف کنید یا با حذف پایگاه، همه منبع‌ها، معیارهای وابسته و بردارهایش را یکجا پاک کنید. داده‌ها فقط در همان فضای کاری و به‌صورت رمز‌شده ذخیره می‌شوند. آدرس صفحه و فایل PDF خام ذخیره نمی‌شوند و حذف منبع، هزینه مصرف‌شده قبلی را برنمی‌گرداند.
const response = await fetch(
"https://console.paasta.cloud/api/ai/v1/knowledge-bases/KNOWLEDGE_BASE_ID/search",
{
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PAASTA_AI_KEY,
"Content-Type": "application/json",
"Idempotency-Key": "support-question-42",
},
body: JSON.stringify({ query: "شرایط بازگشت وجه چیست؟", top_k: 5, retrieval_mode: "hybrid" }),
},
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.message);
console.log(result.results, result.charged_toman);مدل‌های فعال را با GET /audio/models ببینید. مسیر POST /audio/transcriptions علاوه بر JSON قبلی، فایل را به شکل multipart/form-data با فیلدهای model و file می‌پذیرد. سقف فایل ۱٫۴ مگابایت است. مدل‌های تازه برای محاسبه امن سقف هزینه، فایل WAV استاندارد PCM تا ۱۰ دقیقه می‌پذیرند؛ سقف ۱٫۴ مگابایت هم برقرار است. مدت از خود فایل محاسبه می‌شود، نه از عددی که کاربر می‌فرستد. قالب‌های فشرده در مسیرهای قدیمیِ دارای پشتیبانی حفظ شده‌اند.
برای تفکیک گویندگان، مدل دارای نشان diarize را با response_format: diarized_json انتخاب کنید. قیمت مدل ممکن است بر اساس توکن متن و صوت یا مدت فایل باشد؛ واحد را در کاتالوگ بررسی کنید.
مدل‌های صوتی دارای پاسخ کامل از مسیر /chat/completions با stream: false، modalities: ["text", "audio"] و audio: {voice: "alloy", format: "wav"} فراخوانی می‌شوند. صوت در choices[0].message.audio.data به شکل base64 برمی‌گردد. این قابلیت با WebSocket بلادرنگ متفاوت است؛ Realtime فعلاً فعال نیست.
import { readFileSync } from "node:fs";
const response = await fetch("https://console.paasta.cloud/api/ai/v1/audio/transcriptions", {
method: "POST",
headers: { Authorization: "Bearer " + process.env.PAASTA_AI_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
model: "openai/gpt-4o-mini-transcribe",
input_audio: { data: readFileSync("voice.wav").toString("base64"), format: "wav" },
language: "fa",
}),
});
const result = await response.json();
if (!response.ok) throw new Error(result.error?.message);
console.log(result.text, result.paasta.charged_toman);typesafe/jev-1.13 مدل گفت‌وگو نیست. آن را از مسیر مستقل POST /decisions با وضعیت و پرسش‌های نوع noul، choice یا score فراخوانی کنید. فهرست و قیمت زنده از GET /decisions/models دریافت می‌شود. توکن ورودی و هزینه نهایی در گزارش مصرف ثبت می‌شوند؛ خطا یا پاسخ فاقد گزارش مصرف هزینه ندارد. خروجی را پیش از اقدام حساس با قواعد برنامه یا تأیید انسان کنترل کنید.
curl https://console.paasta.cloud/api/ai/v1/decisions \
-H "Authorization: Bearer $PAASTA_AI_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: ticket-42" \
-d '{"model":"typesafe/jev-1.13","state":{"ticket":"صفحه پرداخت پس از کلیک خالی می‌شود"},"questions":{"is_bug":{"type":"noul","instructions":"آیا این گزارش یک باگ است؟","criteria":{"true":"رفتار خراب یا غیرمنتظره","false":"درخواست ویژگی یا پرسش"}}}}'import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.PAASTA_AI_KEY,
baseURL: "https://console.paasta.cloud/api/ai/v1",
});
const response = await client.chat.completions.create({
model: "MODEL_ID",
messages: [{ role: "user", content: "سلام" }],
max_tokens: 256,
});
console.log(response.choices[0].message.content);from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ["PAASTA_AI_KEY"],
base_url="https://console.paasta.cloud/api/ai/v1",
)
response = client.chat.completions.create(
model="MODEL_ID",
messages=[{"role": "user", "content": "سلام"}],
max_tokens=256,
)
print(response.choices[0].message.content)فیلد paasta.charged_toman افزوده پاستا است و ممکن است TypeScript SDK آن را در type پیش‌فرض نشناسد؛ پاسخ خام یا یک type توسعهیافته برای آن استفاده کنید.
مسیر POST /responses برای پاسخ هم‌زمان و SSE streaming، متن، تصویر URL، function calling و خروجی ساخت‌یافته فعال است. این مسیر محتوا یا وضعیت گفتگو را نگه نمی‌دارد و همیشه store: false برمی‌گرداند. برای ادامه گفتگو، پیام‌ها و خروجی ابزارهای قبلی را دوباره بفرستید.
const response = await client.responses.create({
model: "MODEL_ID",
instructions: "کوتاه و روشن پاسخ بده",
input: "سه مزیت API یکپارچه چیست؟",
max_output_tokens: 256,
store: false,
});
console.log(response.output_text);مسیر POST /messages متن، تصویر، system prompt، ابزارهای تابعی، tool_use، tool_result و SSE را به همان کاتالوگ و صورتحساب پاستا متصل می‌کند. درخواست‌های دارای thinking، تنظیم output_config.effort و تاریخچهٔ thinking امضاشده از مسیر بومیِ سازگار عبور می‌کنند؛ پشتیبانی به مدل و مسیر انتخابی بستگی دارد. توکن‌های استدلال هم جزو مصرف خروجی‌اند. Bearer و x-api-key پذیرفته می‌شوند و متن گفتگو در گزارش مصرف نگهداری نمی‌شود.
آیا استدلال روی مدل رایگان هم کار می‌کند؟ بله، اگر مدل و مسیر آن از این قابلیت پشتیبانی کنند. سهمیهٔ رایگان همچنان اعمال می‌شود و درخواست به مدل پولی منتقل نمی‌شود. خطای ظرفیت موقت با نبود پشتیبانی فرق دارد؛ در این حالت کمی بعد دوباره تلاش کنید. اگر خطای سازگاری می‌بینید، شناسهٔ مدل، زمان خطا و نام برنامه را برای پشتیبانی بفرستید، نه کلید API یا متن خصوصی گفتگو.
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
apiKey: process.env.PAASTA_AI_KEY,
baseURL: "https://console.paasta.cloud/api/ai",
});
const message = await client.messages.create({
model: "MODEL_ID",
max_tokens: 256,
messages: [{ role: "user", content: "سلام" }],
});
console.log(message.content);با stream: true پاسخ به‌صورت SSE میرسد. آخرین chunk شامل usage و هزینه نهایی است و سپس [DONE] ارسال می‌شود. اگر اتصال پیش از usage قطع شود، رزرو هزینه برمی‌گردد.
const stream = await client.chat.completions.create({
model: "MODEL_ID",
messages: [{ role: "user", content: "مرحلهبهمرحله توضیح بده" }],
max_tokens: 512,
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}تا ۱۲۸ تابع تعریف کنید. tool_choice می‌تواند none، auto، required یا نام یک تابع باشد. اجرای تابع با برنامه شماست؛ نتیجه را با role برابر tool و همان tool_call_id در پیام بعدی بفرستید.
{
"model": "MODEL_ID",
"messages": [{"role":"user","content":"هوای تهران را بررسی کن"}],
"tools": [{"type":"function","function":{
"name":"get_weather",
"description":"وضعیت هوا را برای یک شهر برمی‌گرداند",
"parameters":{"type":"object","properties":{"city":{"type":"string"}},"required":["city"],"additionalProperties":false},
"strict":true
}}],
"tool_choice":"auto"
}برای JSON معتبر از json_object و برای قرارداد دقیق از json_schema استفاده کنید. پشتیبانی نهایی به قابلیت مدل انتخابی وابسته است.
{
"response_format": {"type":"json_schema","json_schema":{
"name":"ticket","strict":true,
"schema":{"type":"object","properties":{"title":{"type":"string"},"priority":{"type":"string","enum":["low","high"]}},"required":["title","priority"],"additionalProperties":false}
}}
}برای مدل پولی، پاستا هزینه را بر اساس تعرفه نمایش‌داده‌شده، اندازه ورودی و max_tokens رزرو می‌کند. بعد از پاسخ، مصرف واقعی تسویه و باقی رزرو فوراً برگردانده می‌شود. اگر ارائه‌دهنده برای خواندن یا نوشتن کش نرخ کمتری ثبت کرده باشد، همان نرخ کمتر در مبلغ نهایی اعمال می‌شود؛ توکن کششده دوباره با نرخ کامل ورودی حساب نمی‌شود. مسیر فنی اجرای مدل می‌تواند برای پایداری عوض شود، اما رایگانشدن مسیر فنی قیمت مدل پولی را عوض نمی‌کند. فقط شناسههایی که صریحاً با برچسب «رایگان» و تعرفه صفر در کاتالوگ قرار دارند، برای مشتری رایگاناند و سهمیهٔ مستقل دارند. درخواست نامعتبر یا خطای ارائه سرویس هزینهای ندارد.
مدیر فضای کاری می‌تواند در مصرف و لاگ‌ها سقف مشترک روزانه یا ماهانه برای همه کلیدهای AI API و Playground تنظیم کند. هزینه درخواست‌های موفق و رزروهای باز هر دو حساب می‌شوند؛ درخواست تازه پس از رسیدن به سقف با خطای ۴۰۲ و بدون برداشت رد می‌شود. روز و ماه میلادی به وقت تهران محاسبه می‌شوند. سقف هر کلید همچنان جداگانه اعمال می‌شود. اگر رسید نهایی ارائه‌دهنده بیشتر از رزرو اولیه باشد، پاستا مبلغ اضافهٔ فراتر از سقف مشترک را از مشتری نمی‌گیرد و اختلاف را در گزارش داخلی ثبت می‌کند. پاستا بوم فعلاً زیر این سقف مشترک نیست.
400ساختار JSON، پیام‌ها یا پارامترها را اصلاح کنید.
400پارامترهای مخصوص مدل را بررسی کنید؛ هزینهای کم نشده است.
401کلید، انقضا یا لغوشدن آن را بررسی کنید.
402سقف ماهانه کلید یا موجودی فضای کاری را افزایش دهید.
402مدیر فضای کاری سقف مشترک روزانه را افزایش دهد یا تا روز بعد صبر کنید؛ هزینهای کم نشد.
402مدیر فضای کاری سقف مشترک ماهانه را افزایش دهد یا تا ماه بعد صبر کنید؛ هزینهای کم نشد.
403مدل را به فهرست مجاز کلید اضافه کنید.
404شناسه را دوباره از کاتالوگ زنده بردارید.
404مدل موقتاً در مسیر اصلی موجود نیست؛ مدل دیگری انتخاب کنید.
409برای عملیات تازه شناسه یکتای جدید بسازید.
413بدنه JSON را به کمتر از ۱۶ MiB کاهش دهید.
429به اندازه Retry-After صبر و سپس با backoff تلاش کنید.
429ظرفیت مدل موقتاً پر است؛ پس از Retry-After دوباره تلاش کنید.
502/504درخواست هزینه ندارد؛ با تأخیر محدود یا مدل دیگر تکرار کنید.
503مسیر بالادست موقتاً ظرفیت مالی کافی ندارد؛ مدل دیگری را انتخاب کنید یا کمی بعد دوباره تلاش کنید.
503مسیر مدل برای پنج دقیقه بازیابی می‌شود؛ به اندازه Retry-After صبر کنید یا مدل دیگری انتخاب کنید.
اگر ابزار توسعه سقف خروجی بزرگتری از توان مدل بفرستد، پاستا آن را تا سقف همان مدل پایین میآورد و درخواست را حفظ می‌کند. فیلدهای اختیاری خالی در ابزارها و قالب‌های رایج متن و تصویر نیز پیش از اعتبارسنجی سازگار می‌شوند. پاستا خطای اتصال را فقط وقتی تا سه تلاش تکرار می‌کند که درخواست هنوز ارسال نشده باشد. اگر اتصال پس از ارسال احتمالی درخواست قطع شود، تولید پاسخ خودکار دوباره شروع نمی‌شود. خطاهای HTTP موقت میتوانند با تأخیر محدود تکرار شوند؛ زمان Retry-After کوتاه نمی‌شود و اگر بیش از ده ثانیه باشد، خطا و زمان انتظار به برنامه شما برمیگردند. اگر پاسخ سالم نرسد، رزرو آزاد می‌شود و کد دقیق بالا برمی‌گردد. سه شکست زیرساختی پیاپی نیز مسیر ارائه‌دهنده را پنج دقیقه متوقف می‌کند. خطای ورودی کاربر، محدودیت نرخ و قطع اتصال کاربر به سلامت ارائه‌دهنده لطمه نمیزنند؛ نخستین پاسخ سالم مدار را بازنشانی می‌کند.
پاسخ معمولی، استریم Chat Completions، فراخوانی ابزار، خروجی ساخت‌یافته و Embedding هر شش ساعت روی مسیرهای فعال بررسی می‌شوند. این پروبها محتوای آزمون را نگه نمیدارند و از کیف پول مشتری استفاده نمی‌کنند.
Responses پاسخ هم‌زمان و streaming را بدون ذخیره وضعیت ارائه می‌کند. ابزارهای function فعالاند؛ ابزار میزبانی‌شده جست‌وجوی Codex نادیده گرفته می‌شود و اجرای ابزارهای محلی همچنان در خود Codex انجام می‌شود. background، previous_response_id و conversation هنوز فعال نیستند. Anthropic Messages نیز متن، تصویر، ابزارهای محلی و thinking امضاشده را پوشش می‌دهد؛ ابزارهای میزبانی‌شده پشتیبانی نمی‌شوند. درخواست‌های دارای thinking فقط برای مدل‌هایی که مسیر Anthropic در OpenRouter دارند ارسال می‌شوند. مسیر Embeddings متن و شناسه توکن را پوشش می‌دهد و فایل یا تصویر را نمیپذیرد. تولید و ویرایش تصویر، Batch تصویر، تولید گفتار و Batch متنی در مدل‌های پشتیبان فعالاند. قیمت توکن متن، تصویر و صوت ممکن است متفاوت باشد. جست‌وجوی وب میزبانی‌شده فقط با مدل و انتخاب صریح معرفیشده در راهنما فعال است. WebSocket بلادرنگ، تولید تصویر داخل Responses، Batch فایلمحور و Fine-tuning فعلاً ارائه نمی‌شوند. شناسه مدل را تنظیمپذیر نگه دارید و خطاهای 404، 429 و 5xx را مدیریت کنید.
شناسه، تعرفه و قابلیت هر مدل در کاتالوگ تصویر و GET /images مشخص است. مسیر قبلی POST /images حفظ شده و POST /images/generations هم همان کار را انجام می‌دهد. هر درخواست یک تصویر base64 می‌سازد. مدل‌های پشتیبان، انتخاب size و quality را می‌پذیرند؛ برای شروع، اندازه 1024x1024 و کیفیت low انتخاب کم‌هزینه‌تری است.
فقط مدل دارای supports_edit: true را به POST /images/edits بفرستید. همراه متن، دقیقاً یکی از image_url یا image_urls را با یک تا چهار آدرس عمومی HTTPS بدهید؛ ماسک اختیاری با mask_url ارسال می‌شود. بارگذاری multipart برای ویرایش فعلاً ارائه نمی‌شود. آدرس خصوصی، دارای نام کاربری یا گذرواژه پذیرفته نمی‌شود.
نرخ توکن متن و تصویر جداست. پیش از اجرا سقف امن رزرو و پس از گزارش معتبر، فقط مصرف واقعی با تعرفه همان مدل تسویه می‌شود؛ باقیمانده آزاد می‌شود. مبلغ رزرو، قیمت ثابت یک تصویر نیست. زمان پاسخ می‌تواند طولانی باشد؛ timeout کلاینت را حداقل ۳۶۰ ثانیه تنظیم کنید. درخواست دارای نتیجه نامشخص را خودکار تکرار نکنید.
curl https://console.paasta.cloud/api/ai/v1/images \
-H "Authorization: Bearer $PAASTA_AI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"IMAGE_MODEL_ID","prompt":"یک منظره کوهستانی در طلوع آفتاب","n":1,"response_format":"b64_json"}'برای یک تا ۱۰ تصویر، POST /images/batches را با یک شناسه مدل و آرایه items بفرستید. هر ردیف دارای type: generation یا در مدل پشتیبان type: edit و پارامترهای همان مسیر است. پاسخ ۲۰۲ یک شناسه پاستا می‌دهد؛ وضعیت و نتیجه را با GET /images/batches/ID بخوانید.
فقط همان کلید و همان فضای کاری می‌تواند نتیجه را بخواند یا با DELETE /images/batches/ID صف را متوقف کند. توقف، تصاویر در حال اجرا را لغو نمی‌کند؛ هزینه تصاویر موفق تسویه می‌شود. نتیجه تصویر در پایگاه داده پاستا ذخیره نمی‌شود و مهلت دریافت آن نزد مسیر پردازش یک ساعت است. فایل را در فضای ذخیره‌سازی خودتان نگه دارید. اگر وضعیت submission_uncertain بود، دوباره ثبت نکنید و شناسه را به پشتیبانی بدهید.
مدل‌های پولی دارای قابلیت فایل، PDF متنی و اسکن‌شده را در Chat، Responses و Messages می‌پذیرند. متن به‌صورت محلی استخراج می‌شود؛ OCR با اولویت مدل داخلی و در صورت شکست با سرویس خارجی انجام می‌شود. هزینهٔ OCR فعلاً با پاستاست و متن استخراج‌شده در مصرف معمول مدل حساب می‌شود.
برای محدودکردن پردازش PDF به ایران، pdf_processing: { allow_external: false } بفرستید. هر PDF حداکثر ۴ مگابایت و ۱۰۰ صفحه و هر درخواست حداکثر ۳ PDF، مجموع ۶ مگابایت و ۶ صفحهٔ نیازمند OCR می‌پذیرد. قالب پیوست، محدودیت‌ها و راهنمای استفاده
مدل و صدای مجاز را از GET /audio/speech انتخاب کنید. با POST /audio/speech متن تا ۴۰۰۰ نویسه، voice و قالب خروجی بفرستید. MP3 و PCM در مسیرهای قبلی حفظ شده‌اند؛ مدل‌های پشتیبان WAV هم می‌پذیرند. نوع واقعی فایل در Content-Type پاسخ مشخص است.
واحد قیمت همه مدل‌ها یکسان نیست: مدل نویسه‌ای بر اساس متن، و مدل توکنی بر اساس متن و صوت تولیدشده حساب می‌شود. نرخ‌ها در pricing_components کاتالوگ قرار دارند. در مدل دارای رسید هزینه، مبلغ نهایی از رسید و تعرفه عرضه‌شده محاسبه می‌شود؛ اگر شمارش توکن در پاسخ گزارش نشود، عدد ساختگی در لاگ ثبت نمی‌کنیم. سقف امن ابتدا رزرو و مبلغ نهایی در هدر x-paasta-charged-toman اعلام می‌شود.
curl https://console.paasta.cloud/api/ai/v1/audio/speech \
-H "Authorization: Bearer $PAASTA_AI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"SPEECH_MODEL_ID","input":"سلام، به پاستا خوش آمدید","voice":"VOICE_ID","response_format":"mp3"}' \
--output answer.mp3POST /batches در نسخه نخست ۱ تا ۲۰ درخواست گفت‌وگوی متنی از یک مدل OpenRouter دارای نسخه Batch را می‌پذیرد. هر ردیف custom_id یکتا و max_tokens دارد. پاسخ اولیه شناسه محلی Batch را می‌دهد؛ وضعیت و خروجی را با GET /batches/{id} و همان کلید بخوانید. مدل، سقف خروجی و موجودی همه ردیف‌ها پیش از ارسال بررسی و رزرو می‌شود. پس از پایان، مصرف کل از ارائه‌دهنده دریافت و فقط یک‌بار در کیف پول تسویه می‌شود. متن درخواست و خروجی در پایگاه پاستا ذخیره نمی‌شود؛ خروجی از ارائه‌دهنده خوانده می‌شود و عمر نگهداری آن تابع قرارداد اوست.
اگر پاسخ ارسال نامشخص باشد، وضعیت submission_uncertain برمی‌گردد: با شناسه تازه دوباره ارسال نکنید، چون ممکن است Batch اول پذیرفته شده باشد. شناسه را به پشتیبانی بدهید تا بدون هزینه یا اجرای تکراری بررسی شود. Batch فعلاً فایل JSONL، استریم، لغو و چند مدل در یک درخواست ندارد.
curl https://console.paasta.cloud/api/ai/v1/batches \
-H "Authorization: Bearer $PAASTA_AI_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: nightly-summary-2026-09-27" \
-d '{"model":"MODEL_ID","endpoint":"/v1/chat/completions","requests":[{"custom_id":"item-1","body":{"messages":[{"role":"user","content":"خلاصه کوتاهی بنویس"}],"max_tokens":256}}]}'
# سپس: GET /batches/BATCH_ID با همان کلید APIفعلاً فقط مدل openai/gpt-5.6-luna از جست‌وجوی وب میزبانی‌شده در پاستا پشتیبانی می‌کند. در POST /responses یک ورودی متنی تا ۴۰۰۰ نویسه، ابزار web_search و انتخاب صریح همان ابزار بفرستید. هر درخواست حداکثر یک جست‌وجو دارد و غیرجریانی است. نشانه‌های معمول جست‌وجو در ابزارهای کدنویسی، بدون این انتخاب صریح، به جست‌وجوی پولی تبدیل نمی‌شوند.
علاوه بر مصرف توکن، هر جست‌وجوی انجام‌شده هزینه جدا دارد. تعرفه نهایی با سود و تخفیف در فیلد web_search_toman_per_request پاسخ GET /models آمده است. این مسیر فقط برای کلید عادی کیف پول است؛ کلیدهای مدیریت‌شده اشتراک پشتیبانی نمی‌شوند. ذخیره گفتگو، ادامه نشست و ابزار تولید تصویر داخل Responses فعلاً فعال نیستند.
curl https://console.paasta.cloud/api/ai/v1/responses \
-H "Authorization: Bearer $PAASTA_AI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"openai/gpt-5.6-luna","input":"نشانی رسمی پاستاکلود را پیدا کن.","tools":[{"type":"web_search"}],"tool_choice":{"type":"web_search"},"max_tool_calls":1,"max_output_tokens":512,"store":false,"stream":false}'برای مدل‌های پشتیبان، اگر مسیر اول پیش از تولید پاسخ، درخواست را به‌دلیل اعتبار، ظرفیت یا در دسترس نبودن مدل رد کند، پاستا می‌تواند همان مدل را با همان رزرو هزینه از مسیر جایگزین اجرا کند. قطع ارتباط پس از ارسال نامشخص درخواست، باعث اجرای دوباره نمی‌شود. این جابهجایی برای درخواست‌های عادی کیف پول فعال است؛ درخواست‌های مدیریتشدهٔ اشتراک، محدودیت‌های رزرو خود را حفظ می‌کنند.
مصرف استریم ابتدا با توکن‌های گزارششده و تعرفهٔ مدل تسویه می‌شود. وقتی رسید دقیق همان درخواست آماده شد، هزینه و مبلغ نهایی به‌صورت خودکار و بدون برداشت تکراری تطبیق داده می‌شوند. ثبت رسید ممکن است تأخیر داشته باشد. هزینهٔ درخواست ناموفق در حسابداری داخلی ثبت می‌شود و به کیف پول مشتری تحمیل نمی‌شود. مدل‌های رایگان و مدل‌های دارای نشان میزبانی ایران به مسیر خارجی پولی منتقل نمی‌شوند.