‏GPT API: استفاده از مدل‌های GPT-6 در کدهای خودتان

توسعه‌دهندگان از طریق API اختصاصی OpenAI یا سرویس‌هایی مانند OpenRouter به مدل‌های GPT دسترسی دارند. این راهنما اولین درخواست، شناسه‌های مدل، تنظیمات استدلال و هزینه‌های هر مدل را بررسی می‌کند.

زمان مطالعه: 7 دقیقهبه‌روزرسانی

دو روش برای فراخوانی GPT از طریق کد

اگر می‌خواهید از GPT در برنامه، اسکریپت یا فایل اکسل خود استفاده کنید، به دسترسی API نیاز دارید. دو روش رایج برای این کار وجود دارد:

  • API رسمی OpenAI در آدرس https://api.openai.com/v1. شما در پلتفرم OpenAI ثبت‌نام می‌کنید، اطلاعات پرداخت را اضافه می‌کنید، یک کلید (API Key) می‌سازید و مدل‌هایی مانند gpt-6-luna یا gpt-6.1-terra را مستقیماً فراخوانی می‌کنید.
  • OpenRouter در آدرس https://openrouter.ai/api/v1. تنها با یک کلید، علاوه بر GPT به مدل‌های سایر شرکت‌ها نیز دسترسی خواهید داشت؛ آن هم با ساختار درخواست کاملاً یکسان برای همه آن‌ها. شناسه‌های مدل‌های GPT در اینجا پیشوند openai/ دارند؛ مثلاً openai/gpt-6-luna.

هزینه در هر دو سرویس بر اساس توکن محاسبه می‌شود؛ یعنی همان بخش‌های کوچکی از متن که مدل می‌خواند و می‌نویسد. هزینه ورودی (پرامپت شما) و خروجی (پاسخ مدل) جداگانه محاسبه می‌شود و خروجی همیشه گران‌تر است. توکن‌های استدلال (Reasoning tokens) یا همان «تفکر» پنهانی مدل پیش از پاسخ‌دهی نیز به عنوان خروجی محاسبه می‌شوند.

یک نکته مهم پیش از شروع: GPT.me هیچ API عمومی ارائه نمی‌دهد. چت ما یک وب‌سایت برای کاربران عادی است. برای استفاده در کد، از یکی از دو روش بالا استفاده کنید.

قیمت‌های فعلی GPT

قیمت‌ها به ازای هر یک میلیون توکن برای مدل‌های فعلی GPT-6، بر اساس فهرست OpenRouter؛ قیمت‌های پایه در API خود OpenAI نیز یکسان است.

مدلشناسه API (در OpenAI)ورودیورودی کش‌شده (Cached)خروجی
GPT-6 Lunagpt-6-luna$0.10$0.01$0.50
GPT-6.1 Terragpt-6.1-terra$1$0.05$5
GPT-6 Solgpt-6-sol$2$0.20$10
GPT-6.1 Solgpt-6.1-sol$2$0.10$10
GPT-6 Astragpt-6-astra$10$1$50

تعرفه‌های OpenRouter، نوامبر ۲۰۲۶. هر پنج مدل از متن و تصویر پشتیبانی می‌کنند، خروجی متنی دارند و دارای پنجره زمینه (Context Window) ۱,۰۵۰,۰۰۰ توکنی با امکان تولید حداکثر ۱۲۸,۰۰۰ توکن خروجی هستند. اگر یک پرامپت تکی از ۲۷۲,۰۰۰ توکن فراتر برود، OpenRouter برای آن درخواست هزینه ورودی را دو برابر و هزینه خروجی را ۵۰ درصد افزایش می‌دهد. همچنین OpenRouter نسخه‌های «pro» این مدل‌ها را نیز ارائه می‌دهد که همان مدل را در حالتی اجرا می‌کنند که توکن‌های استدلال بسیار بیشتری مصرف می‌کند.

فراخوانی مستقیم OpenAI

OpenAI دو اندپوینت برای متن ارائه می‌دهد: اندپوینت جدیدتر Responses API که در سراسر مستندات GPT-6 استفاده شده، و اندپوینت قدیمی‌تر Chat Completions که همچنان برای چت‌های ساده کار می‌کند. یک کلید در پلتفرم بسازید، آن را در یک متغیر محیطی به نام OPENAI_API_KEY ذخیره کنید و سپس درخواست بفرستید. نمونه با curl:

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-luna",
    "reasoning": { "effort": "none" },
    "input": "List three uses for a paper clip, one line each."
  }'

