Google Lyria 3

Генерация музыки от Google - две модели: Lyria 3 Pro (полноценный трек) и Lyria 3 Clip (короткий клип). Принимают текстовое описание и опциональные изображения-референсы. Стоимость фиксированная за генерацию (flat pricing), не зависит от длины трека.

Обзор

Возможности

Параметры

Параметры, которые отклоняются для Lyria

Lyria - не Suno-модель, поэтому следующие параметры вернут ошибку 400:

• uploadUrlList
• customMode, instrumental
• style, title
• negativeTags, vocalGender
• styleWeight, weirdnessConstraint, audioWeight
• personaId, version
• soundLoop, soundTempo, soundKey
• grabLyrics

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

Простой запрос (синхронный)

curl -X POST "https://api.usellm.ru/v1/media" \
  -H "Authorization: Bearer <USELLM_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/lyria-3-pro-preview",
    "input": {
      "prompt": "Спокойная инструментальная музыка для медитации, мягкое пиано"
    },
    "async": false
  }'

const response = await fetch('https://api.usellm.ru/v1/media', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <USELLM_API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'google/lyria-3-pro-preview',
    input: {
      prompt: 'Спокойная инструментальная музыка для медитации, мягкое пиано'
    },
    async: false
  })
});

const result = await response.json();
console.log('ID генерации:', result.id);
console.log('Трек:', result.data[0].url);
console.log('Длительность:', result.data[0].duration);

import requests

response = requests.post(
    'https://api.usellm.ru/v1/media',
    headers={'Authorization': 'Bearer <USELLM_API_KEY>'},
    json={
        'model': 'google/lyria-3-pro-preview',
        'input': {
            'prompt': 'Спокойная инструментальная музыка для медитации, мягкое пиано'
        },
        'async': False
    }
)

result = response.json()
print('ID генерации:', result['id'])
print('Трек:', result['data'][0]['url'])
print('Длительность:', result['data'][0]['duration'])

С изображениями-референсами

curl -X POST "https://api.usellm.ru/v1/media" \
  -H "Authorization: Bearer <USELLM_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/lyria-3-clip-preview",
    "input": {
      "prompt": "Энергичный электронный трек в стиле synthwave, драйвовый бит",
      "images": [
        {"type": "url", "data": "https://example.com/reference-1.jpg"},
        {"type": "url", "data": "https://example.com/reference-2.jpg"}
      ]
    }
  }'

Схема ответа

Синхронный успех (async: false)

{
  "id": "gen_581761234567890123",
  "object": "media.generation",
  "status": "completed",
  "created": 1703001234,
  "completed_at": 1703001244,
  "model": "google/lyria-3-pro-preview",
  "data": [
    {
      "url": "https://storage.example.com/tracks/abc.mp3",
      "thumbnail_url": "https://storage.example.com/covers/abc.jpeg",
      "title": "Peaceful Meditation",
      "duration": 198.44
    }
  ],
  "usage": { "output_units": 1, "cost": 8, "cost_rub": 8 }
}

В процессе генерации

{
  "id": "gen_581761234567890123",
  "object": "media.generation",
  "status": "pending",
  "created": 1703001234,
  "model": "google/lyria-3-pro-preview"
}

Ошибка

{
  "id": "gen_581761234567890123",
  "object": "media.generation",
  "status": "failed",
  "created": 1703001234,
  "model": "google/lyria-3-pro-preview",
  "error": { "code": "<код>", "message": "<человекочитаемое описание>" }
}

Асинхронная генерация

Генерация музыки - асинхронный процесс. После отправки запроса с async: true вы получите id, который нужно использовать для проверки статуса:

1. Отправка запроса: POST на /v1/media с "async": true возвращает id генерации и status: "pending"
2. Проверка статуса - GET на /v1/media/{id} возвращает текущий статус: pending, processing, completed, failed, cancelled
3. Получение результата: когда статус completed, в ответе будут URL аудиофайла, обложка, название и длительность трека

Советы и лучшие практики