API v1

FM9 APIドキュメント

REST APIを使用して、アプリケーションに強力な音楽生成機能を構築しましょう。

クイックスタート

1回のAPIコールで最初のトラックを生成します。

Requestbash
curl -X POST https://api.fm9.ai/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "アップビートなエレクトロニックダンスミュージック"}'
Responsejson
{
  "id": "gen_abc123",
  "status": "processing",
  "estimated_time": 30
}

認証

すべてのAPIリクエストにはAPIキーが必要です。Authorizationヘッダーにキーを含めてください:

APIキーは以下から取得できます 開発者ダッシュボード.

Authorization: Bearer YOUR_API_KEY

エンドポイント

POST/v1/generate

音楽を生成

新しい音楽生成タスクを作成します。

Parameters

  • prompt-生成する音楽のテキスト説明(必須)
  • duration-トラックの長さ(秒)(30-180、デフォルト:60)
  • style-音楽スタイルプリセット(オプション)
  • instrumental-インストゥルメンタルのみを生成するかどうか(デフォルト:false)

タスクIDとステータスを含む生成オブジェクトを返します。

GET/v1/generation/:id

生成ステータスを取得

生成タスクのステータスを確認します。

現在のステータスを含む生成オブジェクトを返し、完了時にはダウンロードURLが含まれます。

GET/v1/generations

生成一覧

生成履歴のリストを取得します。

Parameters

  • limit-返す結果の数(デフォルト:20、最大:100)
  • offset-ページネーションオフセット(デフォルト:0)
  • status-ステータスでフィルタリング(pending、processing、completed、failed)

API料金

シンプルで透明な使用量ベースの料金体系。

スターター

無料

月10回の生成

  • 基本APIアクセス
  • 標準品質
  • コミュニティサポート

デベロッパー

$49/mo

月500回の生成

  • フルAPIアクセス
  • 高品質出力
  • 優先サポート
  • Webhookコールバック

エンタープライズ

カスタム

無制限

  • 専用インフラ
  • カスタムモデル
  • SLA保証
  • 24時間サポート

レート制限

公平な使用とサービスの安定性を確保するため、以下のレート制限が適用されます:

  • スターター:1分あたり10リクエスト
  • デベロッパー:1分あたり60リクエスト
  • エンタープライズ:カスタム制限

レート制限を超過すると、429 Too Many Requestsレスポンスが返されます。

エラーコード

APIは標準的なHTTPレスポンスコードを使用して成功または失敗を示します。

CodeDescription
400Bad Request - 無効なパラメータ
401Unauthorized - 無効または欠落したAPIキー
402Payment Required - クレジット不足
429Too Many Requests - レート制限超過
500Internal Server Error - サーバー側でエラーが発生

お困りですか?

開発者サポートチームがお手伝いします。

メール:[email protected]

完全なドキュメントはdocs.fm9.aiでご覧いただけます