무료GitHub에 공개한국어 소개

openai-whisper-api

음성 파일을 OpenAI 전사 API로 보내 결과를 텍스트나 JSON으로 저장합니다. 모델과 언어를 지정하고 화자별로 발언을 구분할 수 있습니다.

원문원문 설명 보기

OpenAI Audio Transcriptions API via curl; gpt-4o-transcribe, mini, diarize, or whisper-1.

openclaw/openclaw

연동 도구OpenAI

AI 평가90점/ 100 설치 방법 보기

이럴 때 유용합니다

회의 녹음을 텍스트로 변환합니다
인터뷰에서 화자를 구분합니다
전사 결과를 JSON으로 저장합니다
음성 언어를 지정해 전사합니다

한국어 소개

할 수 있는 일

음성 파일을 OpenAI 전사 API로 보내 결과를 텍스트나 JSON으로 저장합니다. 포함된 transcribe.sh에서 모델, 저장 위치, 언어를 지정합니다. 기본 모델은 gpt-4o-transcribe이며 입력 파일명에 .txt를 붙여 저장합니다. gpt-4o-mini-transcribe와 whisper-1도 선택할 수 있습니다.

이럴 때 유용합니다

회의나 인터뷰 녹음을 글로 확인하거나 전사 결과를 다른 처리 과정에 전달할 때 사용합니다. 화자를 구분하려면 gpt-4o-transcribe-diarize로 발언에 화자 라벨을 붙일 수 있습니다. 일반 전사에서는 이름 등의 보충 정보를 프롬프트로 전달하는 예시도 제공합니다.

사용 예시

“이 회의 녹음을 전사해서 텍스트로 저장해 주세요.”
“인터뷰를 화자 라벨과 함께 전사해 주세요.”
“음성 언어를 지정하고 JSON으로 출력해 주세요.”

주의 사항

curl, node, OPENAI_API_KEY가 필요합니다. 호스팅 API의 업로드 한도는 25 MB이며 mp3, mp4, m4a, wav, webm 등을 지원합니다. 화자 라벨 모델에서는 --prompt를 사용할 수 없습니다. 호환 프록시나 로컬 게이트웨이 주소는 OPENAI_BASE_URL로 지정합니다.

이 소개문은 공개된 SKILL.md를 바탕으로 AI(OpenAI Codex)가 작성했습니다. 정확한 사양은 아래 원문을 확인하세요.

객관 평가

AI가 SKILL.md의 내용만을 근거로 4가지 관점에서 판정했습니다. 스타 수나 인기도는 판정에 넣지 않았습니다.

지시의 명확성언제 쓰고 무엇을 하는지 알 수 있는가: A양호음성을 전사 API로 보내 텍스트나 JSON을 얻는 용도가 명시되어 있습니다.
절차의 구체성절차·입출력·예시가 구체적으로 적혀 있는가: A양호transcribe.sh 실행 예시와 모델 선택, 출력 경로, 기본값이 제시되어 있습니다.
안전성전송·삭제·명령 실행 등을 명시하고 있는가: B일부 부족음성 업로드와 키 설정은 명시되어 있으나 전송 전 확인 절차는 없습니다.
도입의 용이성필요한 도구나 API 키가 적고 적혀 있는가: A양호curl, node, OPENAI_API_KEY 요건과 키 설정 방법이 제시되어 있습니다.

총점은 각 항목을 A=25점, B=15점, C=5점으로 더한 값입니다. 2026년 10월 19일 기준으로 AI(OpenAI Codex)가 판정했습니다. 참고용이므로 설치 전에 원문도 확인해 주세요.

평가가 다르다고 생각되면 재검토를 요청하기

포함된 파일(2)

SKILL.md2.0 KB
scripts/transcribe.sh3.1 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

OpenAI transcriptions API

Transcribe audio through /v1/audio/transcriptions. Set OPENAI_BASE_URL for an OpenAI-compatible proxy or local gateway.

Quick start

{baseDir}/scripts/transcribe.sh /path/to/audio.m4a

Defaults:

Model: gpt-4o-transcribe
Output: <input>.txt

Useful flags

{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model gpt-4o-transcribe --out /tmp/transcript.txt
{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model gpt-4o-mini-transcribe
{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model gpt-4o-transcribe-diarize --json
{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model whisper-1
{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --language en
{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --prompt "Speaker names: Peter, Daniel"
{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --json --out /tmp/transcript.json

Notes:

Supported upload formats include mp3, mp4, mpeg, mpga, m4a, wav, webm.
25 MB upload limit on the hosted API.
Use diarize for speaker labels; script sends chunking_strategy=auto and rejects --prompt.

API key

Set OPENAI_API_KEY, or configure it in the active OpenClaw config file ($OPENCLAW_CONFIG_PATH, default ~/.openclaw/openclaw.json). Optionally set OPENAI_BASE_URL:

{
  skills: {
    "openai-whisper-api": {
      apiKey: "OPENAI_KEY_HERE",
    },
  },
}

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

같은 저장소의 스킬

1password

무료

Set up and authenticate the 1Password CLI, then supply stored passwords and API keys to commands or configuration. The skill covers desktop integration, service accounts, and interactive sign-in while keeping secrets out of chat and logs.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

Setting up the 1Password CLI
Supplying API keys to commands
Using service account authentication in CI