음성 전사의 표준인 OpenAI Whisper large-v3입니다 (1억 4,400만+ 실행). 약 100개 언어 자동 감지, 영어 번역, plain text/SRT/VTT 출력 형식을 지원합니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "openai/whisper",
"input": {
"audio": "https://example.com/meeting.mp3",
"language": "auto",
"transcription": "plain text"
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
audio | string | Yes | - | 전사할 오디오 파일 (mp3, wav, m4a 등) |
transcription | string | No | plain text | 전사 출력 형식 plain textsrtvtt |
translate | boolean | No | false | 전사 결과를 영어로 번역 |
language | string | No | auto | 오디오의 언어. 'auto'면 자동 감지 (한국어는 'ko') autoafamarasazbabebgbnbobrbscacscydadeeleneseteufafifofrglguhahawhehihrhthuhyidisitjajwkakkkmknkolalblnloltlvmgmimkmlmnmrmsmtmynenlnnnoocpaplpsptrorusasdsiskslsnsosqsrsusvswtatetgthtktltrttukuruzviyiyoyuezhAfrikaansAlbanianAmharicArabicArmenianAssameseAzerbaijaniBashkirBasqueBelarusianBengaliBosnianBretonBulgarianBurmeseCantoneseCastilianCatalanChineseCroatianCzechDanishDutchEnglishEstonianFaroeseFinnishFlemishFrenchGalicianGeorgianGermanGreekGujaratiHaitianHaitian CreoleHausaHawaiianHebrewHindiHungarianIcelandicIndonesianItalianJapaneseJavaneseKannadaKazakhKhmerKoreanLaoLatinLatvianLetzeburgeschLingalaLithuanianLuxembourgishMacedonianMalagasyMalayMalayalamMalteseMandarinMaoriMarathiMoldavianMoldovanMongolianMyanmarNepaliNorwegianNynorskOccitanPanjabiPashtoPersianPolishPortuguesePunjabiPushtoRomanianRussianSanskritSerbianShonaSindhiSinhalaSinhaleseSlovakSlovenianSomaliSpanishSundaneseSwahiliSwedishTagalogTajikTamilTatarTeluguThaiTibetanTurkishTurkmenUkrainianUrduUzbekValencianVietnameseWelshYiddishYoruba |
temperature | number | No | 0 | 샘플링 온도. 0이면 결정적 |
patience | number | No | - | 빔 디코딩에 사용할 선택적 patience 값 (https://arxiv.org/abs/2204.05424 참고). 기본값(1.0)은 일반 빔 서치와 동일합니다 |
suppress_tokens | string | No | -1 | 샘플링 중 억제할 토큰 ID의 쉼표 구분 목록. '-1'은 일반적인 문장부호를 제외한 대부분의 특수문자를 억제합니다 |
initial_prompt | string | No | - | 고유명사·전문용어 힌트 텍스트 (선택) |
condition_on_previous_text | boolean | No | true | True이면 이전 윈도우의 모델 출력을 다음 윈도우의 프롬프트로 사용합니다. 비활성화하면 윈도우 간 텍스트 일관성이 떨어질 수 있지만 모델이 실패 루프에 빠질 가능성은 줄어듭니다 |
temperature_increment_on_fallback | number | No | 0.2 | 아래 임계값 중 하나라도 충족하지 못해 폴백할 때 증가시킬 temperature 값 |
compression_ratio_threshold | number | No | 2.4 | gzip 압축률이 이 값보다 높으면 디코딩 실패로 처리 |
logprob_threshold | number | No | -1 | 평균 로그 확률이 이 값보다 낮으면 디코딩 실패로 처리 |
no_speech_threshold | number | No | 0.6 | <|nospeech|> 토큰의 확률이 이 값보다 높고 `logprob_threshold`로 인해 디코딩이 실패한 경우, 해당 구간을 무음으로 간주 |
이 모델의 audio 파라미터에 파일을 전달하는 방법은 3가지입니다.
POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 필요 없습니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=openai/whisper" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:audio=@your_file.png"공개 접근 가능한 URL을 직접 전달합니다. Storage API로 업로드한 파일의 file_url도 사용 가능합니다.
{
"model": "openai/whisper",
"input": {
"prompt": "your prompt here",
"audio": "https://example.com/image.jpg"
}
}POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
자동 감지로 한국어 녹음 전사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "openai/whisper",
"input": {
"audio": "https://example.com/meeting.mp3",
"language": "auto",
"transcription": "plain text"
}
}'자막 파일 형식으로 바로 출력
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "openai/whisper",
"input": {
"audio": "https://example.com/video-audio.mp3",
"transcription": "srt"
}
}'