مستندات اتصال به API هوش مصنوعی آسمان (ITSG AI)

شروع سریع (Quickstart)

برای شروع به کار، تنها به دو مورد نیاز دارید: آدرس سرور (Base URL) و کلید دسترسی اختصاصی خود (API Key) که از پنل کاربری دریافت کرده‌اید.

آدرس ارتباط با گیت‌وی (Base URL)

در تمام کتابخانه‌ها و درخواست‌های خود، پارامتر base_url را برابر آدرس زیر قرار دهید:

نحوه احراز هویت (Authentication)

کلیه درخواست‌ها باید حاوی هدر استاندارد Authorization به فرمت زیر باشند:

Authorization: Bearer itsg-live-1234567890abcdef

مکالمه و پردازش متن (Chat Completions)

نمونه کد زبان پایتون با کتابخانه رسمی OpenAI:

from openai import OpenAI

client = OpenAI(
    api_key="itsg-live-1234567890abcdef",
    base_url="https://api.crmitsg.ir/openai/v1"
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {"role": "system", "content": "شما دستیار هوش مصنوعی دقیق و فارسی‌زبان آسمان هستید."},
        {"role": "user", "content": "سلام، اتصال به API بررسی شد؟"}
    ],
    temperature=0.7,
    max_tokens=300
)

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

نمونه فراخوانی با cURL

curl https://api.crmitsg.ir/openai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer itsg-live-1234567890abcdef" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "تست بررسی پایداری سرور"}
    ]
  }'

مدل‌های برداری (Embeddings)

embedding = client.embeddings.create(
    model="text-embedding-3-small",
    input="متن مورد نظر برای تبدیل به بردار ابعادی"
)

print(len(embedding.data[0].embedding))

پردازش صوت و تبدیل گفتار به متن (Audio)

audio_file = open("sample.mp3", "rb")

transcript = client.audio.transcriptions.create(
    model="whisper-1",
    file=audio_file
)

print(transcript.text)

تولید تصویر (Images)

image_response = client.images.generate(
    model="dall-e-3",
    prompt="سرور هوش مصنوعی مدرن با نورهای نئونی در یک دیتاسنتر پیشرفته",
    size="1024x1024"
)

print(image_response.data[0].url)

کدهای وضعیت و رفع خطاها

تعرفه‌ها و پشتیبانی

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

مشاهده جدول تعرفه مدل‌ها ارسال تیکت پشتیبانی