Sound effects

사용 가능

Describe a sound. Get it back as audio in the same response: footsteps on gravel, heavy rain, a door slam, a whoosh, up to 22 seconds long.

$0.0026 per secondFailed runs are not charged.

Sound effects

입력

Describe the soundtextThe sound to make.

45 / 1,000

Lengthduration_secondsSeconds of sound.5 s

Formatresponse_format

$0.0026 per started second.

5 s5 s

예시

출력 예시

Sound effects

0:00 / 0:00

이용 방법

01Describe the soundWhat it is and how it should feel, up to 1,000 characters.
02We make itOne sound, as long as you ask for.
03Get the audioMP3, WAV or Opus, in the same response.

코드에서 Sound effects 호출하기

One endpoint and one key, on the same balance as the playground. The request below is the example's own.

POSThttps://api.opennan.com/v1/audio/sound-effects

API 키 받기
콘솔에서 키를 만드세요. 플레이그라운드와 같은 잔액을 씁니다.
키 만들기

첫 요청 보내기

플레이그라운드가 보내는 것과 같은 요청입니다. OPENNAN_KEY에 키를 넣으세요.

curl https://api.opennan.com/v1/audio/sound-effects \
  -H "Authorization: Bearer $OPENNAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"heavy rain on a tin roof with distant thunder","duration_seconds":5}' \
  --output sound.mp3

결과 읽기
결과는 같은 응답으로 옵니다. X-Usage-Cost-Usd 헤더에 호출 비용이 나옵니다.

오류와 해결 방법

401키가 없거나 틀림
콘솔에서 만든 키를 Authorization: Bearer 헤더로 보내세요.
402잔액 부족
결제 메뉴에서 잔액을 충전한 뒤 같은 호출을 다시 보내세요.
400받을 수 없는 값
error.message에 필드 이름이 나옵니다. 파라미터 표의 값을 쓰세요.
429요청이 너무 많음
몇 초 기다렸다가 다시 시도하고, 429가 반복되면 더 오래 기다리세요.

AI 앱에 Opennan 추가하기

한 번 설치하면 AI가 Opennan의 모든 도구를 씁니다: 영상, 이미지, 채팅, 음성, 음악, 효과음, 3D, 자막, 더빙. 사용하는 앱을 고르고 단계를 따라 하세요.

MCP 서버https://api.opennan.com/v1/mcp

Codex CLI, Codex 앱, Codex IDE 확장에서 모두 작동합니다(~/.codex/config.toml 공유). 앱이나 IDE가 OPENNAN_KEY를 못 읽으면 키를 넣은 config.toml 방식을 쓰세요. Codex는 도구를 호출하기 전에 묻습니다. 승인하면 계속됩니다.

API 키 받기
콘솔에서 키를 만드세요. sk-로 시작하며 웹사이트와 같은 잔액을 씁니다.
키 만들기

키를 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-..."

3
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-..." }

4
opennan이 목록에 있는지 확인
```
codex mcp list
```
Codex을 다시 시작하고 무엇이든 요청하세요
“네온 거리에 내리는 비 5초 영상, 어울리는 노래, 포스터 이미지를 만들어 줘.”

sk-...를 내 키로 바꾸고 비공개로 두세요. 키를 가진 사람은 잔액을 쓸 수 있습니다. 키가 없어도 도구 목록은 보이지만 만들려면 키가 필요합니다.

AI 에이전트에서 사용하기

에이전트에 Opennan MCP 서버를 추가하고 이 도구를 호출하세요.

도구: generate_sfx
예시 인수: { "text": "heavy rain on a tin roof with distant thunder", "duration_seconds": 5 }

Sound effects: 자주 묻는 질문

Sound effects 요금은 얼마인가요?

$0.0026 per second. The Run button shows the exact price for your input before you start.

코드에서 어떻게 호출하나요?

API 키와 함께 POST https://api.opennan.com/v1/audio/sound-effects를 보내세요. 결과는 같은 응답으로 옵니다.

AI 에이전트가 쓸 수 있나요?

네. MCP 서버 https://api.opennan.com/v1/mcp를 추가해 generate_sfx 도구를 호출하거나, 에이전트에게 https://api.opennan.com/llms.txt를 알려 주세요.

실행이 실패하면 어떻게 되나요?

실패한 실행은 청구되지 않습니다. 결과에 대해서만 결제합니다.

Sound effects

입력

출력

이용 방법

코드에서 Sound effects 호출하기

API 키 받기

첫 요청 보내기

결과 읽기

오류와 해결 방법

AI 앱에 Opennan 추가하기

AI 에이전트에서 사용하기

Sound effects: 자주 묻는 질문