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.
- Tipo: 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.
- Tipo: object200
El JSON síncrono contiene
texty opcionalmenteusageen segundos o tokens.usage.costes el coste del proveedor, no el cargo final Felo. No hay que consultar una tarea.- Tipo: stringtextobligatorio
- Tipo: object | nullusage
- costTipo: numbermín.:0
Reported upstream cost in USD.
- inputTipo: object
_token _details - audioTipo: integer
_tokens mín.:0Integer numbers.
- textTipo: integer
_tokens mín.:0Integer numbers.
- inputTipo: integer
_tokens mín.:0Integer numbers.
- outputTipo: integer
_tokens mín.:0Integer numbers.
- secondsTipo: numbermín.:0
Duration reported by the selected channel.
- totalTipo: integer
_tokens mín.:0Integer numbers.
- typeTipo: string enumvalores
- duration
- tokens
application/json - Tipo: object400
Upload, wallet or upstream error
- Tipo: objecterrorobligatorio
- codeTipo: string | null
- messageTipo: string
- paramTipo: string | null
- typeTipo: string
application/json - Tipo: object402
Upload, wallet or upstream error
- Tipo: objecterrorobligatorio
- codeTipo: string | null
- messageTipo: string
- paramTipo: string | null
- typeTipo: string
application/json - Tipo: object413
Upload, wallet or upstream error
- Tipo: objecterrorobligatorio
- codeTipo: string | null
- messageTipo: string
- paramTipo: string | null
- typeTipo: string
application/json - Tipo: object415
Upload, wallet or upstream error
- Tipo: objecterrorobligatorio
- codeTipo: string | null
- messageTipo: string
- paramTipo: string | null
- typeTipo: string
application/json - Tipo: object429
Upload, wallet or upstream error
- Tipo: objecterrorobligatorio
- codeTipo: string | null
- messageTipo: string
- paramTipo: string | null
- typeTipo: string
application/json - Tipo: object500
Upload, wallet or upstream error
- Tipo: objecterrorobligatorio
- codeTipo: string | null
- messageTipo: string
- paramTipo: string | null
- typeTipo: string
application/json - Tipo: object502
Upload, wallet or upstream error
- Tipo: objecterrorobligatorio
- codeTipo: string | null
- messageTipo: string
- paramTipo: string | null
- typeTipo: string
application/json - Tipo: object503
Upload, wallet or upstream error
- Tipo: objecterrorobligatorio
- codeTipo: string | null
- messageTipo: string
- paramTipo: string | null
- typeTipo: string
application/json - Tipo: object504
Upload, wallet or upstream error
- Tipo: objecterrorobligatorio
- codeTipo: string | null
- messageTipo: string
- paramTipo: string | null
- typeTipo: 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
}
}