Voice isolation
사용 가능Send an audio or video link. Get the voice back on its own, with the background noise, music and room echo removed: clean speech for videos, podcasts and interviews.
이용 방법
- 01Send the fileAn https link to an MP3, WAV, M4A, MP4, MOV or WEBM.
- 02We isolate the voiceNoise, music and echo taken out.
- 03Get the audioBilled per started minute.
코드에서 Voice isolation 호출하기
One endpoint and one key, on the same balance as the playground. The request below is the example's own.
https:/ / api.opennan.com/ v1/ audio/ isolationsAPI 키 받기
콘솔에서 키를 만드세요. 플레이그라운드와 같은 잔액을 씁니다.
키 만들기첫 요청 보내기
플레이그라운드가 보내는 것과 같은 요청입니다. OPENNAN_KEY에 키를 넣으세요.
curl https://api.opennan.com/v1/audio/isolations \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"audio_url":"https://cdn.opennan.com/examples/voice-isolation/harbour-noisy-input-135c1c1f.mp3"}' # Then poll until "status" is "succeeded" or "failed": curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"작업 확인하기
호출하면 바로 작업 ID가 돌아옵니다. 끝날 때까지 작업을 확인하세요:
GEThttps:// api.opennan.com/ v1/ tasks/ {id} - queued
- 워커 대기 중
- running
- 생성 중
- succeeded
- 완료: outputs[].url에 파일이 있습니다
- failed
- 실패: 요금이 청구되지 않습니다
오류와 해결 방법
401키가 없거나 틀림
콘솔에서 만든 키를 Authorization: Bearer 헤더로 보내세요.
402잔액 부족
결제 메뉴에서 잔액을 충전한 뒤 같은 호출을 다시 보내세요.
400받을 수 없는 값
error.message에 필드 이름이 나옵니다. 파라미터 표의 값을 쓰세요.
429요청이 너무 많음
몇 초 기다렸다가 다시 시도하고, 429가 반복되면 더 오래 기다리세요.
AI 앱에 Opennan 추가하기
한 번 설치하면 AI가 Opennan의 모든 도구를 씁니다: 영상, 이미지, 채팅, 음성, 음악, 효과음, 3D, 자막, 더빙. 사용하는 앱을 고르고 단계를 따라 하세요.
https:/ / api.opennan.com/ v1/ mcpCodex CLI, Codex 앱, Codex IDE 확장에서 모두 작동합니다(~/.codex/config.toml 공유). 앱이나 IDE가 OPENNAN_KEY를 못 읽으면 키를 넣은 config.toml 방식을 쓰세요. Codex는 도구를 호출하기 전에 묻습니다. 승인하면 계속됩니다.
키를 OPENNAN_KEY로 저장
# macOS / Linux (zsh shown; bash: ~/.bashrc) echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc source ~/.zshrc # Windows (PowerShell), then open a new terminal setx OPENNAN_KEY "sk-..."Opennan 플러그인 설치: 서버와 함께 모델 선택, 가격 확인, 결과 대기를 AI에게 알려 주는 스킬이 들어 있습니다
codex plugin marketplace add Opennan/opennan-ai-plugin codex plugin add opennan@opennan또는 서버만 추가
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEY또는 ~/.codex/config.toml에 추가
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }opennan이 목록에 있는지 확인
codex mcp listCodex을 다시 시작하고 무엇이든 요청하세요
“네온 거리에 내리는 비 5초 영상, 어울리는 노래, 포스터 이미지를 만들어 줘.”
sk-...를 내 키로 바꾸고 비공개로 두세요. 키를 가진 사람은 잔액을 쓸 수 있습니다. 키가 없어도 도구 목록은 보이지만 만들려면 키가 필요합니다.
AI 에이전트에서 사용하기
에이전트에 Opennan MCP 서버를 추가하고 이 도구를 호출하세요.
- 도구
- isolate_voice
- 예시 인수
{ "audio_url": "https://cdn.opennan.com/examples/voice-isolation/harbour-noisy-input-135c1c1f.mp3" }
Voice isolation: 자주 묻는 질문
Voice isolation 요금은 얼마인가요?
$0.13 per minute. The Run button shows the exact price for your input before you start.
코드에서 어떻게 호출하나요?
API 키와 함께 POST https://api.opennan.com/v1/audio/isolations를 보내세요. 작업 ID가 돌아오면 작업이 성공하거나 실패할 때까지 https://api.opennan.com/v1/tasks/{id}을 확인하세요.
AI 에이전트가 쓸 수 있나요?
네. MCP 서버 https://api.opennan.com/v1/mcp를 추가해 isolate_voice 도구를 호출하거나, 에이전트에게 https://api.opennan.com/llms.txt를 알려 주세요.
실행이 실패하면 어떻게 되나요?
실패한 실행은 청구되지 않습니다. 결과에 대해서만 결제합니다.