Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

تحويل الكلام إلى نص

الخادم:https://openapi.felo.ai
مكتبات العملاء

Audio

​
Audio العمليات

تحويل الكلام إلى نص

​

أرسل model وfile بصيغة multipart/form-data: ملف PCM WAV أحادي كامل، بحد أقصى 25,000,000 بايت، مع الالتزام بقيود معدل العينات والمدة للقناة. الحقول الاختيارية: language (حرفان صغيران، مثل ar) وresponse_format=json (الصيغة الوحيدة والافتراضية). دع curl ينشئ boundary. لا تُدعم الروابط أو معرّفات الملفات أو prompt أو الطوابع الزمنية أو stream.

يستخدم STT ‏input_audio_second أو التوكنات، وTTS ‏input_character. في speech_billing_unit يختلف عدّ الرموز التعبيرية بين utf16_code_unit وunicode_code_point. الحجز ليس سقف إنفاق؛ وقد تكون التسوية غير متزامنة. نقص الأدلة لا يعني المجانية. تقبل الواجهتان X-Felo-Channel وترسلان مرة واحدة للقناة المختارة. عطّل المحاولات التلقائية بما فيها SDK بعد انتهاء المهلة أو الانقطاع، واحتفظ بـX-Request-Id وX-Generation-Id إن توفر. لا يدعم Console Playground الصوت بعد. يستخدم configured_rates الأسعار المثبتة والاستخدام المتحقق منه؛ ويستخدم upstream_cost تكلفة المزوّد المتحقق منها مع الزيادة والخصم المنشورين.

الرؤوس
  • X-Felo-Channel
    النوع: string

    Ordered comma-separated public channel codes. Omit this header to use default; default must be used alone. In wallet mode, default scans the model's effective public channel order in reverse, skips unpublished or unavailable channels, and uses the first eligible channel. Explicit codes follow the supplied order. For stateless Chat Completions, Messages and Responses, the server may try another selected channel or provider group after a confirmed upstream rejection. A single explicit channel limits routing to that channel. Legacy provider headers cannot override channel routing.

الجسم
مطلوب
application/json
الاستجابات
  • 200
    النوع: object

    تحتوي استجابة JSON المتزامنة على text وربما usage بالثواني أو التوكنات. usage.cost تكلفة المزوّد وليست رسوم Felo النهائية. لا توجد مهمة تحتاج إلى استطلاع.

    • text
      النوع: string
      مطلوب
    • usage
      النوع: object | null
      • cost
        النوع: number
        الحد الأدنى:  
        0

        Reported upstream cost in USD.

      • input_token_details
        النوع: object
        • audio_tokens
          النوع: integer
          الحد الأدنى:  
          0

          Integer numbers.

        • text_tokens
          النوع: integer
          الحد الأدنى:  
          0

          Integer numbers.

      • input_tokens
        النوع: integer
        الحد الأدنى:  
        0

        Integer numbers.

      • output_tokens
        النوع: integer
        الحد الأدنى:  
        0

        Integer numbers.

      • seconds
        النوع: number
        الحد الأدنى:  
        0

        Duration reported by the selected channel.

      • total_tokens
        النوع: integer
        الحد الأدنى:  
        0

        Integer numbers.

      • type
        النوع: string تعداد
        القيم
        • duration
        • tokens
    application/json
  • 400
    النوع: object

    Upload, wallet or upstream error

    • error
      النوع: object
      مطلوب
      • code
        النوع: string | null
      • message
        النوع: string
      • param
        النوع: string | null
      • type
        النوع: string
    application/json
  • 402
    النوع: object

    Upload, wallet or upstream error

    • error
      النوع: object
      مطلوب
      • code
        النوع: string | null
      • message
        النوع: string
      • param
        النوع: string | null
      • type
        النوع: string
    application/json
  • 413
    النوع: object

    Upload, wallet or upstream error

    • error
      النوع: object
      مطلوب
      • code
        النوع: string | null
      • message
        النوع: string
      • param
        النوع: string | null
      • type
        النوع: string
    application/json
  • 415
    النوع: object

    Upload, wallet or upstream error

    • error
      النوع: object
      مطلوب
      • code
        النوع: string | null
      • message
        النوع: string
      • param
        النوع: string | null
      • type
        النوع: string
    application/json
  • 429
    النوع: object

    Upload, wallet or upstream error

    • error
      النوع: object
      مطلوب
      • code
        النوع: string | null
      • message
        النوع: string
      • param
        النوع: string | null
      • type
        النوع: string
    application/json
  • 500
    النوع: object

    Upload, wallet or upstream error

    • error
      النوع: object
      مطلوب
      • code
        النوع: string | null
      • message
        النوع: string
      • param
        النوع: string | null
      • type
        النوع: string
    application/json
  • 502
    النوع: object

    Upload, wallet or upstream error

    • error
      النوع: object
      مطلوب
      • code
        النوع: string | null
      • message
        النوع: string
      • param
        النوع: string | null
      • type
        النوع: string
    application/json
  • 503
    النوع: object

    Upload, wallet or upstream error

    • error
      النوع: object
      مطلوب
      • code
        النوع: string | null
      • message
        النوع: string
      • param
        النوع: string | null
      • type
        النوع: string
    application/json
  • 504
    النوع: object

    Upload, wallet or upstream error

    • error
      النوع: object
      مطلوب
      • code
        النوع: string | null
      • message
        النوع: string
      • param
        النوع: string | null
      • type
        النوع: string
    application/json
Request Example for post/api/v1/audio/transcriptions
curl https://openapi.felo.ai/api/v1/audio/transcriptions \
  --request POST \
  --header 'Content-Type: multipart/form-data' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --form 'model=grok-stt-2.0' \
  --form 'file=@filename' \
  --form 'language=' \
  --form 'response_format=json'
{
  "text": "string",
  "usage": {
    "seconds": 0,
    "type": "duration",
    "input_tokens": 0,
    "output_tokens": 0,
    "total_tokens": 0,
    "input_token_details": {
      "text_tokens": 0,
      "audio_tokens": 0
    },
    "cost": 0
  }
}
Transcribe a WAV recording

هل تحتاج إلى مساعدة؟