플레이그라운드
이 모델은 OmniaKey 계정으로 사용할 수 있습니다.
01
어울리는 용도
Suno v4.5는 데모, 배경 음악, 징글, 가사 초안에 적합하며 생성 1회당 $0.30입니다. 생성마다 완성된 곡 한 곡이 반환되고, 가사 전송 여부와 관계없이 한 번만 청구됩니다.
02
할 수 있는 일
텍스트를 음악으로
suno-v4.5
스타일 설명과 선택적 가사로 완성된 곡을 만듭니다.
03
호출 방법
미디어 모델은 비동기로 동작합니다. 작업을 만들고 완료될 때까지 폴링한 뒤 서명된 에셋 URL을 내려받으세요.
생성, 폴링, 다운로드
# 1. Create the job. 202 Accepted; the body carries the task id,
# the pre-charged price, and a poll_url. Reuse one Idempotency-Key
# across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
-H "Authorization: Bearer $OMNIAKEY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: suno-v4.5-001" \
-d '{
"model": "suno-v4.5",
"type": "audio",
"operation": "generate",
"input": {"prompt": "a paper boat on a quiet lake at sunset"},
"parameters": {"title": "Paper Boats"}
}'
# 2. Description mode sends input.prompt alone and lets the model write
# the words. Custom lyrics mode adds input.lyrics plus the style:
# {"prompt": "indie folk", "lyrics": "[Verse] ..."} —
# parameters.style (or .tags) overrides the style, and
# parameters.instrumental: true drops the vocal entirely.
# 3. Poll GET /v1/media/tasks/{id} until status is
# succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
-H "Authorization: Bearer $OMNIAKEY_API_KEY"
# 4. Download assets[0].url before expires_at, or poll again for a
# fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.mp3 "$(jq -r '.assets[0].url' result.json)"04
가격
음악 작업은 토큰이 아니라 성공한 생성 건당 청구됩니다. 실패하거나 취소된 작업은 자동으로 환불됩니다.
성공한 호출당
$0.30호출당
자주 묻는 질문
OmniaKey에서 Suno v4.5을(를) 어떻게 호출하나요?
/v1/media/tasks에 POST하고 모델 id, type은 "audio", operation은 "generate"를 지정합니다. 설명 모드에서는 input.prompt를 보내고, 직접 쓴 가사를 쓰려면 input.lyrics를 추가합니다. 재시도 시에는 같은 Idempotency-Key를 재사용해 타임아웃으로 두 번 결제되는 일을 막으세요.
Suno v4.5 비용은 얼마인가요?
Suno v4.5은 성공한 생성 건당 $0.30 호출당를 청구합니다. 작업 생성 시 선불 잔액에서 해당 금액이 미리 차감되며, 실패하거나 취소된 작업은 자동으로 환불됩니다.
왜 API가 곡 대신 작업 id를 반환하나요?
음악 렌더링에는 약 30초에서 몇 분이 걸리므로 OmniaKey는 모든 오디오 경로를 하나의 비동기 생명주기로 처리합니다. 상태가 succeeded가 될 때까지 GET /v1/media/tasks/{id}를 폴링한 뒤 서명된 자산 URL을 읽으세요.
