توثيق واجهة برمجة التطبيقات (API Reference)

curl -X POST "https://awtaar.app/api/generate" \
  -H "Authorization: Bearer av_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "أهلاً بك في منصة أوتار الصوتية. تجربة رائدة لتحويل النصوص إلى أصوات بشرية طبيعية.",
    "voiceId": "nour-egyptian-warm",
    "response_format": "wav"
  }' \
  --output audio.wav

# Pass your API key in the Authorization header:
curl -X GET "https://awtaar.app/api/wallet" \
  -H "Authorization: Bearer av_your_api_key_here"

curl -X POST "https://awtaar.app/api/generate" \
  -H "Authorization: Bearer av_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "تحويل النص إلى كلام طبيعي بلهجة مصرية أو فصحى بجودة فائقة.",
    "voiceId": "nour-egyptian-warm",
    "response_format": "wav"
  }' \
  --output output.wav

curl https://awtaar.app/v1/audio/speech \
  -H "Authorization: Bearer av_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "awtaar-voice-v2",
    "input": "يا صباح الفل يا هندسة! كود متوافق تماماً مع حزم أوبن إيه آي الرسمية.",
    "voice": "omar-egyptian-witty",
    "response_format": "mp3",
    "speed": 1.0
  }' \
  --output speech.mp3

# 1. Stream live audio directly to speaker or media player in real time (<100ms latency):
curl -N "https://awtaar.app/api/stream" \
  -H "Authorization: Bearer av_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "بث صوتي مباشر لحظي بأقل من 100 ميلي ثانية لأي تطبيق أو روبوت محادثة.",
    "voiceId": "nour-egyptian-warm",
    "model": "awtaar-realtime",
    "response_format": "mp3"
  }' | ffplay -nodisp -autoexit -

# 2. Or stream with a simple GET URL directly in HTML5 <audio> or browser:
# https://awtaar.app/api/stream?apiKey=YOUR_KEY&text=مرحباً&voiceId=nour-egyptian-warm&model=awtaar-realtime

curl -X POST "https://awtaar.app/api/transcribe" \
  -H "Authorization: Bearer av_your_api_key_here" \
  -F "file=@meeting_record.wav"

curl -X POST "https://awtaar.app/api/sfx" \
  -H "Authorization: Bearer av_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "عاصفة رعدية سينمائية ليلاً مع أمطار غزيرة وصوت رعد عميق",
    "durationSeconds": 10
  }'

curl -X GET "https://awtaar.app/api/wallet" \
  -H "Authorization: Bearer av_your_api_key_here"

curl https://awtaar.app/v1/audio/speech \
  -H "Authorization: Bearer av_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "awtaar-voice-v2",
    "dialogue": [
      {
        "speaker": "طارق",
        "voice": "awtaar-eg-onyx-tarek",
        "emotion": "حماس",
        "text": "يا أهلاً وسهلاً بيكم في بودكاست المستقبل الصوتي!"
      },
      {
        "speaker": "ريم",
        "voice": "awtaar-ae-nova-reem",
        "emotion": "هدوء",
        "text": "أهلاً بك يا طارق وبكل متابعينا في هذا الحوار الممتع."
      }
    ],
    "response_format": "wav"
  }' \
  --output dialogue.wav