راهنمای کامل اتصال به API هوش مصنوعی با پایتون در ۱۰ دقیقه

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

API هوش مصنوعی دقیقاً چیست؟

API یک درگاه ارتباطی است. برنامه شما متن (یا تصویر) را به سرور ارائه‌دهنده می‌فرستد، مدل آن را پردازش می‌کند و پاسخ را برمی‌گرداند. شما فقط بابت مصرف واقعی هزینه می‌دهید و نگهداری، به‌روزرسانی و سخت‌افزار مدل بر عهده ارائه‌دهنده است.

پیش‌نیازها

• پایتون نسخه ۳.۸ یا بالاتر
• یک API Key معتبر
• کتابخانه رسمی openai که با بیشتر سرویس‌های سازگار با استاندارد OpenAI کار می‌کند

قدم اول: نصب کتابخانه

pip install openai

قدم دوم: نگه‌داشتن امن کلید

هرگز API Key را مستقیم داخل کد ننویسید، مخصوصاً اگر کد را در گیت‌هاب می‌گذارید. کلید را در متغیر محیطی ذخیره کنید:

export ELINLAND_API_KEY="کلید_شما"

قدم سوم: اولین درخواست

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ELINLAND_API_KEY"],
    base_url="https://api.elinland.ir/v1",
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "تو یک دستیار فارسی‌زبان دقیق هستی."},
        {"role": "user", "content": "سه ایده برای استارتاپ آموزشی بده."},
    ],
)

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

پیام system شخصیت و قواعد مدل را تعیین می‌کند و پیام user سؤال اصلی است. برای ادامه گفتگو، پاسخ‌های قبلی را با نقش assistant به لیست پیام‌ها اضافه کنید.

قدم چهارم: پاسخ لحظه‌ای (Streaming)

در چت‌بات‌ها بهتر است متن کلمه‌به‌کلمه نمایش داده شود تا کاربر منتظر نماند:

stream = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "یک شعر کوتاه درباره پاییز بگو."}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

خطاهای رایج و راه‌حل

• 401 Unauthorized: کلید اشتباه است یا درست در متغیر محیطی قرار نگرفته.
• 429 Too Many Requests: تعداد درخواست‌ها از سقف مجاز گذشته یا اعتبار تمام شده. بین تلاش‌ها کمی صبر کنید.
• Timeout: برای متن‌های طولانی، مقدار timeout کلاینت را بیشتر کنید یا از streaming استفاده کنید.

چند توصیه برای محیط واقعی

• کلید را فقط در سمت سرور نگه دارید؛ هیچ‌وقت آن را در اپلیکیشن موبایل یا جاوااسکریپت سمت کاربر قرار ندهید.
• برای هر پروژه کلید جداگانه بسازید تا مصرف قابل ردیابی باشد.
• با پارامتر max_tokens طول پاسخ و در نتیجه هزینه را کنترل کنید.

جمع‌بندی

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