API v1

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

Создавайте мощные функции генерации музыки в ваших приложениях с помощью нашего REST API.

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

Создайте свой первый трек одним вызовом API.

Requestbash

curl -X POST https://api.fm9.ai/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "энергичная электронная танцевальная музыка"}'

Responsejson

{
  "id": "gen_abc123",
  "status": "processing",
  "estimated_time": 30
}

Аутентификация

Все запросы API требуют ключ API. Включите ваш ключ в заголовок Authorization:

Получите ваш ключ API в панели разработчика.

Authorization: Bearer YOUR_API_KEY

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

POST/v1/generate

Генерация музыки

Создает новую задачу генерации музыки.

Parameters

prompt-Текстовое описание музыки для генерации (обязательно)
duration-Длительность трека в секундах (30-180, по умолчанию: 60)
style-Пресет музыкального стиля (опционально)
instrumental-Генерировать только инструментал (по умолчанию: false)

Возвращает объект генерации с ID задачи и статусом.

GET/v1/generation/:id

Получить статус генерации

Проверяет статус задачи генерации.

Возвращает объект генерации с текущим статусом и URL для скачивания по завершении.

GET/v1/generations

Список генераций

Получает список вашей истории генерации.

Parameters

limit-Количество результатов (по умолчанию: 20, макс: 100)
offset-Смещение пагинации (по умолчанию: 0)
status-Фильтр по статусу (pending, processing, completed, failed)

Цены API

Простые и прозрачные цены на основе использования.

Starter

Бесплатно

10 генераций/месяц

Базовый доступ к API
Стандартное качество
Поддержка сообщества

Developer

$49/mo

500 генераций/месяц

Полный доступ к API
Высококачественный вывод
Приоритетная поддержка
Webhook-колбэки

Enterprise

Индивидуально

Безлимитно

Выделенная инфраструктура
Кастомные модели
Гарантия SLA
Поддержка 24/7

Лимиты запросов

Для обеспечения справедливого использования и стабильности сервиса действуют следующие лимиты:

Starter: 10 запросов/минуту
Developer: 60 запросов/минуту
Enterprise: Индивидуальные лимиты

При превышении лимита вы получите ответ 429 Too Many Requests.

Коды ошибок

API использует стандартные коды HTTP-ответов для индикации успеха или неудачи.

Code	Description
400	Bad Request - Неверные параметры
401	Unauthorized - Неверный или отсутствующий ключ API
402	Payment Required - Недостаточно кредитов
429	Too Many Requests - Превышен лимит запросов
500	Internal Server Error - Что-то пошло не так на нашей стороне

Нужна помощь?

Наша команда поддержки разработчиков готова помочь.

Email: [email protected]

Полная документация доступна на docs.fm9.ai