پاسخ در قالب JSON برمی‌گردد و متن تولیدشده داخل آرایه output قرار دارد. کتابخانه رسمی پایتون این مقدار را به راحتی استخراج می‌کند:

from openai import OpenAI

client = OpenAI()  # متغیر OPENAI_API_KEY را می‌خواند

result = client.responses.create(
    model="gpt-6.1-terra",
    reasoning={"effort": "low"},
    input="Is 391 a prime number? Explain in two sentences.",
)
print(result.output_text)

می‌توانید آن را با دستور pip install openai نصب کنید. این کتابخانه برای JavaScript و چندین زبان دیگر نیز در دسترس است.

فراخوانی GPT از طریق OpenRouter

از آنجا که OpenRouter از ساختار Chat Completions استفاده می‌کند، اکثر کدهای سازگار با OpenAI پس از تغییر آدرس پایه (Base URL)، کلید و شناسه مدل، به درستی کار خواهند کرد. بخش شروع سریع آن جزئیات را توضیح داده است. یک مثال ساده با JavaScript بدون نیاز به هیچ کتابخانه اضافی:

const OPENROUTER_URL = "https://openrouter.ai/api/v1/chat/completions";

const payload = {
  model: "openai/gpt-6-luna",
  max_tokens: 800,
  reasoning: { effort: "low" },
  messages: [
    { role: "system", content: "Answer briefly and plainly." },
    { role: "user", content: "What is the difference between RAM and storage?" },
  ],
};

const key = process.env.OPENROUTER_API_KEY;

const res = await fetch(OPENROUTER_URL, {
  method: "POST",
  body: JSON.stringify(payload),
  headers: { Authorization: `Bearer ${key}`, "Content-Type": "application/json" },
});

const body = await res.json();
const text = body.choices?.[0]?.message?.content;
console.log(text ?? body);

این کد را با Node نسخه 18 یا بالاتر که به طور پیش‌فرض دارای fetch است اجرا کنید؛ فایل را با پسوند .mjs ذخیره کنید تا await در سطح بالا کار کند. اگر متنی برنگردد، اسکریپت کل پاسخ را چاپ می‌کند: در صورت بروز مشکل (مثل اشتباه بودن کلید یا اتمام اعتبار)، OpenRouter فیلد error را همراه با پیامی خوانا بازمی‌گرداند.

صفحات اختصاصی مدل‌ها در OpenRouter، مانند GPT-6 Luna و GPT-6.1 Terra، قیمت‌های لحظه‌ای، ارائه‌دهندگان و پارامترهای پشتیبانی‌شده را نمایش می‌دهند.

تنظیماتی که معمولاً دردسرساز می‌شوند

  • میزان استدلال (Reasoning effort). مدل‌های GPT-6 Luna، GPT-6 Sol و GPT-6.1 Terra مقادیر none، low، medium، high، xhigh و max را می‌پذیرند و به طور پیش‌فرض در OpenRouter روی medium تنظیم شده‌اند. مدل‌های GPT-6.1 Sol و GPT-6 Astra همیشه استدلال می‌کنند و نمی‌توان آن‌ها را روی none قرار داد. این فیلد در Responses API به صورت reasoning.effort و در Chat Completions به صورت reasoning_effort نوشته می‌شود.
  • پارامتر Temperature. طبق راهنمای OpenAI، هنگام فعال بودن قابلیت استدلال، پارامترهای temperature و top_p پشتیبانی نمی‌شوند؛ بنابراین مگر در حالتی که effort روی none باشد، آن‌ها را حذف کنید. کدهای قدیمی‌تری که temperature را مقداردهی می‌کنند ممکن است با خطا مواجه شوند.
  • محدودیت سقف خروجی. استدلال بخشی از سهمیه توکن شما را مصرف می‌کند. اگر مقدار max_tokens را کم و effort را بالا بگذارید، ممکن است توکن‌های مدل قبل از نوشتن پاسخ نهایی تمام شود.
  • ابزارها (Tools). در صفحه مدل‌های OpenAI ذکر شده که فراخوانی تابع (Function calling) برای GPT-6.1 Terra به Responses API نیاز دارد. اگر ابزارها در Chat Completions عملکرد درستی ندارند، اندپوینت را تغییر دهید.

