إنتقل إلى المحتوى الرئيسي

الفصل 1: واجهات برمجة التطبيقات والتكامل

الاتصال بخدمات الذكاء الاصطناعي​

تُعد واجهات برمجة التطبيقات (APIs) البوابة لتكامل قدرات الذكاء الاصطناعي في تطبيقاتك. فهم كيفية العمل مع واجهات برمجة تطبيقات الذكاء الاصطناعي ضروري لبناء منتجات مدعومة بالذكاء الاصطناعي.

واجهات برمجة التطبيقات الرئيسية للذكاء الاصطناعي​

المزودواجهة برمجة التطبيقات الرئيسيةالميزات الرئيسية
OpenAIGPT-4, DALL-Eالأكثر شهرة، شاملة
AnthropicClaudeتركز على الأمان، سياق طويل
GoogleGeminiتكامل مع جوجل
Hugging Faceمتعددةنماذج مفتوحة المصدر
CohereCommandتركز على المؤسسات

أساسيات واجهة برمجة التطبيقات لـ OpenAI​

المصادقة​

from openai import OpenAI

client = OpenAI(api_key="your-api-key")

إكمال الدردشة الأساسي​

response = client.chat.completions.create(
    model="gpt-4",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "What is machine learning?"}
    ]
)

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

المعلمات الرئيسية​

المعلمةالغرض
modelأي نموذج للاستخدام
messagesتاريخ المحادثة
temperatureالإبداع (0-2)
max_tokensحد طول الاستجابة

واجهة برمجة التطبيقات لـ Anthropic (Claude)​

الاستخدام الأساسي​

import anthropic

client = anthropic.Anthropic(api_key="your-api-key")

message = client.messages.create(
    model="claude-3-sonnet-20240229",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ]
)

حدود المعدل والحصص​

فهم الحدود​

  • الطلبات في الدقيقة (RPM): مكالمات API المسموح بها
  • الرموز في الدقيقة (TPM): حجم النص المسموح به
  • الرموز في اليوم (TPD): الحدود اليومية

التعامل مع حدود المعدل​

import time
from openai import RateLimitError

def call_with_retry(func, max_retries=3):
    for attempt in range(max_retries):
        try:
            return func()
        except RateLimitError:
            time.sleep(2 ** attempt)
    raise Exception("Max retries exceeded")

اعتبارات التسعير​

التسعير القائم على الرموز​

النموذجالإدخالالإخراج
GPT-4$30/1M tokens$60/1M tokens
GPT-3.5$0.50/1M$1.50/1M
Claude 3 Sonnet$3/1M$15/1M

تقدير التكلفة​

Tokens per request × Requests per day × Days × Price per token

أفضل ممارسات الأمان​

إدارة مفاتيح API​

  • لا تقم أبدًا بتضمين المفاتيح في الكود
  • استخدم متغيرات البيئة
  • قم بتدوير المفاتيح بانتظام
  • استخدم مفاتيح مختلفة لكل بيئة
import os
api_key = os.environ.get("OPENAI_API_KEY")

النقاط الرئيسية​

✅ تُمكّن واجهات برمجة التطبيقات من تكامل الذكاء الاصطناعي في التطبيقات

✅ لكل مزود نقاط قوة مختلفة

✅ تتطلب حدود المعدل والتكاليف التخطيط

✅ إدارة المفاتيح الآمنة ضرورية

الخطوات التالية​

تابع إلى الفصل 2: بناء التطبيقات المدعومة بالذكاء الاصطناعي.