API هوش مصنوعی نِت اَرز یک نشانی و یک کلید برای مدل‌های زبانی و چندرسانه‌ای است. مدل‌های OpenAI، Google Gemini و DeepSeek را مستقیم وصل کرده‌ایم و Claude، Grok، Mistral، Llama، Qwen و صدها مدل دیگر را از راه OpenRouter. اعتبار را تومانی می‌خرید. رابطش همان رابط OpenAI است؛ پس هر SDK، کتابخانه یا ابزاری که با OpenAI کار می‌کند، بدون تغییر کد با نِت اَرز هم کار می‌کند.
https://netarz.ir/api/ai/v1. کلید دسترسی (API Key) شما با sk-ntz-v1- شروع می‌شود و در هدر Authorization: Bearer فرستاده می‌شود.
چه چیزی به دست می‌آورید
فقط نام مدل را عوض می‌کنید؛ فرق‌های قالب هر سرویس‌دهنده را ما در سمت خودمان یکی می‌کنیم.
اعتبار را از درگاه بانکی یا کیف پول می‌خرید؛ حداقل ۵۰,۰۰۰ تومان، به‌علاوهٔ ۹٪ مالیات. اعتبار به دلار نگه داشته می‌شود تا بالا رفتن نرخ ارز از آن کم نکند.
پاسخ تکه‌به‌تکه با Server-Sent Events و در قالب OpenAI می‌رسد؛ برای Claude، Gemini و مدل‌های OpenRouter هم.
اگر سرویس‌دهنده خطا بدهد، چیزی از اعتبارتان کم نمی‌شود. فقط درخواست موفق هزینه دارد.
مدل‌ها و IPهای مجاز، سقف هزینه، تاریخ انقضا و باطل کردن فوری برای هر کلید؛ بودجهٔ ماهانه برای هر پروژه.
مصرف روزانه به تفکیک پروژه، کلید و مدل؛ در پنل و از GET /usage.
یک تغییر، همهٔ مدل‌ها
اگر الان از SDK رسمی OpenAI استفاده می‌کنید، فقط دو مقدار عوض می‌شود: نشانی پایه و کلید.
from openai import OpenAI
client = OpenAI(
base_url="https://netarz.ir/api/ai/v1", # ← فقط همین خط عوض می‌شود
api_key="sk-ntz-v1-...", # ← و کلید نِت اَرز به‌جای کلید OpenAI
)
response = client.chat.completions.create(
model="openrouter/anthropic/claude-sonnet-4.5", # یا gpt-4o-mini، gemini-3.5-flash، deepseek-v4-flash، …
messages=[{"role": "user", "content": "سلام، خودتان را معرفی کنید."}],
)
print(response.choices[0].message.content)نمونه‌کد Node.js، PHP، Go، cURL، n8n، LangChain و Vercel AI SDK در صفحهٔ SDKها است.
نقطه‌های اتصال (Endpoints)
| Endpoint | نوع مدل | کاربرد | راهنما |
|---|---|---|---|
POST /chat/completions | chat | گفت‌وگو، ابزارها، بینایی، JSON، استدلال (اصلی‌ترین endpoint) | Chat Completions |
POST /responses | chat | Responses API مدل‌های OpenAI با ابزارهای داخلی (جستجوی وب و…) | Responses |
POST /completions | chat | سازگاری با ابزارهای قدیمی؛ prompt به یک پیام کاربر تبدیل می‌شود | Chat Completions |
POST /embeddings | embedding | بردارسازی متن برای جستجوی معنایی و RAG | Embeddings |
POST /images/generations | image | تولید و ویرایش تصویر (GPT Image و Nano Banana) | تصویر |
POST /audio/transcriptions | audio | گفتار به متن | صوت |
POST /audio/translations | audio | ترجمهٔ صوت به انگلیسی | صوت |
POST /audio/speech | audio | متن به گفتار | صوت |
POST /videos | video | ساخت ویدیو با Sora و Veo؛ پاسخ یک «کار» است و فایل را بعد می‌گیرید | ویدیو |
POST /audio/music | music | ساخت موسیقی با Lyria | موسیقی |
POST /moderations | moderation | پایش محتوا — فعلاً مدلی برای این خانواده وصل نیست | پایش محتوا |
GET /models | — | فهرست عمومی مدل‌ها با قیمت (بدون کلید) | مدل‌ها |
GET /me · /usage · /requests/{id} | — | موجودی، گزارش مصرف و وضعیت یک درخواست | حساب و مصرف |
هزینه چطور محاسبه می‌شود
هر مدل برای هر یک میلیون توکن (Token؛ تکه‌های کوچک متن که مدل می‌شمارد) ورودی و خروجی قیمت مشخصی دارد. تصویر هم توکنی حساب می‌شود؛ صوت برای هر دقیقه یا توکنی، متن‌به‌گفتار برای هر یک میلیون نویسه یا توکنی، ویدیو برای هر ثانیه و موسیقی برای هر قطعه. پیش از هر درخواست، برآورد هزینه موقتاً کنار گذاشته می‌شود؛ بعد از پاسخ، فقط مصرف واقعی کم می‌شود و بقیه آزاد می‌شود. قیمت‌ها را در صفحهٔ مدل‌ها و قیمت‌ها ببینید و جزئیات را در صورت‌حساب و اعتبار بخوانید.
محدودیت‌های پیش‌فرض
اگر سقف بیشتری لازم دارید، با تیکت و شرح کارتان درخواست بدهید. پیش از احراز هویت، سقف کل مصرف حساب $2 است. جزئیات در محدودیت‌ها و امنیت.