다시 만들지 않고 곡 연장
Extend Song API는 이미 생성한 트랙을 이어줍니다. origin_task_id로 완료된 생성을 지정하고 extend_audio_index로 반환된 두 오디오 중 이어갈 것을 고르면, 플랫폼이 원본이 끝나는 지점에서 이어지는 새 구간을 작곡합니다.
두 가지 모드가 일반적인 작업 흐름을 다룹니다. 상속 모드(custom_mode: false)는 원본 매개변수를 재사용해 마음에 드는 테이크를 늘리는 가장 빠른 방법입니다. 커스텀 모드(custom_mode: true)는 새 prompt, style, title, extensionStartTime을 받아 편곡 방향을 바꿀 수 있습니다 — 예: 고에너지 후렴을 차분한 아웃트로로.
빠른 시작: 연장 후 폴링
원본 태스크로 /v2/extend에 POST한 뒤 /v2/feed?workId=...를 폴링하거나 callback_url로 webhook을 받으세요.
curl -X POST "https://udioapi.pro/api/v2/extend" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"origin_task_id": "gen20e094aeaadfe494ea33a5c80ee596083bksv",
"extend_audio_index": 0,
"custom_mode": true,
"prompt": "Change the music style to be calm and lyrical.",
"style": "lyrical"
}'
curl -X GET "https://udioapi.pro/api/v2/feed?workId=YOUR_WORK_ID"extensionStartTime은 선택 사항입니다. 값은 1 …(원본 길이 − 1)초로 조정되며, 생략 시 원본 트랙 끝에서 시작합니다.
연장 요청 매개변수
연장은 원본 트랙의 모델 가격으로 과금됩니다. chirp-v5 또는 chirp-v5-5로 만든 트랙은 chirp-v6이, 더 오래된 레거시 모델 트랙은 chirp-v6-mini가 연장합니다.
| 매개변수 | 유형 | 필수 | 비고 |
|---|---|---|---|
| origin_task_id | string | 필수 | 원본 생성 요청의 task_id |
| extend_audio_index | number | 필수 | 연장할 반환 오디오: 0 또는 1 |
| custom_mode | boolean | 선택 | false는 원본 매개변수 상속(기본값), true는 커스텀 필드 활성화 |
| prompt | string | 커스텀 모드 | 새 가사 또는 설명, ≤ 5000자 — 초과분은 잘림 |
| style | string | 선택 | 연장 부분의 스타일, ≤ 1000자 — 잘림 |
| title | string | 선택 | 연장 트랙 제목, ≤ 80자 — 잘림 |
| extensionStartTime | number | 선택 | 시작 지점(초). 1 …(원본 길이 − 1)로 조정 |
| callback_url | string | 선택 | 최종 결과를 받을 공개 HTTPS webhook |
거부되거나 실패한 연장은 자동 환불됩니다 — 422 응답은 수정할 매개변수를 알려주고, 승인 후 실패는 feed에 FAILED로 표시되며 크레딧이 반환됩니다.
무엇을 만들 수 있나요
연장은 오디오 API의 나머지 부분과 결합됩니다.
더 긴 편곡
연장을 연결해 원래 길이를 넘는 인트로, 벌스, 아웃트로를 만듭니다.
문서 읽기엔딩 방향 전환
커스텀 모드에서 새 프롬프트와 스타일이 연장의 방향을 결정합니다.
문서 읽기먼저 원본 생성
/v2/generate로 연장할 트랙을 만드세요 — chirp-v6 패밀리는 두 엔드포인트 모두에서 작동합니다.
문서 읽기내 오디오 커버
업로드에서 시작하고 싶다면 upload-cover 엔드포인트가 처리합니다.
문서 읽기타임스탬프 가사
연장 결과의 줄 단위 가사 타이밍을 가져옵니다.
문서 읽기콜백과 폴링
/v2/feed 폴링 또는 callback_url webhook으로 완료를 받습니다.
문서 읽기작동 방식
완료된 생성에서 더 긴 트랙까지 네 단계.
- 1
원본 트랙 생성
/v2/generate로 곡을 만들고 SUCCESS를 기다립니다. task_id를 저장하고 오디오 인덱스를 고릅니다.
- 2
연장 제출
origin_task_id, extend_audio_index 및 선택적 커스텀 필드로 /v2/extend에 POST합니다.
- 3
폴링 또는 콜백 수신
5~10초마다 GET /v2/feed?workId=...를 호출하거나 callback_url로 webhook을 받습니다.
- 4
오디오 다운로드
SUCCESS가 되면 feed에 연장된 오디오 URL이 들어옵니다. 자체 스토리지에 저장하세요.
제한 및 참고 사항
- 완료된 원본 태스크가 필요하며 extend_audio_index는 0 또는 1을 골라야 합니다 — 대부분의 생성은 두 개의 오디오를 반환합니다.
- 연장은 원본 모델의 가격을 상속합니다. chirp-v5/chirp-v5-5 트랙은 chirp-v6이, 오래된 레거시 트랙은 chirp-v6-mini가 연장합니다.
- 너무 긴 prompt, style, title 값은 거부가 아니라 잘립니다.
- extensionStartTime은 요청을 실패시키지 않고 유효 범위로 조정됩니다.
- 오디오 URL은 임시입니다 — 결과를 자체 스토리지에 다운로드하세요.
udioapi.pro는 독립적인 제3자 서비스입니다. Suno, Udio, MiniMax와 제휴하거나 보증받거나 운영되지 않습니다.
Extend Song API FAQ
모드, 과금, 비동기 워크플로에 대한 답변.
Extend Song API는 무엇을 하나요?
완료된 생성을 원래 끝 이후로 이어줍니다. 상속 모드는 원본 매개변수를 재사용하고, 커스텀 모드는 새 prompt, style, title, extensionStartTime을 받습니다.
연장은 어떻게 과금되나요?
원본 트랙의 모델 가격으로 요청당 과금됩니다. chirp-v6이 처리한 트랙의 연장도 같은 12크레딧, chirp-v6-mini는 10크레딧입니다. 거부·실패한 연장은 자동 환불됩니다.
어떤 오디오를 연장해야 하나요?
extend_audio_index를 0으로 하면 첫 번째 오디오, 1이면 두 번째 오디오를 연장합니다 — 대부분의 생성 요청은 두 가지 버전을 만듭니다.
상속 모드와 커스텀 모드의 차이는?
상속 모드(custom_mode: false)는 원본 매개변수로 이어가고, 커스텀 모드(custom_mode: true)는 새 prompt, style, title이 연장을 조정합니다.
extensionStartTime이 범위를 벗어나면?
실패하지 않고 1 …(원본 길이 − 1)초로 조정됩니다. 없거나 잘못된 값은 원본 트랙 끝에서 연장합니다.
연장이 실패하면 크레딧이 드나요?
아니요. 검증에서 거부된 요청은 422를 반환하고, 승인 후 실패한 태스크는 feed에 FAILED로 표시됩니다 — 두 경우 모두 크레딧이 환불됩니다.