گرفتن کلید API هوش مصنوعی از ایران

برای این‌که برنامه، ربات یا سایت شما با هوش مصنوعی کار کند، یک کلید دسترسی (API Key) لازم دارید: رشته‌ای که هر درخواست را به حساب شما وصل می‌کند و هزینه‌اش را از اعتبار همان حساب برمی‌دارد. دو راه دارید. کلید را از خود سازندهٔ مدل بگیرید، یعنی OpenAI برای GPT، گوگل برای Gemini و DeepSeek برای مدل‌های خودش؛ یا یک کلید گیسو بسازید که همهٔ این مدل‌ها را از یک نشانی جواب می‌دهد.

این صفحه می‌گوید هر سازنده از کاربر ایران چه می‌خواهد، کلید گیسو چطور ساخته می‌شود، چه چیزهایی هزینه ندارد و با یک کلید چطور سه مدل را صدا بزنید.

گرفتن کلید از خود سازنده: شرط هر کدام

هر سازنده حساب توسعه‌دهندهٔ جدا، روش پرداخت خودش و فهرست کشورهای خودش را دارد. این جدول همان چیزی است که پیش از ثبت‌نام باید بدانید:

کلیدی که از سازنده می‌گیرید فقط مدل‌های همان سازنده را جواب می‌دهد؛ برای GPT، Gemini و Claude سه حساب، سه کلید و سه صورتحساب جدا دارید. فهرست کشورها و روش‌های پرداخت را خود سازنده‌ها گاهی عوض می‌کنند؛ پیش از ثبت‌نام، صفحهٔ رسمی همان شرکت را بخوانید.

یک کلید گیسو به‌جای چند حساب خارجی

گیسو، برند هوش مصنوعی نِت اَرز، یک وب‌سرویس سازگار با OpenAI است: برنامهٔ شما فقط به https://gisoo.pro/api/v1 وصل می‌شود و گیسو درخواست را به سرویس‌دهندهٔ همان مدل می‌رساند. مدل‌ها ساخت ما نیستند و روی سرورهای سازنده‌شان اجرا می‌شوند؛ کاری که گیسو برایتان می‌کند این است که حساب، کلید و پرداخت یکی شود.

• همهٔ مدل‌های گیسو با یک کلید: کلید sk-gisoo-v1-… مدل‌های GPT، Gemini، DeepSeek، Claude، Grok، Qwen و بقیهٔ ۶۶۴ مدل فهرست را جواب می‌دهد. برای عوض کردن مدل فقط شناسهٔ آن را عوض می‌کنید.
• پرداخت با کارت بانکی: حساب را در درگاه بانکی نِت اَرز شارژ می‌کنید و اعتبار به دلار در حسابتان می‌نشیند. شارژ از ۵۰٬۰۰۰ سکه شروع می‌شود و اشتراک ماهانه ندارد.
• از سرور داخل ایران: سرور، هاست یا کامپیوتر شما بدون فیلترشکن به gisoo.pro وصل می‌شود؛ آزمایش اتصال از سرور را ببینید.
• همان کد OpenAI: SDK رسمی OpenAI در پایتون، Node.js، PHP، Go و .NET با عوض کردن نشانی پایه و کلید کار می‌کند. Claude Code و SDK شرکت Anthropic هم مسیر سازگار با Anthropic را دارند.

ساخت کلید API در گیسو، قدم‌به‌قدم

1. وارد اپ گیسو شوید

   از gisoo.pro/app با شمارهٔ موبایل و کد پیامکی. اگر در نِت اَرز حساب دارید، همان حساب است.

2. حساب را شارژ کنید

   در بخش اعتبار، از ۵۰٬۰۰۰ سکه. تا ۲ دلار مصرف احراز هویت نمی‌خواهد؛ بعد از آن یک بار هویتتان را در اپ تأیید می‌کنید.

3. پروژه و کلید بسازید

   در بخش API یک پروژه و برایش یک کلید بسازید. کلید فقط همین یک بار نشان داده می‌شود؛ همان لحظه جایی امن نگهش دارید.

4. کلید را بیازمایید

   دو دستور پایین هزینه ندارند: اولی فهرست مدل‌ها را می‌دهد و دومی موجودی و محدودیت‌های کلیدتان را.

برای سرورها و کاربران داخل ایران، در این نمونه نشانی gisoo.pro را با ir.gisoo.pro جایگزین کنید؛ مسیر و کلید همان‌اند.

