Music 1.0

이 문서는 영문 원고를 AI로 번역한 내용이라 표현이 어색할 수 있습니다.

프롬프트 기반 음악 생성에는 Music 1.0을 사용하세요. 요청은 텍스트 중심이며 선택적으로 이미지 조건을 지원합니다. 프로바이더 모델 id는 내부에 남습니다.

기본 실행 URL입니다.

model-run 별칭입니다(본문은 같습니다).

공개 모델 id는 sume/music-1.0입니다.

언제 사용하나요

목표방법
텍스트 → 음악prompt만 사용합니다
시각 조건prompt + 선택적 image_url
특정 스타일 피하기제외할 내용을 긍정 prompt에 적으세요(예: "no vocals, no spoken word")

반드시 지켜야 할 제약

  • duration이나 duration_seconds를 보내지 마세요. Music 1.0에서는 인식되지 않으며 거부됩니다.
  • 비어 있지 않은 negative_prompt를 보내지 마세요. Music 1.0 / Lyria 3는 네거티브 프롬프트를 지원하지 않으며, 값이 비어 있지 않으면 public_reason=negative_prompt_unsupported와 함께 HTTP 400을 반환합니다. 필드를 생략하거나 ""를 보내세요.
  • 프롬프트 최대 길이는 5000자입니다.
  • 이미지 URL은 공개 HTTPS여야 합니다. 요청 객체를 재사용하는 클라이언트에서 이미지 입력을 의도적으로 비울 때만 image_url에 null을 보내세요.

요청 필드

필드필수설명
prompt예1~5000자입니다. 제외할 내용도 긍정 프롬프트에 포함하세요.
negative_prompt아니요비어 있지 않으면 지원되지 않습니다. 생략하거나 ""를 보내세요.
image_url아니요선택적인 공개 HTTPS 이미지 URL이거나, 비우려면 null입니다.
metadata아니요Job에 저장되는 호출자 메타데이터입니다. 프로바이더로 전달되지 않습니다.
mode아니요async, sync, subscribe, webhook입니다.
webhook_url아니요웹훅 모드를 위한 공개 HTTPS 콜백입니다.
wait_timeout_seconds아니요sync / subscribe에서 0~30입니다.

음악 Job 만들기

Generate a Music 1.0 job

POST /v1/music-1.0/generate

Required

이미지 조건을 준 예제입니다.

폴링하고 결과 가져오기

성공하면 result.artifacts[]에서 type이 audio인 오디오 산출물을 읽으세요(보통 media.sume.com의 audio/mpeg입니다).

산출물

완료된 Music 1.0 Job은 Sume가 호스팅하는 오디오 산출물을 반환합니다.

결과의 Sume 미디어 URL을 사용하세요. 원본 프로바이더 URL은 공개 출력이 아닙니다.

가격

접수된 Music 1.0 생성마다 고정 0.10 USD입니다. 프롬프트 길이나 선택적 이미지 조건에 따라 달라지지 않습니다.

다음