Suno API
AI 음악 생성을 위한 Suno API 액세스 — 텍스트 프롬프트로 보컬, 악기, 가사가 포함된 노래를 만들 수 있습니다.
curl -X POST https://runapi.ai/api/v1/suno/stitch_audio \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v5.5",
"prompt": "부드러운 피아노, 바이닐 스크래치 소리, 잔잔한 베이스 라인이 있는 2분짜리 lo-fi 칠 비트를 작성해 주세요."
}'import { SunoClient } from "@runapi.ai/suno";
const client = new SunoClient();
const result = await client.stitchAudio.run({
model: "suno-v5.5",
prompt: "부드러운 피아노, 바이닐 스크래치 소리, 잔잔한 베이스 라인이 있는 2분짜리 lo-fi 칠 비트를 작성해 주세요.",
});<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\Suno\SunoClient;
$client = new SunoClient();
$result = $client->stitchAudio->run([
'model' => 'suno-v5.5',
'prompt' => '부드러운 피아노, 바이닐 스크래치 소리, 잔잔한 베이스 라인이 있는 2분짜리 lo-fi 칠 비트를 작성해 주세요.',
]);require "runapi/suno"
client = RunApi::Suno::Client.new
result = client.stitch_audio.run(
model: "suno-v5.5",
prompt: "부드러운 피아노, 바이닐 스크래치 소리, 잔잔한 베이스 라인이 있는 2분짜리 lo-fi 칠 비트를 작성해 주세요."
)npx skills add runapi-ai/suno -g# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursorSuno는 텍스트 프롬프트로부터 보컬, 악기, 가사를 포함한 완성된 노래를 생성합니다. V4부터 V5.5까지 지원하며, 각 생성마다 모든 음악 장르에 걸쳐 방송 준비가 된 트랙을 만들어 냅니다.
- 품질과 지연 시간 목표에 맞춘 모델 변형
- 통합 API key
- Model skill에 docs, schema, 설정 메모 포함
- 실패한 생성은 과금되지 않습니다
변형
Utility endpoints
Shared endpoints for this model line, such as extension, enhancement, or conversion actions.
앱 개발을 위해 Suno skill 설치
모델 docs, schema, 가격 메모, 설정 단계를 코딩 워크스페이스로 불러옵니다.
# Install the model skill for app development workflows
npx skills add runapi-ai/suno -gInstall the Suno skill for this app: 1. Add runapi-ai/suno with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
이 model skill로 구현하는 방법
모델 선택
출력 유형, 품질 기준, 지연 시간 목표에 맞는 모델과 변형을 고릅니다.
한 번 인증
모든 지원 모델에 RunAPI key를 사용합니다.
skill 설치
기능을 구현하기 전에 코딩 워크스페이스에 model skill을 추가합니다.
결과 받기
task ID로 조회하거나 생성 완료 시 callback을 처리합니다.
Suno의 위치
Suno는 텍스트 설명으로부터 보컬, 악기, 가사를 포함한 오리지널 노래를 만드는 AI 음악 생성 플랫폼입니다. RunAPI를 통해 모든 Suno 버전은 단일 API 키와 호출별 과금 방식을 공유합니다.
RunAPI로 Suno을 쓰는 이유
하나의 API key
모델과 제공사를 넘나들며 같은 인증 정보를 사용합니다.
Skill-ready
model skill에 schema, 설정 메모, 가격 컨텍스트, 모델 ID가 포함됩니다.
예측 가능한 과금
호출 전에 사용량 기반 가격을 확인할 수 있습니다.
자주 묻는 질문
생성된 노래의 최대 길이는 얼마인가요?
v4.5 및 v5+ 에서 생성당 최대 8분까지 가능합니다(이전 버전은 최대 4분). 더 긴 트랙을 위해서는 Extend 엔드포인트를 사용해 구간을 연결하세요.
직접 가사를 제공할 수 있나요?
네 — [Verse], [Chorus], [Bridge] 태그와 함께 가사를 전달할 수 있습니다. 또는 Suno가 주제 프롬프트로부터 가사를 작성하게 할 수도 있습니다.
생성에 얼마나 걸리나요?
일반적으로 트랙당 30~120초가 소요됩니다. 인스트루멘탈 전용 트랙은 더 빨리 생성되는 경향이 있습니다.
인스트루멘탈 전용 트랙을 만들 수 있나요?
네 — instrumental 플래그를 true로 설정하면 Suno가 보컬 없는 트랙을 생성합니다.
어떤 장르가 지원되나요?
팝, 재즈, lo-fi, 클래식, 메탈, 힙합, 일렉트로닉 등 모든 장르를 지원합니다. 프롬프트에 원하는 장르를 설명하세요.
이 모델은 어떻게 호출하나요?
model skill을 설치하고 RunAPI key와 함께 설정 메모를 따르세요.
실패한 생성도 비용이 드나요?
실패한 생성은 과금되지 않습니다
애플리케이션에서 호출할 수 있나요?
네. 코딩 워크스페이스에 model skill을 설치하고 모델 기능을 추가할 때 사용하세요.