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(소문자 두 글자, 예: 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는 검증된 공급자 비용과 게시된 가산율·할인으로 정산합니다.

헤더
  • 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에는 초 또는 token 사용량이 있습니다. 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 열거형
        값
        • 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

도움이 필요하신가요?

  • API, 결제, 계정 관련 문의는 지원에서 안내해 드립니다.
  • Discord에서 Felo 개발자와 대화해 보세요.
  • 변경 내역을 확인해 보세요.
  • 대량 구매 가격이나 구매 관련 도움이 필요하신가요? 영업팀 문의.
  • LLM으로 구축 중이신가요? llms.txt를 읽어 보세요.