دليل API

الصوت العربي

حوّل نصوص الحملات العربية كما هي إلى ملفات MP3 مستضافة مع التحكم في اللهجة والأداء والصوت.

POST/speech-generations

رسالة صوتية خليجية لواتساب

أرسل النص النهائي الذي تريد قراءته. لا تستخدم حقل text كمطالبة لتأليف نص جديد.

curl --request POST \
  --url https://www.lahjty.com/api/v1/speech-generations \
  --header "Authorization: Bearer $LAHJTY_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: speech-order-1848" \
  --data '{
  "text": "طلبك صار جاهز، ونوصله لك بكرة بإذن الله.",
  "dialect": "gulf",
  "tone": "warm",
  "platform": "whatsapp",
  "delivery": "natural",
  "content_type": "marketing",
  "voice_profile": "warm_storyteller",
  "external_customer_id": "merchant-91"
}'

Example response

response.json
{
  "id": "spc_01jexample",
  "object": "speech_generation",
  "request_id": "req_01jexample",
  "status": "completed",
  "audio": {
    "url": "https://example.convex.cloud/api/storage/example",
    "mime_type": "audio/mpeg",
    "bytes": 184220,
    "duration_seconds": null
  },
  "voice_profile": "warm_storyteller",
  "delivery": "natural",
  "dialect": "gulf",
  "usage": {
    "credits_used": 5,
    "balance_after": 488
  }
}

اختيار الصوت

استخدم voice_profile لشخصية صوتية مستقرة تديرها Lahjty. حقل voice المتقدم يتجاوز المزود ولا يجوز إرساله مع voice_profile.