مستندات API هوش مصنوعی

API هوش مصنوعی گره یک درگاه واحد برای مدل‌های Claude، GPT، Gemini، DeepSeek و دیگران است. همان API رسمی هر سازنده را روی آدرس گره صدا می‌زنید؛ گره درخواست را به مدل می‌رساند، پاسخ را در همان فرمتی که فرستاده‌اید برمی‌گرداند و هزینه را به تومان از کیف پول کم می‌کند.

شروع سریع

1. در گره ثبت‌نام کنید و کیف پول را شارژ کنید.
2. در پنل › API هوش مصنوعی یک کلید بسازید. کلید با gk- شروع می‌شود و فقط یک بار نمایش داده می‌شود.
3. در برنامه یا ابزارتان آدرس پایه را به https://api.gereh.dev تغییر دهید و کلید را به‌جای کلید OpenAI، Anthropic یا Gemini بگذارید.

نشانی پایه

https://api.gereh.dev

برای SDKهای OpenAI آدرس https://api.gereh.dev/v1 و برای Anthropic و Gemini خود https://api.gereh.dev را بدهید.

احراز هویت

کلید را به یکی از این روش‌ها بفرستید (هر SDK روش خودش را خودکار به‌کار می‌برد):

مسیرها

Claude Code

Claude Code مستقیم با فرمت Anthropic به گره وصل می‌شود؛ ابزارها، استریم و فایل‌خوانی همه کار می‌کنند.

export ANTHROPIC_BASE_URL=https://api.gereh.dev
export ANTHROPIC_AUTH_TOKEN=gk-YOUR-KEY
export ANTHROPIC_MODEL=claude-opus-5.5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4.5
claude

Codex CLI

در ‎~/.codex/config.toml بگذارید و کلید را در متغیر GEREH_API_KEY قرار دهید (export GEREH_API_KEY=…).

model = "gpt-5.5"
model_provider = "gereh"

[model_providers.gereh]
name = "Gereh"
base_url = "https://api.gereh.dev/v1"
env_key = "GEREH_API_KEY"
wire_api = "responses"

OpenAI SDK و ابزارهای سازگار

هر برنامه یا کتابخانه سازگار با OpenAI (LangChain، n8n، Cursor، Continue، LibreChat…) فقط با تغییر base URL کار می‌کند.

from openai import OpenAI

client = OpenAI(base_url="https://api.gereh.dev/v1", api_key="gk-YOUR-KEY")
r = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "سلام!"}],
)
print(r.choices[0].message.content)

در Cursor: Settings › Models › OpenAI API Key، کلید گره را وارد و «Override OpenAI Base URL» را روی https://api.gereh.dev/v1 بگذارید. در n8n، اعتبارنامه OpenAI را با Base URL همین آدرس بسازید.

Anthropic SDK

SDK رسمی Anthropic؛ ابزارها (tool use)، تصویر و استریم پشتیبانی می‌شوند.

import anthropic

client = anthropic.Anthropic(base_url="https://api.gereh.dev", api_key="gk-YOUR-KEY")
msg = client.messages.create(
    model="claude-sonnet-5.5", max_tokens=1024,
    messages=[{"role": "user", "content": "سلام!"}],
)
print(msg.content[0].text)

Gemini SDK

SDK گوگل (google-genai) با آدرس گره؛ مدل‌های دیگر هم با همین فرمت قابل فراخوانی‌اند.

from google import genai

client = genai.Client(api_key="gk-YOUR-KEY", http_options={"base_url": "https://api.gereh.dev"})
r = client.models.generate_content(model="gemini-3.8-flash", contents="سلام!")
print(r.text)

cURL

ساده‌ترین تست از ترمینال.

curl https://api.gereh.dev/v1/chat/completions \
  -H "Authorization: Bearer gk-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"سلام!"}]}'

استریم

در همه فرمت‌ها استریم پشتیبانی می‌شود: "stream": true در OpenAI و Anthropic و مسیر :streamGenerateContent?alt=sse در Gemini. رویدادها دقیقاً با قالب رسمی هر سازنده ارسال می‌شوند، پس SDKها و ابزارها بدون تغییر کار می‌کنند. در OpenAI Chat برای دریافت مصرف توکن در انتهای استریم "stream_options": {"include_usage": true} بفرستید.

هزینه و صورتحساب

• هزینه هر درخواست = (توکن ورودی × قیمت ورودی + توکن خروجی × قیمت خروجی) ÷ ۱٬۰۰۰٬۰۰۰، به تومان و رو به بالا.
• پیش از ارسال، حداکثر هزینه ممکن (بر اساس max_tokens) از کیف پول رزرو و بلافاصله پس از پاسخ، مازاد آن برگردانده می‌شود. اگر max_tokens نفرستید ۸٬۱۹۲ در نظر گرفته می‌شود.
• درخواست ناموفق (خطای سرویس‌دهنده) هیچ هزینه‌ای ندارد.
• هر پاسخ موفق هدر x-gereh-charged-toman (هزینه به تومان) و x-gereh-request-id (شناسه پیگیری) دارد.
• مصرف هر ۱۰ دقیقه در یک تراکنش «مصرف» در صورتحساب جمع می‌شود.

محدودیت‌ها

• برای هر کلید می‌توانید سقف هزینه روزانه و ماهانه، فهرست مدل‌های مجاز، تعداد درخواست در دقیقه (پیش‌فرض ۱۲۰، حداکثر ۶۰۰) و تاریخ انقضا تعیین کنید.
• حداکثر حجم هر درخواست ۱۶ مگابایت است.
• در Responses API حالت ذخیره سمت سرور (previous_response_id، background، conversation) پشتیبانی نمی‌شود؛ تاریخچه را در input بفرستید. Codex به‌طور پیش‌فرض همین کار را می‌کند.
• متن درخواست‌ها و پاسخ‌ها ذخیره نمی‌شود؛ فقط مدل، توکن، هزینه و زمان پاسخ در گزارش می‌ماند.

کدهای خطا

قالب بدنه خطا با فرمت درخواست یکی است (OpenAI، Anthropic یا Gemini) تا SDKها خطا را درست نمایش دهند.

مدل‌ها و قیمت

قیمت‌ها به تومان و به ازای یک میلیون توکن است.