Suno API
AI 음악 생성을 위한 Suno API 액세스 — 텍스트 프롬프트로 보컬, 악기, 가사가 포함된 노래를 만들 수 있습니다.
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-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.textToMusic.run({
model: "suno-v5.5",
prompt: "부드러운 피아노, 바이닐 스크래치 소리, 잔잔한 베이스 라인이 있는 2분짜리 lo-fi 칠 비트를 작성해 주세요.",
});<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\Suno\SunoClient;
$client = new SunoClient();
$result = $client->textToMusic->run([
'model' => 'suno-v5.5',
'prompt' => '부드러운 피아노, 바이닐 스크래치 소리, 잔잔한 베이스 라인이 있는 2분짜리 lo-fi 칠 비트를 작성해 주세요.',
]);require "runapi/suno"
client = RunApi::Suno::Client.new
result = client.text_to_music.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는 텍스트 프롬프트로부터 보컬, 악기, 가사를 포함한 완성된 노래를 생성합니다. V3.5부터 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가 포함됩니다.
예측 가능한 과금
호출 전에 사용량 기반 가격을 확인할 수 있습니다.
자주 묻는 질문
이 모델은 어떻게 호출하나요?
model skill을 설치하고 RunAPI key와 함께 설정 메모를 따르세요.
실패한 생성도 비용이 드나요?
실패한 생성은 과금되지 않습니다
애플리케이션에서 호출할 수 있나요?
네. 코딩 워크스페이스에 model skill을 설치하고 모델 기능을 추가할 때 사용하세요.