Producer API
FUZZによるAI音楽生成に対応するProducer APIを利用できます。指定した歌詞のボーカル曲と、制作ブリーフに基づくインストゥルメンタルを生成できます。
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は非同期タスク方式で動作し、1つのRunAPIキーで作成、コールバック、ポーリングのレスポンスを一貫した形式で扱えます。
RunAPI 経由で Producer を使う理由
1つの API key
モデルやプロバイダーをまたいで同じ認証情報を使えます。
Skill-ready
model skill に schema、セットアップメモ、料金コンテキスト、モデル ID が含まれます。
予測しやすい請求
呼び出し前に従量料金を確認できます。
よくある質問
Producerではどの音楽生成モードを利用できますか?
指定した歌詞からボーカル曲を生成するか、音楽スタイルと制作ブリーフからインストゥルメンタルを生成できます。
Producerのリクエストは非同期ですか?
はい。作成時にステータスをポーリングするためのタスクIDが返されます。完了通知を受け取るコールバックURLも指定できます。
完了したProducerタスクでは何が返されますか?
完了したタスクでは、音声とカバー画像の一時URLを含む音声リストに加え、タイトル、再生時間、歌詞、モデル名などのトラック情報が返されます。
このモデルはどう呼び出しますか?
model skill をインストールし、RunAPI key とセットアップメモに従ってください。
失敗した生成は課金されますか?
失敗した生成は課金されません
アプリケーションから呼び出せますか?
はい。コード作業環境に model skill をインストールし、モデル機能を追加するときに利用してください。