LogoAI Music API
로그인
API변경 내역 (2/10)

개발자 업데이트

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초가 사용됩니다.
    • 다른 모델과 영감 모드에서는 이 필드를 무시합니다.

    통합 영향

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

    엔드포인트 문서 보기