# 1) The model list: no key, no cost.
curl -s https://gisoo.pro/api/v1/models | head -c 400

# 2) Your key, its limits and the credit left (no cost either).
curl -s https://gisoo.pro/api/v1/me -H "Authorization: Bearer $GISOO_API_KEY"

اگر دیدن کار را به خواندنش ترجیح می‌دهید، فیلم کوتاه ساخت پروژه و کلید در گیسو همین قدم‌ها را روی صفحه‌های واقعی اپ نشان می‌دهد.

جمینای، دیپ‌سیک و GPT با یک کلید

این نمونه یک سؤال را به سه مدل از سه سازنده می‌فرستد. کلید یکی است، نشانی یکی است و فقط model عوض می‌شود. برای Claude، شناسه‌ای مثل openrouter/anthropic/claude-sonnet-4.5 را در همین فهرست بگذارید.

برای سرورها و کاربران داخل ایران، در این نمونه نشانی gisoo.pro را با ir.gisoo.pro جایگزین کنید؛ مسیر و کلید همان‌اند.

import os
from openai import OpenAI

# One key, one base URL — three vendors.
client = OpenAI(base_url="https://gisoo.pro/api/v1", api_key=os.environ["GISOO_API_KEY"])

for model in ["gpt-4o-mini", "gemini-3.6-flash", "deepseek-v4-flash"]:
    reply = client.chat.completions.create(
        model=model,
        max_tokens=120,
        messages=[{"role": "user", "content": "In one Persian sentence: what is an API key?"}],
    )
    print(model, "→", reply.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://gisoo.pro/api/v1", apiKey: process.env.GISOO_API_KEY });

for (const model of ["gpt-4o-mini", "gemini-3.6-flash", "deepseek-v4-flash"]) {
  const reply = await client.chat.completions.create({
    model,
    max_tokens: 120,
    messages: [{ role: "user", content: "In one Persian sentence: what is an API key?" }],
  });
  console.log(model, "→", reply.choices[0].message.content);
}

کدی دارید که با کلید OpenAI کار می‌کند؟ SDKهای رسمی OpenAI این دو متغیر محیطی را خودشان می‌خوانند، پس گاهی همین کافی است:

برای سرورها و کاربران داخل ایران، در این نمونه نشانی gisoo.pro را با ir.gisoo.pro جایگزین کنید؛ مسیر و کلید همان‌اند.

# Linux / macOS — before: OPENAI_API_KEY + api.openai.com
export OPENAI_BASE_URL="https://gisoo.pro/api/v1"
export OPENAI_API_KEY="sk-gisoo-v1-..."

کلید API هوش مصنوعی رایگان هست؟

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

• هزینه ندارد: ساختن حساب، پروژه و کلید؛ گرفتن فهرست مدل‌ها با GET /models؛ دیدن موجودی و محدودیت‌ها با GET /me؛ و درخواستی که پیش از تولید پاسخ با خطا تمام شود.
• هزینه دارد: هر درخواستی که جواب بگیرد، به‌اندازهٔ توکن، تصویر، ثانیهٔ ویدیو یا نویسهٔ صدایی که ساخته شده. مدل رایگان در فهرست گیسو نیست.
• اعتبار هدیه: فعلاً اعتبار هدیهٔ ثبت‌نام نداریم.
• سهمیهٔ رایگان سازنده‌ها: بعضی سازنده‌ها، مثل گوگل در AI Studio، سهمیهٔ رایگان محدودی دارند، ولی فقط برای کشورهای پشتیبانی‌شدهٔ خودشان.

کلید سازنده یا کلید گیسو

اگر حساب خارجی معتبر دارید و فقط با یک سازنده کار می‌کنید، کلید خود همان شرکت هم کافی است. اگر از ایران کار می‌کنید یا چند مدل را کنار هم می‌خواهید، کلید گیسو حساب و پرداخت را یکی می‌کند.

کلید را امن نگه دارید

• کلید را روی سرور خودتان نگه دارید، نه در کد مرورگر یا اپ موبایل؛ هر کسی کلید را ببیند، با اعتبار شما درخواست می‌فرستد.
• برای هر برنامه یک کلید جدا بسازید و برایش سقف هزینه، فهرست مدل مجاز و اگر سرورتان IP ثابت دارد، فهرست IP مجاز بگذارید.
• کلیدی را که لو رفته همان لحظه باطل کنید و کلید تازه بسازید؛ جزئیاتش در احراز هویت و کلیدها آمده است.

پرسش‌های پرتکرار

قدم بعدی