API 문서

API 키 발급 및 안전한 보관

인증은 애플리케이션 서버에서 처리해야 합니다. 운영 키를 브라우저 코드, 모바일 번들, 로그 또는 공개 저장소에 넣지 마세요.

1. 1계정을 만들고 대시보드에서 API 키 영역을 여세요.
2. 2키를 복사해 서버 비밀 관리 도구 또는 암호화된 환경에 저장하세요.
3. 3Authorization 헤더에서 Bearer 토큰으로 보내고 노출되면 즉시 교체하세요.

빠른 시작

비동기 음악 작업을 만들고 반환된 workId를 저장한 뒤 완료될 때까지 feed 엔드포인트를 폴링하세요. 서버 키를 설정하면 아래 요청을 실행할 수 있습니다.

export UDIOAPI_KEY='replace-with-your-server-key'

curl --request POST \
  --url 'https://udioapi.pro/api/v2/generate' \
  --header "Authorization: Bearer $UDIOAPI_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "chirp-v5-5",
    "gpt_description_prompt": "Warm indie pop with acoustic guitar",
    "make_instrumental": true
  }'

# Save workId from the response, then poll:
curl 'https://udioapi.pro/api/v2/feed?workId=YOUR_WORK_ID'

추적되는 소스 파일은 UDIOAPI_KEY, 제한된 폴링, 구조화 오류를 사용하며 외부 의존성이 없습니다. GitHub에 fork를 공개하기 전에 모든 비밀값을 제거하세요.

API 엔드포인트

기본 Music Generate 엔드포인트는 /v2/generate입니다. MiniMax는 /v2/minimax/generate로 사용할 수 있는 통합 제공업체이며 기본 음악 생성 모델이 아닙니다.

오류 처리

HTTP 상태와 구조화된 응답 본문을 통합 계약의 일부로 처리하세요. workId와 자체 요청 ID는 기록하되 API 키는 절대 기록하지 마세요.

콘텐츠 검토 실패나 기타 종료된 작업 실패는 재시도하지 마세요. 사용자가 입력을 바꿀 수 있도록 fail_message 또는 error_message를 표시하세요.

변경 내역 요약

호환성에 영향을 주는 API 변경을 여기에 요약하고 관련 엔드포인트로 연결합니다.