Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

Spracherkennung

Server:https://openapi.felo.ai
Client-Bibliotheken

Audio

​

Spracherkennung

​

Senden Sie model und file als multipart/form-data: vollständiges Mono-PCM-WAV, höchstens 25,000,000 Bytes, unter Beachtung der Abtastraten- und Dauergrenzen des Kanals. Optional: language (zwei Kleinbuchstaben, etwa de) und response_format=json (einziges Format und Standard). curl erzeugt die boundary. URLs, Datei-IDs, prompt, Zeitstempel und stream werden nicht unterstützt.

STT nutzt input_audio_second oder Tokens, TTS input_character. Bei speech_billing_unit zählen utf16_code_unit und unicode_code_point Emojis unterschiedlich. Reservierungen sind keine Kostenobergrenze; die Abrechnung kann asynchron erfolgen. Fehlende Belege bedeuten nicht kostenlos. Beide APIs akzeptieren X-Felo-Channel und senden einmal an den ausgewählten Kanal. Automatische Wiederholungen nach Timeout oder Abbruch auch im SDK deaktivieren. X-Request-Id und verfügbare X-Generation-Id aufbewahren. Console Playground unterstützt Audio noch nicht. configured_rates nutzt eingefrorene Tarife und bestätigte Nutzung; upstream_cost nutzt bestätigte Anbieterkosten mit veröffentlichtem Aufschlag und Rabatt.

Header
  • X-Felo-Channel
    Typ: 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.

Body
erforderlich
application/json
Antworten
  • 200
    Typ: object

    Die synchrone JSON-Antwort enthält text und optional usage in Sekunden oder Tokens. usage.cost sind Anbieter-Kosten, nicht die endgültige Felo-Abbuchung. Kein Task-Polling nötig.

    • text
      Typ: string
      erforderlich
    • usage
      Typ: object | null
      • cost
        Typ: number
        min.:  
        0

        Reported upstream cost in USD.

      • input_token_details
        Typ: object
        • audio_tokens
          Typ: integer
          min.:  
          0

          Integer numbers.

        • text_tokens
          Typ: integer
          min.:  
          0

          Integer numbers.

      • input_tokens
        Typ: integer
        min.:  
        0

        Integer numbers.

      • output_tokens
        Typ: integer
        min.:  
        0

        Integer numbers.

      • seconds
        Typ: number
        min.:  
        0

        Duration reported by the selected channel.

      • total_tokens
        Typ: integer
        min.:  
        0

        Integer numbers.

      • type
        Typ: string enum
        Werte
        • duration
        • tokens
    application/json
  • 400
    Typ: object

    Upload, wallet or upstream error

    • error
      Typ: object
      erforderlich
      • code
        Typ: string | null
      • message
        Typ: string
      • param
        Typ: string | null
      • type
        Typ: string
    application/json
  • 402
    Typ: object

    Upload, wallet or upstream error

    • error
      Typ: object
      erforderlich
      • code
        Typ: string | null
      • message
        Typ: string
      • param
        Typ: string | null
      • type
        Typ: string
    application/json
  • 413
    Typ: object

    Upload, wallet or upstream error

    • error
      Typ: object
      erforderlich
      • code
        Typ: string | null
      • message
        Typ: string
      • param
        Typ: string | null
      • type
        Typ: string
    application/json
  • 415
    Typ: object

    Upload, wallet or upstream error

    • error
      Typ: object
      erforderlich
      • code
        Typ: string | null
      • message
        Typ: string
      • param
        Typ: string | null
      • type
        Typ: string
    application/json
  • 429
    Typ: object

    Upload, wallet or upstream error

    • error
      Typ: object
      erforderlich
      • code
        Typ: string | null
      • message
        Typ: string
      • param
        Typ: string | null
      • type
        Typ: string
    application/json
  • 500
    Typ: object

    Upload, wallet or upstream error

    • error
      Typ: object
      erforderlich
      • code
        Typ: string | null
      • message
        Typ: string
      • param
        Typ: string | null
      • type
        Typ: string
    application/json
  • 502
    Typ: object

    Upload, wallet or upstream error

    • error
      Typ: object
      erforderlich
      • code
        Typ: string | null
      • message
        Typ: string
      • param
        Typ: string | null
      • type
        Typ: string
    application/json
  • 503
    Typ: object

    Upload, wallet or upstream error

    • error
      Typ: object
      erforderlich
      • code
        Typ: string | null
      • message
        Typ: string
      • param
        Typ: string | null
      • type
        Typ: string
    application/json
  • 504
    Typ: object

    Upload, wallet or upstream error

    • error
      Typ: object
      erforderlich
      • code
        Typ: string | null
      • message
        Typ: string
      • param
        Typ: string | null
      • type
        Typ: 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

Brauchst du Hilfe?