Документация API

Получение и хранение API-ключа

Аутентификация должна выполняться на сервере приложения. Не помещайте рабочий ключ в код браузера, мобильное приложение, логи или публичный репозиторий.

1. 1Создайте аккаунт и откройте раздел API-ключей в панели управления.
2. 2Скопируйте ключ и сохраните его в менеджере секретов или защищённом окружении сервера.
3. 3Передавайте ключ в заголовке Authorization как Bearer-токен и немедленно замените его при утечке.

Быстрый старт

Создайте асинхронную музыкальную задачу, сохраните полученный workId и проверяйте endpoint 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, ограниченный polling, структурированные ошибки и не требуют сторонних зависимостей. Перед публикацией форка на GitHub удалите все секреты.

Конечные точки API

Используйте /v2/generate как основной endpoint Music Generate. MiniMax — подключенный провайдер через /v2/minimax/generate, а не модель генерации музыки по умолчанию.

Обработка ошибок

Считайте HTTP-статус и структурированный ответ частью контракта интеграции. Записывайте workId и свой ID запроса, но никогда не API-ключ.

Не повторяйте ошибки модерации и другие финальные ошибки задачи. Покажите пользователю fail_message или error_message, чтобы он мог изменить ввод.

Краткий журнал изменений

Значимые для совместимости изменения API собраны здесь и связаны с соответствующим endpoint.