نسخه API v1

مستندات جامع یکپارچه‌سازی مدل‌های هوش مصنوعی

برای اتصال به تمام مدل‌های هوش مصنوعی، تمام تمرکز خود را روی فایل کانفیگ مرجع (JSON) قرار دهید. ما تمام اطلاعات مورد نیاز برای پیاده‌سازی ۱۰۰٪ داینامیک را در این فایل متمرکز کرده‌ایم.

CORE ARCHITECTURE

مرجع اصلی شما: فایل کانفیگ JSON مدل‌ها

لطفاً برای یافتن آیدی مدل‌ها، اندپوینت‌های صحیح، بررسی وضعیت Async بودن و خواندن آپشن‌های اختصاصی هر مدل فقط به این فایل مراجعه کنید.

مشاهده فایل زنده کانفیگ (JSON)

شناسه مدل (Root Key)

کلید اصلی در فایل JSON که باید به عنوان model ارسال شود.

مسیر متد (endpoint)

مسیر را به آدرس https://api.ai-kar.com متصل کنید.

نوع پردازش (is_async)

اگر true بود، سیستم یک Task ID می‌دهد که باید وضعیت آن پایش شود.

آپشن‌ها (options)

آرایه options مجاز بودن پارامترهایی مثل عکس، صدا، رزولوشن و... را مشخص می‌کند.

قوانین ارسال تصویر و فایل به مدل‌ها

در فایل JSON اگر مدلی در کلید options عبارت accepts_upload یا image_to_video داشته باشد، تصویر خود را به ۲ روش ارسال کنید:
۱. ارسال لینک عمومی (Public URL): بهترین و سریع‌ترین روش. مثلاً "image": "https://example.com/pic.jpg"
۲. ارسال به صورت Base64: در صورت عدم دسترسی به لینک عمومی. مثلاً "image": "data:image/jpeg;base64,/9j/4AAQ..."

نمونه کدهای واقعی برگرفته از تنظیمات فایل ai_models_config.json

۱مدل‌های متنی و چت - مثال‌های جستجو در gemini-3-5-flash-openai

حالت ۱درخواست ساده مکالمه‌ای (بدون جستجو)

curl -X POST "https://api.ai-kar.com/gemini-3-5-flash-openai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-5-flash-openai",
    "messages": [
      {"role": "user", "content": "سلام، چطور می‌توانی به توسعه برنامه‌ام کمک کنی؟"}
    ]
  }'

حالت ۲جستجوی اختیاری (مدل بر اساس نیاز تصمیم می‌گیرد)

curl -X POST "https://api.ai-kar.com/gemini-3-5-flash-openai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-5-flash-openai",
    "messages": [
      {"role": "user", "content": "آخرین اخبار هوش مصنوعی امروز را بگو"}
    ],
    "tools": [
      {
        "type": "function",
        "function": { "name": "googleSearch" }
      }
    ]
  }'

حالت ۳جستجوی اجباری (تضمین استفاده از گوگل)

curl -X POST "https://api.ai-kar.com/gemini-3-5-flash-openai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-5-flash-openai",
    "messages": [
      {"role": "user", "content": "قیمت امروز دلار و طلا چقدر است؟"}
    ],
    "tools": [
      {
        "type": "function",
        "function": { "name": "googleSearch" }
      }
    ],
    "tool_choice": {
      "type": "function",
      "function": { "name": "googleSearch" }
    }
  }'

۲مدل‌های تصویر (Image to Image) - seedream-5.0-lite

با بررسی JSON می‌بینیم این مدل‌ها is_async: false هستند (عکس فوری برمی‌گردد). برای ویرایش عکس یا تغییر استایل (Image to Image)، می‌توانید پارامتر image را ارسال کنید.

# ویرایش تصویر با ارسال آدرس عمومی عکس
curl -X POST "https://api.ai-kar.com/v3/seedream-5.0-lite" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "تبدیل این عکس به یک نقاشی آبرنگ کلاسیک",
    "image": "https://example.com/my-portrait.jpg",
    "aspect_ratio": "16:9"
  }'

# ویرایش با فرمت Base64 (در صورتی که عکس در هاست شما عمومی نیست)
curl -X POST "https://api.ai-kar.com/v3/seedream-5.0-lite" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "افزودن عینک آفتابی سایبرپانک",
    "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABgAAD..."
  }'

۳مدل‌های ویدیویی (چند عکس به ویدیو) - kling-v3.0 / minimax

مدل‌های ویدیو به دلیل زمان‌بر بودن، is_async: true هستند. در JSON مشاهده می‌کنید که مدلی مثل کلینگ آپشن image_tail (فریم پایانی) و sound را پشتیبانی می‌کند. پاسخ این متدها یک Task ID است.

# مثال: تولید ویدیو از دو عکس (فریم شروع و فریم پایان) در مدل Kling
curl -X POST "https://api.ai-kar.com/v3/async/kling-v3.0-pro-i2v" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3.0-pro-i2v",
    "prompt": "مورف شدن و تغییر فصل از بهار به زمستان",
    "image": "https://example.com/spring-tree.jpg",
    "image_tail": "https://example.com/winter-tree.jpg",
    "duration": 5,
    "sound": true
  }'

# مثال: ساخت ویدیو فقط از یک عکس (مدل مینی‌مکس)
curl -X POST "https://api.ai-kar.com/v3/async/minimax-hailuo-02-i2v" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "حرکت آبشار در تصویر و پرواز پرندگان",
    "image": "https://example.com/waterfall.jpg",
    "resolution": "1080P"
  }'

# پاسخ دریافتی (تسک آی‌دی):
# { "task_id": "848a9b2c-...", "status": "processing" }

💬

Text Models (LLM)

GPT, Gemini, Claude, Grok

🎨

Image Models

SeeDream, Flux, Midjourney

🎬

Video Models

Kling, Minimax, Runway

🎵

Music Models

Suno, MusicGen

🎙️

Voice/Speech Models

TTS, STT, Cloning

🛡️

Content Moderation

Safety & Filter checks

🧊

3D-Generating Models

TripoSR, Shap-E

👁️

Vision Models

Image analysis & OCR

🔢

Embedding Models

Vector representations

قابلیت Idempotency (امنیت تراکنش)

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

هدر:Idempotency-Key

مقدار:رشته منحصربه‌فرد (UUID)

example.py

headers = {
  "Authorization": "Bearer KEY",
  "Idempotency-Key": "unique-uuid-v4",
  "Content-Type": "application/json"
}

در پیاده‌سازی گیر کرده‌اید؟

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

ثبت تیکت در پشتیبانی

چطور شروع کنم؟

کافیست فایل JSON را به عنوان دیتابیس مدل‌های خود در نظر بگیرید. کلید API خود را تولید کنید و با خواندن اندپوینت‌ها و آپشن‌ها از روی فایل، مستقیماً کدنویسی را آغاز نمایید.

دریافت کلید API مشاهده فایل زنده کانفیگ مدل‌ها