Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

Transcripción de voz

Servidor:https://openapi.felo.ai
Bibliotecas cliente

Audio

​

Transcripción de voz

​

Envíe model y file como multipart/form-data: WAV PCM mono completo, máximo 25,000,000 bytes, sujeto a límites de frecuencia y duración del canal. Opcionales: language (dos letras minúsculas, p. ej. es) y response_format=json (único formato y predeterminado). curl debe generar boundary. No se admiten URL, ID de archivo, prompt, marcas de tiempo ni stream.

STT usa input_audio_second o tokens; TTS usa input_character. En speech_billing_unit, utf16_code_unit y unicode_code_point cuentan emoji de forma distinta. La reserva no es un límite de gasto; la liquidación puede ser asíncrona. La falta de pruebas no significa coste cero. Ambos aceptan X-Felo-Channel y envían una vez al canal elegido. Desactive reintentos automáticos, también del SDK, tras timeout o desconexión. Conserve X-Request-Id y el X-Generation-Id disponible. Console Playground aún no admite audio. configured_rates usa tarifas congeladas y uso verificado; upstream_cost usa el coste verificado del proveedor con el recargo y descuento publicados.

Encabezados
  • X-Felo-Channel
    Tipo: 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.

Cuerpo
obligatorio
application/json
Respuestas
  • 200
    Tipo: object

    El JSON síncrono contiene text y opcionalmente usage en segundos o tokens. usage.cost es el coste del proveedor, no el cargo final Felo. No hay que consultar una tarea.

    • text
      Tipo: string
      obligatorio
    • usage
      Tipo: object | null
      • cost
        Tipo: number
        mín.:  
        0

        Reported upstream cost in USD.

      • input_token_details
        Tipo: object
        • audio_tokens
          Tipo: integer
          mín.:  
          0

          Integer numbers.

        • text_tokens
          Tipo: integer
          mín.:  
          0

          Integer numbers.

      • input_tokens
        Tipo: integer
        mín.:  
        0

        Integer numbers.

      • output_tokens
        Tipo: integer
        mín.:  
        0

        Integer numbers.

      • seconds
        Tipo: number
        mín.:  
        0

        Duration reported by the selected channel.

      • total_tokens
        Tipo: integer
        mín.:  
        0

        Integer numbers.

      • type
        Tipo: string enum
        valores
        • duration
        • tokens
    application/json
  • 400
    Tipo: object

    Upload, wallet or upstream error

    • error
      Tipo: object
      obligatorio
      • code
        Tipo: string | null
      • message
        Tipo: string
      • param
        Tipo: string | null
      • type
        Tipo: string
    application/json
  • 402
    Tipo: object

    Upload, wallet or upstream error

    • error
      Tipo: object
      obligatorio
      • code
        Tipo: string | null
      • message
        Tipo: string
      • param
        Tipo: string | null
      • type
        Tipo: string
    application/json
  • 413
    Tipo: object

    Upload, wallet or upstream error

    • error
      Tipo: object
      obligatorio
      • code
        Tipo: string | null
      • message
        Tipo: string
      • param
        Tipo: string | null
      • type
        Tipo: string
    application/json
  • 415
    Tipo: object

    Upload, wallet or upstream error

    • error
      Tipo: object
      obligatorio
      • code
        Tipo: string | null
      • message
        Tipo: string
      • param
        Tipo: string | null
      • type
        Tipo: string
    application/json
  • 429
    Tipo: object

    Upload, wallet or upstream error

    • error
      Tipo: object
      obligatorio
      • code
        Tipo: string | null
      • message
        Tipo: string
      • param
        Tipo: string | null
      • type
        Tipo: string
    application/json
  • 500
    Tipo: object

    Upload, wallet or upstream error

    • error
      Tipo: object
      obligatorio
      • code
        Tipo: string | null
      • message
        Tipo: string
      • param
        Tipo: string | null
      • type
        Tipo: string
    application/json
  • 502
    Tipo: object

    Upload, wallet or upstream error

    • error
      Tipo: object
      obligatorio
      • code
        Tipo: string | null
      • message
        Tipo: string
      • param
        Tipo: string | null
      • type
        Tipo: string
    application/json
  • 503
    Tipo: object

    Upload, wallet or upstream error

    • error
      Tipo: object
      obligatorio
      • code
        Tipo: string | null
      • message
        Tipo: string
      • param
        Tipo: string | null
      • type
        Tipo: string
    application/json
  • 504
    Tipo: object

    Upload, wallet or upstream error

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

¿Necesitas ayuda?