Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

תמלול דיבור

שרת:https://openapi.felo.ai
ספריות לקוח

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 משתמש בעלות ספק מאומתת עם התוספת וההנחה שפורסמו.

כותרות
  • 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 enum
        ערכים
        • 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

צריך עזרה?