شروع سریع

1. ثبت‌نام و شارژ اعتبار با شمارهٔ موبایل در نِت اَرز ثبت‌نام کنید و از پنل «API هوش مصنوعی» اعتبار بخرید. حداقل شارژ ۵۰,۰۰۰ تومان است و ۹٪ مالیات بر ارزش افزوده پیش از پرداخت جدا نشان داده می‌شود. از کیف پول نِت اَرز یا درگاه بانکی پرداخت می‌کنید و اعتبار به دلار در حساب شما می‌نشیند. پیش از احراز هویت، سقف کل مصرف حساب $2 است.
2. ساخت پروژه و کلید API در پنل یک پروژه بسازید (مثلاً «ربات تلگرام») و برای آن یک کلید دسترسی (API Key) بسازید. کلید کامل را فقط یک بار نشان می‌دهیم؛ آن را جای امنی مثل متغیر محیطی یا برنامهٔ مدیریت رمز نگه دارید. برای هر کلید می‌توانید مدل‌ها و IPهای مجاز، سقف هزینه و تاریخ انقضا بگذارید.
3. اولین درخواست نشانی پایه را https://netarz.ir/api/ai/v1 بگذارید و کلید را در هدر Authorization: Bearer بفرستید:
   Python Node.js cURL PHP

   Python

   # pip install openai
   from openai import OpenAI
   
   client = OpenAI(
       base_url="https://netarz.ir/api/ai/v1",
       api_key="sk-ntz-v1-...",
   )
   
   response = client.chat.completions.create(
       model="gpt-4o-mini",
       messages=[
           {"role": "system", "content": "تو دستیار فارسی‌زبان فروشگاه ما هستی."},
           {"role": "user", "content": "یک شعار کوتاه برای فروشگاه لوازم ورزشی بنویسید."},
       ],
       max_tokens=200,
   )
   
   print(response.choices[0].message.content)
   print(response.usage)

   Node.js

   // npm install openai
   import OpenAI from "openai";
   
   const client = new OpenAI({
     baseURL: "https://netarz.ir/api/ai/v1",
     apiKey: process.env.NETARZ_API_KEY,
   });
   
   const response = await client.chat.completions.create({
     model: "gpt-4o-mini",
     messages: [
       { role: "system", content: "تو دستیار فارسی‌زبان فروشگاه ما هستی." },
       { role: "user", content: "یک شعار کوتاه برای فروشگاه لوازم ورزشی بنویسید." },
     ],
     max_tokens: 200,
   });
   
   console.log(response.choices[0].message.content);
   console.log(response.usage);

   cURL

   curl https://netarz.ir/api/ai/v1/chat/completions \
     -H "Authorization: Bearer $NETARZ_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "gpt-4o-mini",
       "messages": [
         {"role": "system", "content": "تو دستیار فارسی‌زبان فروشگاه ما هستی."},
         {"role": "user", "content": "یک شعار کوتاه برای فروشگاه لوازم ورزشی بنویسید."}
       ],
       "max_tokens": 200
     }'

   PHP

   use Illuminate\Support\Facades\Http;
   
   $response = Http::withToken(env('NETARZ_API_KEY'))
       ->timeout(120)
       ->post('https://netarz.ir/api/ai/v1/chat/completions', [
           'model' => 'gpt-4o-mini',
           'messages' => [
               ['role' => 'system', 'content' => 'تو دستیار فارسی‌زبان فروشگاه ما هستی.'],
               ['role' => 'user', 'content' => 'یک شعار کوتاه برای فروشگاه لوازم ورزشی بنویسید.'],
           ],
           'max_tokens' => 200,
       ]);
   
   echo $response->json('choices.0.message.content');

4. خواندن پاسخ پاسخ در همان قالب OpenAI است. فیلد id شناسهٔ درخواست در نِت اَرز است (همان مقدار هدر X-Request-Id) و usage تعداد توکن‌های مصرف‌شده را نشان می‌دهد؛ هزینه از روی همین حساب می‌شود:
   پاسخ

   {
     "id": "req_9f2c1e0b7a6d4c3f8e1a2b3c",
     "object": "chat.completion",
     "created": 1756540800,
     "model": "gpt-4o-mini",
     "choices": [
       {
         "index": 0,
         "message": { "role": "assistant", "content": "هر قدم، یک رکورد تازه." },
         "finish_reason": "stop"
       }
     ],
     "usage": {
       "prompt_tokens": 41,
       "completion_tokens": 14,
       "total_tokens": 55,
       "prompt_tokens_details": { "cached_tokens": 0 }
     }
   }

انتخاب مدل

فهرست مدل‌های فعال را با قیمت دلاری و تومانی، بدون کلید، از این نشانی بگیرید:

curl https://netarz.ir/api/ai/v1/models?type=chat

شناسهٔ هر مدل (فیلد id) را در پارامتر model بفرستید؛ مثلاً gpt-4o-mini، openrouter/anthropic/claude-sonnet-4.5، gemini-3.5-flash، deepseek-v4-flash یا openrouter/meta-llama/llama-3.3-70b-instruct. فهرست کامل را در صفحهٔ مدل‌ها و قیمت‌ها ببینید.

قدم‌های بعدی