API ドキュメント

API キーを取得して安全に保存

認証はアプリケーションサーバーで行います。本番キーをブラウザコード、モバイルアプリ、ログ、公開リポジトリに含めないでください。

1. 1アカウントを作成し、ダッシュボードの API キー画面を開きます。
2. 2キーをコピーし、サーバーのシークレット管理または暗号化された環境に保存します。
3. 3Authorization ヘッダーで Bearer トークンとして送り、漏えいした場合はすぐに更新します。

クイックスタート

非同期の音楽タスクを作成し、返された workId を保存して、完了まで feed エンドポイントをポーリングします。サーバーキーを設定すれば以下のリクエストを実行できます。

export UDIOAPI_KEY='replace-with-your-server-key'

curl --request POST \
  --url 'https://udioapi.pro/api/v2/generate' \
  --header "Authorization: Bearer $UDIOAPI_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "chirp-v5-5",
    "gpt_description_prompt": "Warm indie pop with acoustic guitar",
    "make_instrumental": true
  }'

# Save workId from the response, then poll:
curl 'https://udioapi.pro/api/v2/feed?workId=YOUR_WORK_ID'

追跡対象のサンプルは UDIOAPI_KEY、回数制限付きポーリング、構造化エラーを使用し、外部依存はありません。GitHub に fork を公開する前にすべてのシークレットを削除してください。

API エンドポイント

デフォルトの Music Generate エンドポイントには /v2/generate を使用します。MiniMax は /v2/minimax/generate から利用できる統合プロバイダーであり、デフォルトの音楽生成モデルではありません。

エラー処理

HTTP ステータスと構造化レスポンスを統合契約の一部として扱います。workId と独自のリクエスト ID は記録できますが、API キーは記録しないでください。

モデレーション拒否やその他の終了済み失敗は再試行しないでください。fail_message または error_message を表示し、入力を変更できるようにします。

変更履歴の概要

互換性に関係する API 変更をここにまとめ、影響するエンドポイントへリンクします。