google/lyria создаёт музыку по письменному описанию через /v1/music/generations. Пример задачи — сдержанная инструментальная подложка для демонстрации продукта: опишите ведущие инструменты и пространство, которое нужно оставить для дикторского текста. Выбирайте маршрут, когда нужен сгенерированный музыкальный клип.
Обязательны model и prompt. Параметр n или count принимает от одного до восьми клипов; метод возвращает результат генерации синхронно. Сохраните каждый полученный клип и его фактические метаданные. Ввод аудиореференса, настройка длительности и поле темпа не предоставляются как отдельные параметры. Описывайте музыкальный замысел в prompt, не считая его гарантированным измеренным свойством результата.
", "aboutText": "google/lyria создаёт музыку по письменному описанию через /v1/music/generations. Пример задачи — сдержанная инструментальная подложка для демонстрации продукта: опишите ведущие инструменты и пространство, которое нужно оставить для дикторского текста. Выбирайте маршрут, когда нужен сгенерированный музыкальный клип. Обязательны model и prompt. Параметр n или count принимает от одного до восьми клипов; метод возвращает результат генерации синхронно. Сохраните каждый полученный клип и его фактические метаданные. Ввод аудиореференса, настройка длительности и поле темпа не предоставляются как отдельные параметры. Описывайте музыкальный замысел в prompt, не считая его гарантированным измеренным свойством результата.", "editorialOverlay": { "copy_fields": { "about_html": "google/lyria создаёт музыку по письменному описанию через /v1/music/generations. Пример задачи — сдержанная инструментальная подложка для демонстрации продукта: опишите ведущие инструменты и пространство, которое нужно оставить для дикторского текста. Выбирайте маршрут, когда нужен сгенерированный музыкальный клип.
Обязательны model и prompt. Параметр n или count принимает от одного до восьми клипов; метод возвращает результат генерации синхронно. Сохраните каждый полученный клип и его фактические метаданные. Ввод аудиореференса, настройка длительности и поле темпа не предоставляются как отдельные параметры. Описывайте музыкальный замысел в prompt, не считая его гарантированным измеренным свойством результата.
", "short_text": "Генерация музыки по тексту: от одного до восьми клипов с синхронной выдачей результата." }, "copy_sha256": "b2084cfd0bbb0992709207ad71289d56567b15e224eb47db919cef2e4753508c", "copy_source": { "locale": "ru", "pack_sha256": "0f56d90ba41881e1134accf82e57338f246f8753ca4c0cee929aaffada5d10e7", "record_model_id": "google/lyria", "source_facts_sha256": "2bcc97330b2026ad58cf5b3fab1b2ae0b82033fe7121a883ad2941c054f21dcb", "validation_sha256": "a2ac2f28056280fc0b2ea34a501bf156d5ce155406e57e708edf30bfdf6bfdc6" }, "html_sha256": "6d9605ffa970a441e6113cec6e45a2b6c486cf780108e65c2ea68f36b10553db", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ru", "methods": [ { "html": "google/lyriaГенерация музыки по тексту: от одного до восьми клипов с синхронной выдачей результата.
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
google/lyria создаёт музыку по письменному описанию через /v1/music/generations. Пример задачи — сдержанная инструментальная подложка для демонстрации продукта: опишите ведущие инструменты и пространство, которое нужно оставить для дикторского текста. Выбирайте маршрут, когда нужен сгенерированный музыкальный клип.
Обязательны model и prompt. Параметр n или count принимает от одного до восьми клипов; метод возвращает результат генерации синхронно. Сохраните каждый полученный клип и его фактические метаданные. Ввод аудиореференса, настройка длительности и поле темпа не предоставляются как отдельные параметры. Описывайте музыкальный замысел в prompt, не считая его гарантированным измеренным свойством результата.
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готовые аудиоклипы, принадлежащие Ailoot, или ссылки в JSON
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Сохраняйте каждый полностью полученный ответ, файл и элемент содержимого.
Сохраните или скачайте каждый возвращённый клип, сохраняя фактические ID, MIME и метаданные. Метод синхронный; отдельный URL проверки статуса генерации музыки Ailoot не вводится.
Если результат генерации музыки требует проверки, сохраните исходные operation_id/X-Client-Request-ID и сведения о возвращённых клипах. Восстанавливайте существующие клипы, принадлежащие Ailoot, через медиатеку по фактическим значениям task_id или asset_id. Не отправляйте запрос на музыку повторно и не формируйте URL проверки статуса генерации из operation_id.
| Поле | Тип |
|---|---|
Полеmodel | Типstring |
Полеresponse_id | Типstring |
Полеdata[] | Типowned clip record |
| Ответ | Условие | Следующий шаг |
|---|---|---|
Ответ400 · invalid_request_error | УсловиеНеверные обязательные поля, представление материалов или значение параметра | Следующий шагИсправьте указанные поля перед новым запросом на создание. |
Ответserver_error | УсловиеВозвращённый ответ указывает, что операция или результат требуют проверки | Следующий шагСохраните исходный возвращённый ID операции или задачи, заголовки запроса и ответ; продолжайте поддерживаемые операции чтения исходной операции. Не отправляйте запрос создания повторно. |
Ailoot google/lyria
Используйте пути методов, указанные выше.