v1

latestOpenAPI 3.0.1MIT2026-07-26104203277.0 KB

Generate AI Content

Submit a transcription job that also generates AI content based on provided parts.

post/v2/jobs/generate-transcription-ai-content

Request body

apiKeystring uuid required

API key identifier (used for API key authorization)

mediaUrlstring uri required

URL of the media to transcribe

titlestring required

language'ar' | 'en' required

Language code for the media being transcribed

aiPartsstring[] required

AI content parts to generate (one key only)

aiContentTitlestring nullable

aiContentLanguage'ar' | 'en' | 'both_ar_first' | 'both_en_first' nullable

Preferred AI content language

aiContentDatestring date-time nullable

Date associated with the AI content

aiContentTextstring nullable

Example request

{
  "apiKey": "9f5f1f6a-2b1d-4a33-8fd4-6f5c2b89e3aa",
  "mediaUrl": "https://example.com/audio.mp3",
  "title": "Meeting Notes",
  "language": "ar",
  "aiParts": [
    "summary"
  ],
  "aiContentTitle": "Project Kickoff Summary",
  "aiContentLanguage": "ar",
  "aiContentDate": "2025-01-01T00:00:00.000Z",
  "aiContentText": "Provide highlights focusing on action items."
}

Response

Successful response with job id

successboolean

messagestring

messageKeystring

Example response

{
  "success": true,
  "message": "AI Content started, you will receive en email when it's ready",
  "messageKey": "OPERATION_SUCCESSFUL",
  "data": {
    "jobId": "ed9b5601-f731-441a-8500-d9fc7610ef8f"
  }
}