مقدمه

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

Base URL

https://api.ai-marketplace.ir/v1

نکته مهم: تمام درخواست‌ها باید از طریق پروتکل HTTPS ارسال شوند. درخواست‌های HTTP ناامن مسدود خواهند شد.

احراز هویت

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

Header Request

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

هشدار امنیتی: هرگز کلید API خود را در کدهای سمت کلاینت (مثل فایل‌های JS مرورگر) قرار ندهید. درخواست‌ها باید از سمت سرور شما ارسال شوند.

تبدیل متن به گفتار

این متد متن ورودی فارسی را دریافت کرده و فایل صوتی آن را برمی‌گرداند.

نمونه درخواست (cURL):

Bash

curl -X POST "https://api.ai-marketplace.ir/v1/tts/synthesize" \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
  "text": "سلام، به بازارگاه هوش مصنوعی خوش آمدید.",
  "voice_id": "male_1",
  "speed": 1.0
}'

پاسخ موفق (200 OK):

JSON Response

{
  "status": "success",
  "audio_url": "https://cdn.ai-marketplace.ir/audio/5f8d9a.mp3",
  "duration": 3.5,
  "credits_used": 10
}

مدیریت خطاها

در صورت بروز مشکل، API یکی از کدهای زیر را برمی‌گرداند:

401 Unauthorized: کلید API نامعتبر است یا ارسال نشده.
429 Too Many Requests: تعداد درخواست‌های شما از حد مجاز فراتر رفته است.
500 Server Error: خطای داخلی سرور. لطفاً با پشتیبانی تماس بگیرید.