شروع سریع

در کمتر از پنج دقیقه اولین درخواست خود را به API درواره ارسال کنید.

۱. ساخت حساب و شارژ کیف پول

پس از ثبت‌نام و تأیید شمارۀ موبایل، از صفحۀ کیف پول اعتبار ریالی خود را از طریق درگاه ZarinPal شارژ کنید.

۲. ساخت کلید API

از صفحۀ کلیدهای API یک کلید جدید بسازید. کلید فقط یک بار نمایش داده می‌شود — آن را در جای امن ذخیره کنید.

هرگز کلید را در کد فرانت‌اند، مخازن عمومی گیت یا اپ موبایل قرار ندهید.

۳. ارسال اولین درخواست

curl -X POST https://api.darvareh.ir/v1/chat/completions \
  -H "Authorization: Bearer YOUR_DARVAREH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "system", "content": "تو یک دستیار فارسی‌زبان هستی."},
      {"role": "user",   "content": "سه ایده برای اسم یک اپ فروشگاهی بده"}
    ]
  }'

۴. استفاده با SDK رسمی OpenAI

هیچ SDK اختصاصی لازم نیست. کافی است base_url را تغییر دهید:

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_DARVAREH_API_KEY",
    base_url="https://api.darvareh.ir/v1",
)

r = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "سلام!"}],
)
print(r.choices[0].message.content)
import OpenAI from "openai";

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

const r = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "سلام!" }],
});
console.log(r.choices[0].message.content);

۵. مشاهدۀ مصرف

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