google/lyriaは、/v1/music/generationsで文章のプロンプトから音楽を作ります。製品デモの落ち着いたインストゥルメンタルを、中心となる楽器とナレーションのために必要な余白を説明して依頼する用途などに使えます。音楽クリップが欲しい場合に選んでください。
modelとpromptが必須です。nまたはcountは1〜8クリップを指定でき、生成結果は同期的に返ります。すべてのクリップと実際のメタデータを保存してください。音声参照、長さ、テンポの項目はなく、個別に選択する制御ではありません。音楽的な意図はプロンプトで伝え、出力の計測値まで保証されるとは考えないでください。
", "aboutText": "google/lyriaは、/v1/music/generationsで文章のプロンプトから音楽を作ります。製品デモの落ち着いたインストゥルメンタルを、中心となる楽器とナレーションのために必要な余白を説明して依頼する用途などに使えます。音楽クリップが欲しい場合に選んでください。 modelとpromptが必須です。nまたはcountは1〜8クリップを指定でき、生成結果は同期的に返ります。すべてのクリップと実際のメタデータを保存してください。音声参照、長さ、テンポの項目はなく、個別に選択する制御ではありません。音楽的な意図はプロンプトで伝え、出力の計測値まで保証されるとは考えないでください。", "editorialOverlay": { "copy_fields": { "about_html": "google/lyriaは、/v1/music/generationsで文章のプロンプトから音楽を作ります。製品デモの落ち着いたインストゥルメンタルを、中心となる楽器とナレーションのために必要な余白を説明して依頼する用途などに使えます。音楽クリップが欲しい場合に選んでください。
modelとpromptが必須です。nまたはcountは1〜8クリップを指定でき、生成結果は同期的に返ります。すべてのクリップと実際のメタデータを保存してください。音声参照、長さ、テンポの項目はなく、個別に選択する制御ではありません。音楽的な意図はプロンプトで伝え、出力の計測値まで保証されるとは考えないでください。
", "short_text": "文章から音楽を生成。1〜8クリップを指定でき、生成結果は同期的に返されます。" }, "copy_sha256": "b4160cab2cf431bfdd3a122a16ff10b4cb53cf8e9f80a7f8a43893cd1e2e03b4", "copy_source": { "locale": "ja", "pack_sha256": "0f56d90ba41881e1134accf82e57338f246f8753ca4c0cee929aaffada5d10e7", "record_model_id": "google/lyria", "source_facts_sha256": "bcfae81e3d4908462260b5ec8e638f6ed6cfe7d320d77ce43894e29ac238488e", "validation_sha256": "a2ac2f28056280fc0b2ea34a501bf156d5ce155406e57e708edf30bfdf6bfdc6" }, "html_sha256": "764fcc5ff7b2133b2298678f89ba9c2002715f5e37afb0939bd0e5f8e863a6c2", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ja", "methods": [ { "html": "google/lyria文章から音楽を生成。1〜8クリップを指定でき、生成結果は同期的に返されます。
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
google/lyriaは、/v1/music/generationsで文章のプロンプトから音楽を作ります。製品デモの落ち着いたインストゥルメンタルを、中心となる楽器とナレーションのために必要な余白を説明して依頼する用途などに使えます。音楽クリップが欲しい場合に選んでください。
modelとpromptが必須です。nまたはcountは1〜8クリップを指定でき、生成結果は同期的に返ります。すべてのクリップと実際のメタデータを保存してください。音声参照、長さ、テンポの項目はなく、個別に選択する制御ではありません。音楽的な意図はプロンプトで伝え、出力の計測値まで保証されるとは考えないでください。
POST /v1/music/generationstextmusic| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 google/lyria | デフォルト— |
フィールドprompt | 種類string | 要件必須 | 値と制限 最小の長さ: 1 | デフォルト— |
フィールドn | 種類integer | 要件任意 | 値と制限 最小値: 1 最大値: 8 | デフォルト1 |
フィールドcount | 種類integer | 要件任意 | 値と制限 最小値: 1 最大値: 8 条件: nも指定する場合は、個数を一致させる必要があります | デフォルト— |
text_to_music · 必須: prompt
| パラメータ | 仕様 |
|---|---|
パラメータmaterial_types | 仕様text |
パラメータrequired | 仕様null |
パラメータoptional_controls | 仕様null |
ライフサイクル: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · 実際に返された task_id またはメディアライブラリのレコード
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
メソッドの形式とIDは正確に記載しています。供給元の対応能力とリクエストの受け入れは別です。
POST /v1/music/generations配信されたクリップ数 × クリップの基本料金。リクエスト単位の参考料金は加算されません。例は適用調整前の金額です。
1 × $0.08 = $0.08
4 × $0.08 = $0.32
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 music brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "google/lyria", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\nexport AILOOT_API_KEY\npython3 - <<'PY_RESULT'\nimport json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin, urlparse\nresult=json.loads(Path("result.json").read_text(encoding="utf-8"))\nprint(json.dumps(result,ensure_ascii=False,indent=2))\nfor number,clip in enumerate(result.get("data") or []):\n u=urlparse(urljoin("https://api.ailoot.ai",clip["url"]))\n if u.scheme!="https" or not u.hostname or u.username or u.password:\n raise SystemExit("Result URL must be HTTPS without embedded credentials")\n owned=u.netloc=="api.ailoot.ai" and u.path.startswith("/v1/media/assets/") and u.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",u.geturl()]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n raw=subprocess.check_output(args)\n ext="wav" if raw.startswith(b"RIFF") and raw[8:12]==b"WAVE" else "flac" if raw.startswith(b"fLaC") else "ogg" if raw.startswith(b"OggS") else "mp3" if raw.startswith(b"ID3") or raw[:1]==b"\\xff" else "bin"\n f=Path("music-"+str(number)+"."+ext);f.write_bytes(raw)\n print("Saved",f,clip.get("asset_id"))\n\nPY_RESULT\n完全な所有音声クリップ／JSONリンク
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}返された完全なレスポンス、ファイル、コンテンツ部分をすべて保存してください。
返されたクリップをすべて保存／取得し、実際のID、MIME、メタデータを保持してください。このメソッドは同期式です。別途Ailootの音楽生成用ポーリングURLを導入するものではありません。
音楽の結果に確認が必要な場合は、元のoperation_id/X-Client-Request-IDと、返されたクリップ情報を保持してください。実際のtask_idまたはasset_idを使い、メディアライブラリから既存の所有クリップを復元してください。音楽リクエストを再送信したり、operation_idから生成用ポーリングURLを組み立てたりしないでください。
| フィールド | 種類 |
|---|---|
フィールドmodel | 種類string |
フィールドresponse_id | 種類string |
フィールドdata[] | 種類owned clip record |
| レスポンス | 条件 | 次の手順 |
|---|---|---|
レスポンス400 · invalid_request_error | 条件必須フィールド、素材の表現形式、またはパラメーター値が不正です | 次の手順新しい生成リクエストを送る前に、指定されたフィールドを修正してください。 |
レスポンスserver_error | 条件返されたレスポンスは、操作または結果の確認が必要であることを示しています | 次の手順最初に返された操作／タスク ID、リクエストヘッダー、レスポンスを保存し、その元の操作に対してサポートされている読み取りを継続してください。作成リクエストを再送しないでください。 |
Ailoot google/lyria
上記に表示されたメソッドパスを使用してください。