Producer API
입력한 가사 그대로 또는 인스트루멘털 프로덕션 브리프로 FUZZ 음악을 생성하는 Producer API를 RunAPI에서 사용하세요.
curl -X POST https://runapi.ai/api/v1/producer/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "fuzz-2.0-raw",
"prompt": "입력한 이 가사를 또렷한 보컬로 부르는 따뜻한 어쿠스틱 팝 트랙을 만들어 주세요."
}'
import { ProducerClient } from "@runapi.ai/producer";
const client = new ProducerClient();
const result = await client.textToMusic.run({
model: "fuzz-2.0-raw",
prompt: "입력한 이 가사를 또렷한 보컬로 부르는 따뜻한 어쿠스틱 팝 트랙을 만들어 주세요.",
});
require "runapi/producer"
client = RunApi::Producer::Client.new
result = client.text_to_music.run(
model: "fuzz-2.0-raw",
prompt: "입력한 이 가사를 또렷한 보컬로 부르는 따뜻한 어쿠스틱 팝 트랙을 만들어 주세요."
)
npx skills add runapi-ai/producer -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 cursor
Producer는 음악 스타일과 프로덕션 브리프를 완성된 FUZZ 트랙으로 만듭니다. 입력한 가사를 그대로 부르는 보컬곡과 인스트루멘털을 모두 생성할 수 있습니다.
- 품질과 지연 시간 목표에 맞춘 모델 변형
- 통합 API key
- Model skill에 docs, schema, 설정 메모 포함
- 실패한 생성은 과금되지 않습니다
변형
앱 개발을 위해 Producer skill 설치
모델 docs, schema, 가격 메모, 설정 단계를 코딩 워크스페이스로 불러옵니다.
# Install the model skill for app development workflows
npx skills add runapi-ai/producer -g
Install the Producer skill for this app: 1. Add runapi-ai/producer 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을 처리합니다.
Producer의 위치
Producer는 하나의 RunAPI 키로 비동기 작업을 생성하며, 생성·콜백·폴링에서 일관된 응답 형식을 사용합니다.
RunAPI로 Producer을 쓰는 이유
하나의 API key
모델과 제공사를 넘나들며 같은 인증 정보를 사용합니다.
Skill-ready
model skill에 schema, 설정 메모, 가격 컨텍스트, 모델 ID가 포함됩니다.
예측 가능한 과금
호출 전에 사용량 기반 가격을 확인할 수 있습니다.
자주 묻는 질문
Producer에서는 어떤 음악 생성 모드를 사용할 수 있나요?
입력한 가사를 그대로 부르는 보컬 트랙을 생성하거나, 음악 스타일과 프로덕션 브리프로 인스트루멘털을 만들 수 있습니다.
Producer 요청은 비동기식인가요?
네. 생성 요청은 상태를 폴링할 수 있는 task ID를 반환하며, 완료 결과를 받을 콜백 URL을 제공할 수도 있습니다.
완료된 Producer 작업은 무엇을 반환하나요?
완료된 작업은 임시 오디오 및 커버 URL이 담긴 오디오 목록과 제목, 재생 시간, 가사, 모델 이름 등의 트랙 메타데이터를 반환합니다.
이 모델은 어떻게 호출하나요?
model skill을 설치하고 RunAPI key와 함께 설정 메모를 따르세요.
실패한 생성도 비용이 드나요?
실패한 생성은 과금되지 않습니다
애플리케이션에서 호출할 수 있나요?
네. 코딩 워크스페이스에 model skill을 설치하고 모델 기능을 추가할 때 사용하세요.