REST APIを使用して、アプリケーションに強力な音楽生成機能を構築しましょう。
1回のAPIコールで最初のトラックを生成します。
curl -X POST https://api.fm9.ai/v1/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "アップビートなエレクトロニックダンスミュージック"}'{
"id": "gen_abc123",
"status": "processing",
"estimated_time": 30
}すべてのAPIリクエストにはAPIキーが必要です。Authorizationヘッダーにキーを含めてください:
APIキーは以下から取得できます 開発者ダッシュボード.
Authorization: Bearer YOUR_API_KEY/v1/generate新しい音楽生成タスクを作成します。
prompt-生成する音楽のテキスト説明(必須)duration-トラックの長さ(秒)(30-180、デフォルト:60)style-音楽スタイルプリセット(オプション)instrumental-インストゥルメンタルのみを生成するかどうか(デフォルト:false)タスクIDとステータスを含む生成オブジェクトを返します。
/v1/generation/:id生成タスクのステータスを確認します。
現在のステータスを含む生成オブジェクトを返し、完了時にはダウンロードURLが含まれます。
/v1/generations生成履歴のリストを取得します。
limit-返す結果の数(デフォルト:20、最大:100)offset-ページネーションオフセット(デフォルト:0)status-ステータスでフィルタリング(pending、processing、completed、failed)シンプルで透明な使用量ベースの料金体系。
月10回の生成
月500回の生成
無制限
公平な使用とサービスの安定性を確保するため、以下のレート制限が適用されます:
レート制限を超過すると、429 Too Many Requestsレスポンスが返されます。
APIは標準的なHTTPレスポンスコードを使用して成功または失敗を示します。
| Code | Description |
|---|---|
| 400 | Bad Request - 無効なパラメータ |
| 401 | Unauthorized - 無効または欠落したAPIキー |
| 402 | Payment Required - クレジット不足 |
| 429 | Too Many Requests - レート制限超過 |
| 500 | Internal Server Error - サーバー側でエラーが発生 |