اولین درخواست API هوش مصنوعی را
بدون حدس‌زدن بساز.

مسیر استاندارد

چهار مرحله‌ای که نباید با هم قاطی شوند

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

1. ۱Provider را انتخاب کن

   کاربرد، نوع سهمیه، محدودیت، مدل و وضعیت منطقه را مقایسه کن.

2. ۲حساب و کلید بساز

   فقط از صفحه رسمی ثبت‌نام و داشبورد رسمی API Key استفاده کن.

3. ۳سه مقدار را تنظیم کن

   API Key، Base URL و شناسه دقیق Model را از مستندات بردار.

4. ۴درخواست واقعی بفرست

   HTTP status، بدنه JSON و محتوای پاسخ مدل را بررسی کن.

مخصوص کاربران ایران

چهار نوع Evidence را جدا بخوان

در صفحه هر Provider ممکن است یکی از لایه‌های زیر تأیید شده باشد. برچسب «سایت باز شد» یا پاسخ 401 به‌معنی کارکرد کامل سرویس نیست؛ 401 معمولاً فقط نشان می‌دهد مسیر شبکه به Endpoint رسیده اما اعتبارنامه معتبر ارائه نشده است.

برای تصمیم نهایی، صفحه اختصاصی Provider، تاریخ آخرین بررسی و منبع رسمی را بخوان. وضعیت‌ها تضمین دائمی نیستند و ممکن است با سیاست سرویس، حساب یا مسیر شبکه تغییر کنند.

قبل از کدنویسی

سه مقدار اصلی را از مستندات رسمی بردار

export LLM_API_KEY="YOUR_API_KEY"
export LLM_BASE_URL="https://provider.example/v1"
export LLM_MODEL="MODEL_ID"

نمونه‌های قابل‌کپی

یک درخواست ساده Chat Completions بفرست

این نمونه‌ها فقط برای Providerهایی هستند که در کاتالوگ با برچسب سازگار با OpenAI نمایش داده شده‌اند. اگر سرویس API اختصاصی دارد، Schema و SDK همان سرویس را استفاده کن. پیام آزمایشی کوتاه نگه داشته شده تا خطای اتصال، مدل و احراز هویت سریع‌تر مشخص شود.

curl "$LLM_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $LLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$LLM_MODEL"'",
    "messages": [
      {"role": "user", "content": "فقط بنویس: اتصال موفق بود"}
    ]
  }'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["LLM_API_KEY"],
    base_url=os.environ["LLM_BASE_URL"],
)

response = client.chat.completions.create(
    model=os.environ["LLM_MODEL"],
    messages=[
        {"role": "user", "content": "فقط بنویس: اتصال موفق بود"}
    ],
)

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

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.LLM_API_KEY,
  baseURL: process.env.LLM_BASE_URL,
});

const response = await client.chat.completions.create({
  model: process.env.LLM_MODEL,
  messages: [
    { role: "user", content: "فقط بنویس: اتصال موفق بود" },
  ],
});

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

تعریف موفقیت

از کجا بفهمم واقعاً وصل شده‌ام؟

رفع خطای سریع

خطاهای رایج چه معنایی دارند؟

برای جزئیات بیشتر، راهنماهای خطاهای 401، 403 و مدل و مدیریت Rate Limit 429 را بخوان.