OpenAI API로 직접 호출하는 whisper-1 음성 인식입니다. OpenAI API 파라미터를 그대로 받습니다 — json·verbose_json 출력, 구간·단어 타임스탬프(timestamp_granularities), 언어 힌트와 프롬프트. 오디오 1초당 0.2325 크레딧(분당 약 14 크레딧)으로 과금되며 요청당 최대 1시간·25MB입니다.
콘솔의 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-1",
"input": {
"audio": "https://replicate.delivery/mgxm/e5159b1b-508a-4be4-b892-e1eb47850bdc/OSR_uk_000_0050_8k.wav",
"response_format": "verbose_json",
"timestamp_granularities": [
"segment"
],
"language": "en"
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
audio | string | Yes | - | 오디오 파일 URL입니다 (flac, m4a, mp3, mp4, mpeg, mpga, ogg, wav, webm). OpenAI에는 `file` 파트로 전달됩니다. 최대 25MB·1시간입니다. |
response_format | string | No | json | json은 {text, usage}를, verbose_json은 여기에 language·duration·타임스탬프 구간/단어를 더해 반환합니다. text, srt, vtt 형식은 이 API로 제공되지 않습니다. jsonverbose_json |
timestamp_granularities | array | No | - | verbose_json의 타임스탬프 단위입니다 — segment, word 또는 둘 다. response_format이 verbose_json이어야 합니다. 단어 타임스탬프는 지연이 늘고, 구간 타임스탬프는 늘지 않습니다. segmentword |
language | string | No | - | 입력 오디오의 언어(ISO-639-1 코드, 예: ko, en, ja)입니다. 정확도와 속도가 좋아집니다. 생략하면 자동 감지합니다. |
prompt | string | No | - | 스타일을 유도하거나 이전 구간을 이어가기 위한 선택 텍스트입니다. 오디오와 같은 언어로 쓰세요. |
temperature | number | No | 0 | 0~1 사이의 샘플링 온도입니다. 0이면 모델이 임계값에 도달할 때까지 자동으로 올립니다. |
이 모델의 audio 파라미터에 파일을 전달하는 방법은 3가지입니다.
공개 접근 가능한 URL을 직접 전달합니다. Storage API(POST /v1/files/upload-url)로 업로드하면 파일이 S3로 직접 올라가고(파일당 50MB), 반환된 file_url을 그대로 쓰면 됩니다.
{
"model": "openai/whisper-1",
"input": {
"prompt": "your prompt here",
"audio": "https://example.com/image.jpg"
}
}POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 없는 대신, 파일이 API 서버를 거치므로 요청 전체 10MB 제한이 적용됩니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=openai/whisper-1" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:audio=@your_file.png"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로도 제공 |
text, language, duration과 시작·끝 초가 있는 segments를 반환합니다.
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-1",
"input": {
"audio": "https://replicate.delivery/mgxm/e5159b1b-508a-4be4-b892-e1eb47850bdc/OSR_uk_000_0050_8k.wav",
"response_format": "verbose_json",
"timestamp_granularities": [
"segment"
],
"language": "en"
}
}'한국어 녹음의 {text, usage}를 반환합니다.
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-1",
"input": {
"audio": "https://example.com/meeting.m4a",
"response_format": "json",
"language": "ko"
}
}'