Lyria 3 Clip Preview

Lyria 3 Clip Preview — музыкальная модель Google для коротких клипов, зацикленных фрагментов и превью. Принимает текст или изображение для вдохновения и создаёт 30-секундные музыкальные фрагменты со стереозвуком 48 кГц, поддерживая вокал, тексты песен с временной разметкой и инструментальные аранжировки.

Ailoot · Музыка POST /v1/music/generations google/lyria-3-clip-preview

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

Lyria 3 Clip Preview — профиль генерации музыки Google для коротких клипов, зацикленных фрагментов и превью. Принимает текстовый промпт или изображение для вдохновения и возвращает текст и аудио. Опубликованный профиль описывает 30-секундные клипы со стереозвуком 48 кГц, включая вокал, тексты песен с временной разметкой и полные инструментальные аранжировки.

Опишите музыкальный момент

Назовите назначение клипа и настроение, которое он должен передавать. Короткая вступительная тема может задавать сдержанное начало и чёткий переход к основной части; фоновый фрагмент — темп и фактуру, необходимые под визуальную сцену. Укажите, должен ли результат включать вокал или быть инструментальным, и назовите музыкальные элементы, важные для задания.

Структура должна быть достаточно компактной для клипа. Определите начало, основную фразу и завершение или точку зацикливания. Если важны слова, передайте замысел текста песни или конкретную формулировку и проверьте, что действительно спето. Музыкальное задание должно отделять содержание вокала от указаний по аранжировке.

Визуальное вдохновение и аранжировка

Передавая изображение, объясните, какую сцену или настроение оно вносит в музыкальный запрос. Спокойный пейзаж и многолюдная ночная сцена предполагают разные направления, но желаемая эмоциональная роль всё равно должна быть явно указана в тексте. Сохраняйте изображение вместе с промптом при сравнении возвращённого клипа с задуманной концепцией.

Проверьте баланс вокала, инструментов и основной музыкальной фразы. Для зацикленного фрагмента прослушайте конец и начало вместе; для превью проверьте, передаёт ли короткая длительность задуманное направление. Клип, сопровождающий монтаж, следует проверять вместе с этим монтажом, а не только отдельно.

Сохраните звуковой материал для прослушивания

Сохраняйте реальное аудио и сопутствующий текст вместе с заданием. При подготовке воспроизведения или импорте в редактор проверьте свойства файла и сохраняйте сведения о тексте песни или времени, возвращённые запросом. Музыка — выход модели; монтажные склейки, титры, визуальные переходы и итоговый производственный микс можно построить вокруг этого проверенного материала.

Этот конкретный профиль Clip Preview подходит для компактного музыкального результата. При планировании более длинной композиции сохраняйте его отдельную роль короткого формата и выбирайте возвращённый клип, прослушав полную фразу, текст вокала и завершение.

Ailoot · Музыка POST /v1/music/generations google/lyria-3-clip-preview

google/lyria-3-clip-preview

Google /google/lyria-3-clip-preview

Начало

Допустимые входные данные: Текст
Результаты: music

Доступно в Ailoot · входные данные и методы

Ailoot · Музыка POST /v1/music/generations

Входные данные: text
Результат: music
Выходной формат: готовые аудиоклипы, принадлежащие Ailoot, или ссылки в JSON

Поле	Тип	Требование	Значения и ограничения	По умолчанию
Поле`model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения google/lyria-3-clip-preview	По умолчанию—
Поле`prompt`	Тип`string`	ТребованиеОбязательно	Значения и ограничения Минимальная длина: 1	По умолчанию—

Сочетания входных материалов

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 указаны точно; возможности поставщика рассматриваются отдельно от допуска.

Тарифы

Ставки методов Ailoot

Ailoot МузыкаPOST /v1/music/generations

Выход: 0,04 $ за клип
Только справка · не прибавляется: 0,04 $ за запрос

Полученные клипы × базовый тариф за клип. Справочный тариф за запрос не прибавляется. Примеры приведены до применимых корректировок.

1 × 0,04 $ = 0,04 $

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

Сведения о справочном тарифе

Справочные шкалы модели не меняют выбор метода, расчёт стоимости или списания. Действующая плата определяется ставками выбранного метода Ailoot.

Справочные шкалы модели

Цены по конфигурациям

Конфигурация	Уровень сервиса	Условие контекста	Плата
КонфигурацияUltra	Уровень сервисаstandard	Условие контекста{}	Плата Выход · музыка 0,08 $ за песню

Примеры запросов

Ailoot · Музыка

Пример музыки

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 music brief}"
export AILOOT_PROMPT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/lyria-3-clip-preview", "prompt": ""}')
f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")
p['prompt']=f.read_text(encoding="utf-8")
if not p['prompt'].strip():raise SystemExit("Brief must contain text")
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
export AILOOT_API_KEY
python3 - <<'PY_RESULT'
import json, os, subprocess
from pathlib import Path
from urllib.parse import urljoin, urlparse
result=json.loads(Path("result.json").read_text(encoding="utf-8"))
print(json.dumps(result,ensure_ascii=False,indent=2))
for number,clip in enumerate(result.get("data") or []):
    u=urlparse(urljoin("https://api.ailoot.ai",clip["url"]))
    if u.scheme!="https" or not u.hostname or u.username or u.password:
        raise SystemExit("Result URL must be HTTPS without embedded credentials")
    owned=u.netloc=="api.ailoot.ai" and u.path.startswith("/v1/media/assets/") and u.path.endswith("/content")
    args=["curl","--fail-with-body","--silent","--show-error",u.geturl()]
    if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
    raw=subprocess.check_output(args)
    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"
    f=Path("music-"+str(number)+"."+ext);f.write_bytes(raw)
    print("Saved",f,clip.get("asset_id"))

PY_RESULT

Получить и сохранить результаты

Ailoot · Музыка

готовые аудиоклипы, принадлежащие Ailoot, или ссылки в JSON

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /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-3-clip-preview

Псевдонимы путей метода

Используйте пути методов, указанные выше.

Связанные ID для вызова

google/lyria-3-clip-preview

FAQ · Lyria 3 Clip Preview

Какие входные данные и результаты доступны?: POST /v1/music/generations · google/lyria-3-clip-preview: text → music
Какие поля использует запрос?: POST /v1/music/generations · google/lyria-3-clip-preview: model, prompt

Lyria 3 Clip Preview