Audio
음성 인식
model과 file을 multipart/form-data로 전송하세요. 완전한 모노 PCM WAV만 지원하며 최대 25,000,000바이트입니다. 채널별 샘플링 속도와 길이 제한도 적용됩니다. 선택 필드는 language(소문자 두 글자, 예: ko), response_format=json(유일한 형식이자 기본값)입니다. boundary는 curl이 생성하게 하세요. URL, 파일 ID, prompt, 타임스탬프, stream은 지원하지 않습니다.
STT는 input_audio_second 또는 token, TTS는 input_character로 과금합니다. speech_billing_unit의 utf16_code_unit과 unicode_code_point는 emoji 계산이 다릅니다. 사전 예약액은 비용 상한이 아니며 정산은 비동기일 수 있습니다. 증거 부족은 무료가 아닙니다. 두 API는 X-Felo-Channel을 지원하며 선택 채널에 한 번만 전송합니다. 타임아웃·연결 끊김 후 SDK를 포함한 자동 재시도를 끄고 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에는 초 또는 token 사용량이 있습니다.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 열거형값
- 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
}
}