Audio
تبدیل گفتار به متن
model و file را با multipart/form-data بفرستید: PCM WAV تککانالهٔ کامل، حداکثر 25,000,000 بایت، مطابق محدودیت نرخ نمونهبرداری و مدت کانال. اختیاری: language (دو حرف کوچک، مانند fa) و response_format=json (تنها قالب و پیشفرض). تولید boundary را به curl بسپارید. URL، شناسهٔ فایل، prompt، برچسب زمانی و stream پشتیبانی نمیشوند.
STT از input_audio_second یا توکن و TTS از input_character استفاده میکند. در speech_billing_unit، utf16_code_unit و unicode_code_point ایموجی را متفاوت میشمارند. رزرو سقف هزینه نیست؛ تسویه ممکن است ناهمگام باشد. نبود مدرک به معنی رایگان نیست. هر دو API، X-Felo-Channel میپذیرند و یک بار به کانال منتخب میفرستند. تلاش مجدد خودکار، از جمله SDK، را پس از timeout یا قطع اتصال غیرفعال کنید؛ 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
}
}