اطلاعات این صفحه تا چند لحظه دیگر نمایش داده می‌شود.
خانواده AIaaS پاستا شامل API مدل‌ها، Embedding، بازیابی RAG، پایگاه دانش مدیریت‌شده و پردازش صوت است. این راهنما قرارداد اتصال و محدودیت‌های فعلی هر سرویس را توضیح می‌دهد.
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);مدل‌های openai/gpt-4o-mini-transcribe و openai/gpt-4o-transcribe از مسیر POST /audio/transcriptions در دسترس‌اند. فایل را به base64 خام تبدیل کنید و قالب آن را مشخص کنید. فهرست زنده و قیمت‌ها از GET /audio/models با همان کلید API دریافت می‌شود. هر درخواست تا ۱٫۴ مگابایت فایل صوتی را می‌پذیرد؛ برای صدای بلند فایل را به بخش‌های کوتاه‌تر تقسیم کنید. خطا یا گزارش مصرف ناقص هزینه ندارد.
برای تولید پاسخ صوتی، مدل openai/gpt-audio-mini را در /chat/completions با stream: true، modalities: ["text", "audio"] و audio: voice=alloy, format=pcm16 فراخوانی کنید. داده صوتی در قطعه‌های choices[0].delta.audio.data برمی‌گردد و باید به ترتیب از base64 باز شود. این مسیر با endpoint مستقل /audio/speech یکسان نیست. کیفیت صدای فارسی را با متن‌های واقعی برنامه خودتان بسنجید.
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 امضاشده از مسیر بومی Anthropic در OpenRouter عبور می‌کنند؛ مدل انتخابی باید در این مسیر پشتیبانی شود. توکن‌های استدلال هم جزو مصرف خروجی‌اند. Bearer و x-api-key پذیرفته می‌شوند و متن گفتگو در گزارش مصرف نگهداری نمی‌شود.
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 متنی فعالاند؛ صوت بلادرنگ WebSocket، قیمتگذاری چندگونه تصویر، Batch فایلمحور و Fine-tuning هنوز ارائه نمی‌شوند. شناسه مدل را تنظیمپذیر نگه دارید و خطاهای 404، 429 و 5xx را مدیریت کنید.
مدل‌های فعال و قیمت نهایی هر تصویر را در کاتالوگ تولید تصویر مقایسه کنید یا با GET /images بخوانید. درخواست POST /images فعلاً فقط یک تصویر با خروجی b64_json می‌سازد؛ اندازه، کیفیت، تصویر مرجع و چند خروجی پشتیبانی نمی‌شوند. تعرفه‌های وابسته به کیفیت، اندازه یا مگاپیکسل تا زمانی که رزرو دقیق داشته باشند در کاتالوگ این مسیر ظاهر نمی‌شوند. هزینه پیش از اجرا رزرو و پس از پاسخ تسویه می‌شود؛ اگر رسید هزینهٔ ارائه‌دهنده موجود نباشد، قیمت ثابت نمایش‌داده‌شده مبنای تسویه است و تصویر رایگان تحویل نمی‌شود.
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"}'مدل‌های دارای نرخ روشن به‌ازای نویسه از GET /audio/speech نمایش داده می‌شوند. در POST /audio/speech متن حداکثر ۴۰۰۰ نویسه، صدای پشتیبانی‌شده مدل و فرمت mp3 یا pcm بفرستید. پاسخ فایل صوتی خام است؛ مبلغ نهایی تومانی در هدر x-paasta-charged-toman و شناسه مصرف در x-paasta-request-id است. نرخ بر پایه نویسهٔ ورودی محاسبه می‌شود؛ این مسیر صوت WebSocket بلادرنگ نیست.
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