Audio
תמלול דיבור
שלחו model ו־file בתור multipart/form-data: קובץ PCM WAV מונו שלם, עד 25,000,000 בתים, בהתאם למגבלות קצב הדגימה והמשך של הערוץ. שדות רשות: language (שתי אותיות קטנות, למשל he) ו־response_format=json (הפורמט היחיד וברירת המחדל). תנו ל־curl ליצור boundary. אין תמיכה ב־URL, מזהי קבצים, prompt, חותמות זמן או stream.
STT משתמש ב־input_audio_second או בטוקנים; TTS ב־input_character. ב־speech_billing_unit, utf16_code_unit ו־unicode_code_point סופרים emoji אחרת. שמירת הסכום אינה תקרת הוצאה; החיוב עשוי להסתיים אסינכרונית. חוסר ראיות אינו חינם. שני הממשקים מקבלים 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 enumערכים
- 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
}
}