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 تكلفة المزوّد المتحقق منها مع الزيادة والخصم المنشورين.
- النوع: stringX
- Felo - Channel 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.
- النوع: object200
تحتوي استجابة JSON المتزامنة على
textوربماusageبالثواني أو التوكنات.usage.costتكلفة المزوّد وليست رسوم Felo النهائية. لا توجد مهمة تحتاج إلى استطلاع.- النوع: stringtextمطلوب
- النوع: object | nullusage
- costالنوع: numberالحد الأدنى:0
Reported upstream cost in USD.
- inputالنوع: object
_token _details - audioالنوع: integer
_tokens الحد الأدنى:0Integer numbers.
- textالنوع: integer
_tokens الحد الأدنى:0Integer numbers.
- inputالنوع: integer
_tokens الحد الأدنى:0Integer numbers.
- outputالنوع: integer
_tokens الحد الأدنى:0Integer numbers.
- secondsالنوع: numberالحد الأدنى:0
Duration reported by the selected channel.
- totalالنوع: integer
_tokens الحد الأدنى:0Integer numbers.
- typeالنوع: string تعدادالقيم
- duration
- tokens
application/json - النوع: object400
Upload, wallet or upstream error
- النوع: objecterrorمطلوب
- codeالنوع: string | null
- messageالنوع: string
- paramالنوع: string | null
- typeالنوع: string
application/json - النوع: object402
Upload, wallet or upstream error
- النوع: objecterrorمطلوب
- codeالنوع: string | null
- messageالنوع: string
- paramالنوع: string | null
- typeالنوع: string
application/json - النوع: object413
Upload, wallet or upstream error
- النوع: objecterrorمطلوب
- codeالنوع: string | null
- messageالنوع: string
- paramالنوع: string | null
- typeالنوع: string
application/json - النوع: object415
Upload, wallet or upstream error
- النوع: objecterrorمطلوب
- codeالنوع: string | null
- messageالنوع: string
- paramالنوع: string | null
- typeالنوع: string
application/json - النوع: object429
Upload, wallet or upstream error
- النوع: objecterrorمطلوب
- codeالنوع: string | null
- messageالنوع: string
- paramالنوع: string | null
- typeالنوع: string
application/json - النوع: object500
Upload, wallet or upstream error
- النوع: objecterrorمطلوب
- codeالنوع: string | null
- messageالنوع: string
- paramالنوع: string | null
- typeالنوع: string
application/json - النوع: object502
Upload, wallet or upstream error
- النوع: objecterrorمطلوب
- codeالنوع: string | null
- messageالنوع: string
- paramالنوع: string | null
- typeالنوع: string
application/json - النوع: object503
Upload, wallet or upstream error
- النوع: objecterrorمطلوب
- codeالنوع: string | null
- messageالنوع: string
- paramالنوع: string | null
- typeالنوع: string
application/json - النوع: object504
Upload, wallet or upstream error
- النوع: objecterrorمطلوب
- codeالنوع: string | null
- messageالنوع: string
- paramالنوع: string | null
- typeالنوع: string
application/json
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
}
}