LogoAI Music API
로그인

API 엔드포인트

변경 내역

개발자 업데이트

API 변경 내역

출시된 API 기능, 호환성 안내와 통합에 필요한 조치를 확인하세요.

최근 업데이트

2026년 9월 17일

릴리스 기록

업데이트 6건
  1. 변경
    이전 버전과 호환POST /v2/generate · /v2/extend · /v2/upload-cover/generateAll models

    거부된 요청은 422 또는 500을 반환하고 즉시 환불

    생성 엔드포인트는 이제 검증 거부를 동기적으로 보고하고 크레딧을 환불하며, 200을 반환한 뒤 끝나지 않는 작업을 남기지 않습니다.

    변경 내용

    • 422는 검증 중 요청 매개변수가 거부되었음을 의미하며 message에 수정할 필드(예: title 또는 extensionStartTime)가 표시됩니다.
    • 500은 일시적인 오류를 의미하므로 나중에 다시 시도하세요.
    • 두 응답 모두 data.task_id, data.refunded, workId를 포함하며 작업은 FAILED로 표시됩니다.
    • 수락 후 실패한 작업(확장 포함)은 fail_message와 함께 FAILED로 표시되고 크레딧이 자동 환불됩니다.
    • 이전에는 이런 요청이 200을 반환하고 작업이 무기한 IN_PROGRESS 상태로 남았습니다.

    통합 영향

    422는 명시된 매개변수를 수정하고, 500은 나중에 다시 시도하세요. 두 응답 모두 data.refunded를 포함합니다.

    엔드포인트 문서 보기
  2. 변경
    이전 버전과 호환POST /v2/extendAll models

    extend 요청은 실패 대신 텍스트와 시작 시간을 정규화

    POST /v2/extend는 이제 너무 긴 Custom Mode 텍스트를 잘라내고 extensionStartTime을 범위 내로 조정하므로 이 필드 때문에 제출이 거부되지 않습니다.

    변경 내용

    • title은 80자로 제한되며 더 긴 값은 잘립니다.
    • prompt는 5000자, style은 1000자로 제한되며 더 긴 값은 잘립니다.
    • extensionStartTime은 1 ~ (원본 길이 - 1)초로 조정되며, 누락되거나 잘못된 값은 원본 트랙 끝을 사용합니다.
    • 확장은 원본 트랙 모델 가격으로 청구되며 chirp-v6(chirp-v5 / chirp-v5-5 트랙) 또는 chirp-v6-mini(이전 레거시 트랙)가 생성합니다.

    통합 영향

    이 업데이트는 이전 버전과 호환됩니다. 잘림을 피하려면 title을 80자 이내로 유지하세요.

    엔드포인트 문서 보기
  3. 변경
    이전 버전과 호환POST /v2/generate · /v2/extend · /v2/upload-cover/generatechirp-v3-5 … chirp-v5-5

    레거시 chirp-v3-5 ~ chirp-v5-5 식별자는 chirp-v6 계열이 처리

    중단된 모델 식별자를 계속 보내는 요청도 정상 작동하며 기존 가격이 유지됩니다.

    변경 내용

    • chirp-v5와 chirp-v5-5(12크레딧)는 chirp-v6가 처리합니다.
    • chirp-v3-5, chirp-v4-0, chirp-v4-5, chirp-v4-5-plus, chirp-v4-5-all은 chirp-v6-mini가 처리합니다.
    • 각 레거시 식별자는 기존 가격(5, 8, 10 또는 12크레딧)으로 청구됩니다.
    • status, feed, callback 결과의 model_name은 이제 항상 실제로 오디오를 생성한 공개 모델(예: chirp-v6-mini)을 표시합니다.
    • model 필드를 생략하면 5크레딧 기본 등급으로 청구되며 chirp-v6-mini가 처리합니다.

    통합 영향

    변경이 필요하지 않습니다. 편할 때 model 필드를 chirp-v6 또는 chirp-v6-mini로 업데이트하세요.

    엔드포인트 문서 보기
  4. 추가
    이전 버전과 호환POST /v2/generate · /v2/upload-cover/generatechirp-v6 · chirp-v6-mini · chirp-v6-wild

    chirp-v6, chirp-v6-mini, chirp-v6-wild 모델

    현재 모델 라인업은 chirp-v6 계열이며 generate, upload-cover, extend에서 사용할 수 있습니다.

    변경 내용

    • chirp-v6는 플래그십 모델, chirp-v6-mini는 빠르고 경제적인 등급, chirp-v6-wild는 더 실험적인 변형입니다.
    • chirp-v6와 chirp-v6-wild는 요청당 12크레딧, chirp-v6-mini는 10크레딧입니다.
    • 텍스트 제한은 모든 모델에 동일합니다: 사용자 지정 prompt 5000, 영감 prompt 3000, style 1000, title 80(upload-cover는 100). 긴 입력은 거부되지 않고 잘립니다.
    • chirp-v6 트랙의 확장은 같은 모델을 사용하며, Custom Mode generate 요청에서는 duration 필드가 전달됩니다.

    통합 영향

    이 업데이트는 이전 버전과 호환됩니다. 새 통합은 chirp-v6-mini 또는 chirp-v6로 전환하세요.

    엔드포인트 문서 보기
  5. 추가
    이전 버전과 호환POST /v2/generate · /v2/upload-cover/generatechirp-v6 family

    image_urls로 이미지에서 음악 생성

    POST /v2/generate와 POST /v2/upload-cover/generate가 트랙 분위기를 결정하는 참고 이미지를 받을 수 있습니다.

    변경 내용

    • image_urls는 공개적으로 접근 가능한 이미지 URL 최대 5개를 담은 배열로 보냅니다.
    • JPEG, JPG, PNG, WEBP를 지원하며 이미지당 최대 10MB입니다.
    • 이미지는 영감 모드(generate)와 비사용자 지정 모드(upload-cover)에서만 적용되며 Custom Mode에서는 무시됩니다.
    • 이미지 입력은 모델 가격에 요청당 1크레딧이 추가됩니다.
    • 이미지를 제공하면 텍스트 프롬프트는 선택 사항입니다. 둘을 함께 사용해 결과를 조정하세요.

    통합 영향

    이 업데이트는 이전 버전과 호환됩니다. 이미지가 결과에 영향을 주길 원할 때만 image_urls를 추가하세요.

    엔드포인트 문서 보기
  6. 추가
    이전 버전과 호환POST /v2/generatechirp-v5-5

    chirp-v5-5 사용자 지정 길이 지원

    chirp-v5-5 사용자 지정 모드 요청에서 목표 트랙 길이를 지정할 수 있습니다.

    변경 내용

    • duration 필드는 chirp-v5-5 사용자 지정 모드에서만 사용할 수 있습니다.
    • 10초에서 360초 사이의 숫자를 전송합니다.
    • 값이 없거나 유효하지 않으면 20초가 사용됩니다.
    • 다른 모델과 영감 모드에서는 이 필드를 무시합니다.

    통합 영향

    이 업데이트는 이전 버전과 호환됩니다. 기존 요청은 변경 없이 계속 작동합니다.

    엔드포인트 문서 보기