영감 프롬프트 API

2026-09-18 업데이트 · Suno-API 팀

인터페이스 설명

영감 프롬프트 API는 무작위 곡 설명, 가사 주제, 스타일 태그 제안을 반환합니다. "무작위 영감"과 "태그 새로고침" 버튼에 적합합니다.

엔드포인트: POST /api/prompts/suggestions

과금: 무료 한도 내에서는 무료(사용자당 분당 최대 10회, 하루 최대 300회); 무료 한도를 넘으면 회당 0.1위안이 부과됩니다.

한도 초과 감지: 무료 한도를 넘어도 요청은 정상 실행되며, 응답 헤더에 X-Suno-Helper-Free: false와 X-Suno-Helper-Over-Limit: minute(또는 day)가 실립니다. 이를 보고 클라이언트에서 이번 호출이 과금되었음을 안내할 수 있습니다.

권장 모델: suno-v6. suno-v6, suno-v6-wild, suno-v6-mini를 사용할 수 있습니다.

인증

요청 파라미터

요청 예시

curl -X POST https://www.suno-api.io/api/prompts/suggestions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6"
  }'

응답 결과

{
  "code": 200,
  "message": "success",
  "data": {
    "prompts": ["A dreamy synth-pop track about city lights after rain"],
    "lyrics_prompts": ["밤, 재회, 후회에 관한 한국어 가사를 써 줘"],
    "tags": ["dreamy synth-pop", "warm piano", "male vocal"],
    "is_pending_personalization": false
  }
}

필드 설명