endAi.ir
API سازگار با OpenAI

مستندات endAi

فقط دو مقدار را عوض کن — base_url و api_key — و با همون SDK یا ابزاری که داری به همهٔ مدل‌ها وصل شو. کلیدت رو از داشبورد بساز.

ساخت کلید APIامتحان در چت

شروع سریع

آدرس پایه: https://api.endai.ir/v1. احراز هویت با هدر Authorization: Bearer sk-endai-....

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

پایتون (OpenAI SDK)

1

نصب SDK

pip install openai

2

تنظیم base_url و api_key

همون کدی که می‌نوشتی را نگه دار؛ فقط آدرس و کلید را عوض کن.

python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.endai.ir/v1",
    api_key="sk-endai-...",
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "سلام!"}],
)

print(response.choices[0].message.content)

Node.js (OpenAI SDK)

1

نصب SDK

npm install openai

2

تنظیم baseURL و apiKey

دقیقاً همون کد قبلی؛ فقط دو مقدار عوض می‌شود.

typescript
import OpenAI from "openai"

const client = new OpenAI({
  baseURL: "https://api.endai.ir/v1",
  apiKey: process.env.ENDAI_API_KEY,
})

const response = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "سلام!" }],
})

console.log(response.choices[0].message.content)

Cursor

1

Settings → Models

گزینهٔ Override OpenAI Base URL را فعال کن و آدرس https://api.endai.ir/v1 را بگذار.

2

کلید و مدل

کلید endAi را وارد کن و یک مدل معتبر مثل gpt-4o-mini اضافه کن. حالا Ask و Agent از endAi رد می‌شوند.

VSCode / Continue

1

فایل config.json افزونهٔ Continue

مسیر پیش‌فرض: ~/.continue/config.json

2

افزودن مدل endAi

provider را روی openai بگذار و apiBase را به endAi عوض کن.

json (~/.continue/config.json)
{
  "models": [
    {
      "title": "endAi",
      "provider": "openai",
      "model": "gpt-4o-mini",
      "apiBase": "https://api.endai.ir/v1",
      "apiKey": "sk-endai-..."
    }
  ]
}

OpenCode CLI

1

ساخت provider سفارشی

در فایل opencode.json یک provider با بستهٔ @ai-sdk/openai-compatible بساز.

2

اتصال به endAi

options.baseURL را روی endAi بگذار و مدل‌های دلخواه را در models معرفی کن.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "endai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "endAi",
      "options": {
        "baseURL": "https://api.endai.ir/v1",
        "apiKey": "sk-endai-..."
      },
      "models": {
        "gpt-4o-mini": { "name": "GPT-4o mini" }
      }
    }
  }
}

Aider CLI

1

تنظیم متغیرهای محیطی

Aider از متغیرهای سازگار با OpenAI استفاده می‌کند.

2

اجرا

مدل را با پیشوند openai/ بده.

bash
export OPENAI_API_BASE=https://api.endai.ir/v1
export OPENAI_API_KEY=sk-endai-...

aider --model openai/gpt-4o-mini

نکات مهم

کلید و بودجه
هر کلید از داشبورد ساخته می‌شود و سقف بودجهٔ تومانی دارد که هنگام ساخت به دلار تبدیل و روی LiteLLM اعمال می‌شود. کلید فقط یک‌بار نمایش داده می‌شود.
قیمت‌گذاری
قیمت‌ها عیناً قیمت خودِ مدل است و فقط معادل ریالی با نرخ روز دریافت می‌شود؛ بدون کارمزد و بدون افزایش.
سازگاری
endpoint سازگار با OpenAI است؛ ابزارهایی که /v1/chat/completions را پشتیبانی می‌کنند به‌سادگی وصل می‌شوند.