شروع کار

معرفی API وان ای آی

API وان ای آی یک دروازه‌ی سازگار با OpenAI است که چت، تصویر، صدا، ویدیو و بردار متن را با یک کلید و یک آدرس در اختیار شما می‌گذارد.

API وان ای آی (1ai) یک دروازه‌ی سازگار با OpenAI است. برنامه‌ای که با کتابخانه‌ی رسمی openai نوشته شده، فقط با عوض کردن آدرس پایه و کلید به مدل‌های چند سازنده‌ی مختلف وصل می‌شود. همه‌ی درخواست‌ها با یک کلید sk-1ai-\dots و از یک اعتبار پرداخت می‌شوند.

آدرس پایه

text https://1ai.ir/v1 همه‌ی مسیرهای این مستندات نسبت به همین آدرس هستند. مثلاً چت در POST https://1ai.ir/v1/chat/completions است. خطاها، حتی خطای احراز هویت، در قالب OpenAI برمی‌گردند تا کتابخانه‌های رسمی خطای درست را بسازند.

علاوه بر قالب OpenAI، دو قالب دیگر هم روی همین دروازه کار می‌کنند. هر کدام خطاهای قالب خودش را برمی‌گرداند.قالبمسیر اصلیکاربردOpenAI/v1/chat/completions، /v1/responses، /v1/completions، /v1/embeddings و بقیه‌ی مسیرهای /v1کتابخانه‌ی openai و ابزارهای سازگار با آنAnthropic/v1/messages و /v1/messages/count_tokensکتابخانه‌ی anthropic، Claude CodeGemini/v1beta/models/{model}:generateContent و :streamGenerateContentکتابخانه‌های Google، Gemini CLIشناسه‌ی مدل در همه‌ی قالب‌ها همان شناسه‌ی وان ای آی است و با نام سازنده شروع می‌شود، مثل openai/gpt-6-luna یا anthropic/claude-sonnet-5.5. فهرست زنده‌ی مدل‌ها و قیمت هر واحد از GET /v1/models و صفحه‌ی /models به دست می‌آید.

قالب	مسیر اصلی	کاربرد
OpenAI	`/v1/chat/completions`، `/v1/responses`، `/v1/completions`، `/v1/embeddings` و بقیه‌ی مسیرهای `/v1`	کتابخانه‌ی `openai` و ابزارهای سازگار با آن
Anthropic	`/v1/messages` و `/v1/messages/count_tokens`	کتابخانه‌ی `anthropic`، Claude Code
Gemini	`/v1beta/models/{model}:generateContent` و `:streamGenerateContent`	کتابخانه‌های Google، Gemini CLI

شروع سریع : ساخت کلید و اولین درخواست. احراز هویت : روش‌های ارسال کلید و دلیل‌های رد شدن آن. خطاها و محدودیت نرخ : قالب خطا، کدها و رفتار هنگام 429. استریم ، اعتبار ، پایداری و کش پرامپت . فهرست مدل‌ها و بعد از آن، مرجع هر مسیر: متن، خروجی ساخت‌یافته، تصویر، صدا، ویدیو، پردازش دسته‌ای، پرامپت‌ها و ابزارها. هر صفحه‌ی مرجع نمونه‌ی درخواست و پاسخ دارد و نمونه‌ی کد آن به cURL، Python و Node نوشته شده است.

کلید را از بخش توسعه‌دهندگان پنل (/app/developer) می‌سازید. مصرف از اعتباری کم می‌شود که همان‌جا می‌خرید. اشتراک چت اعتبار API نمی‌دهد و اعتبار API هم برای پیام‌های چت پنل خرج نمی‌شود.