راهکارهایی برای کاهش هزینه‌ها

  1. با Luna شروع کنید. با یک دهم قیمت Terra، این مدل برای خلاصه‌سازی، استخراج اطلاعات، دسته‌بندی و پاسخ‌های کوتاه فوق‌العاده است. فقط برای کارهایی که در آن‌ها خطا دارد به سراغ مدل‌های بالاتر بروید.
  2. میزان استدلال را پایین نگه دارید. هر درجه افزایش در reasoning effort معمولاً به معنای مصرف توکن‌های خروجی پنهان بیشتر است. برای کارهای ساده از none یا low استفاده کنید.
  3. دستورات اولیه (Prefix) را دوباره استفاده کنید. ورودی کش‌شده (Cached) حداقل ۱۰ برابر ارزان‌تر از ورودی جدید است. دستورالعمل‌های طولانی و ثابت را در ابتدای همه پرامپت‌ها قرار دهید تا در درخواست‌های تکراری از کش استفاده شود.
  4. زیر ۲۷۲,۰۰۰ توکن بمانید تا در صورت امکان، مشمول هزینه اضافی پردازش زمینه‌های طولانی (Long-context surcharge) نشوید.
  5. سقف هزینه تعیین کنید. در داشبورد حساب خود یک سقف مصرف مشخص کنید تا در صورت وجود باگ در یک حلقه، هزینه سنگینی به بار نیاید.
  6. تاریخچه مکالمات ارسالی را خلاصه کنید. در هر درخواست، هزینه کل تاریخچه گفتگو دوباره محاسبه می‌شود. فقط پیام‌هایی را بفرستید که مدل واقعاً به آن‌ها نیاز دارد، یا پیام‌های قبلی را با یک خلاصه کوتاه جایگزین کنید.

یک روش سرانگشتی برای تخمین هزینه: هر توکن تقریباً برابر با سه چهارم یک کلمه انگلیسی است. یک پرسش و پاسخ چندصد کلمه‌ای در مجموع حدود هزار توکن مصرف می‌کند؛ بنابراین هزینه هر درخواست تقریباً برابر با تعرفه هر میلیون توکن در جدول، تقسیم بر هزار (به علاوه هرگونه توکن استدلال) خواهد بود. برای مشاهده ارقام دقیق پرامپت‌های خود، فیلد usage را در پاسخ‌ها بررسی کنید.

برای دریافت راهنمایی‌های برنامه‌نویسی فراتر از خود API، راهنمای GPT برای برنامه‌نویسی و صفحه ویژه توسعه‌دهندگان ما را ببینید. برای تست یک پرامپت قبل از کدنویسی، می‌توانید ابتدا آن را در بخش چت با GPT-6 Luna امتحان کنید.

پرسش‌های متداول

آیا API مربوط به GPT رایگان است؟

خیر. OpenAI و OpenRouter هر دو هزینه را بر اساس توکن دریافت می‌کنند. یک تست کوتاه با GPT-6 Luna کمتر از یک سنت هزینه دارد، اما همچنان به یک حساب کاربری با اطلاعات پرداخت فعال نیاز خواهید داشت.

از API مستقیم OpenAI استفاده کنم یا OpenRouter؟

اگر فقط به GPT نیاز دارید و می‌خواهید جدیدترین امکانات OpenAI را بلافاصله دریافت کنید، مستقیماً از OpenAI استفاده کنید. اگر می‌خواهید با یک کلید و یک صورت‌حساب بین GPT، Claude، Gemini و سایر مدل‌ها جابه‌جا شوید، OpenRouter را انتخاب کنید.

با کدام مدل شروع کنم؟

مدل GPT-6 Luna به خاطر سرعت بالا و قیمت اقتصادی، GPT-6.1 Terra برای نگارش بهتر، درک تصویر و استدلال‌های پیچیده‌تر، و GPT-6.1 Sol یا GPT-6 Astra تنها برای سنگین‌ترین پروژه‌های کدنویسی و تحلیلی پیشنهاد می‌شوند.

آیا GPT.me رابط API دارد؟

خیر. وب‌سایت GPT.me یک پلتفرم رایگان چت متنی است. برای دسترسی از طریق کدنویسی، از API رسمی OpenAI یا OpenRouter استفاده کنید.

سؤالی دارید؟ همین الان بپرسید

بدون نیاز به حساب کاربری و دانلود. چت را باز کنید، سؤال خود را بنویسید و در عرض یکی دو ثانیه پاسخ را ببینید.

شروع چت