Медиа

Написать текст песни

POST/v1/audio/lyrics

Требуемое право: audio. Тема или задание передаются в prompt или input. Асинхронный JSON-контракт Kvantora; не полная совместимость с OpenAI media API. Результаты возвращаются в файлах. Единица и quantity берутся из опубликованного тарифа каталога: request, image, character, page, file, document, second или minute. Оценка /v1/quotes относится ко всему заданию. Неизвестная стоимость блокирует запуск до резерва. Входные файлы принадлежат владельцу ключа и проходят проверку; параметры должны поддерживаться моделью.

Авторизация

Authorizationstringобязательный

Ключ API в заголовке Authorization: Bearer <ключ>. Ключ создаётся в кабинете, подробнее — в разделе Аутентификация.

Заголовки

Idempotency-Keystringобязательныйдлина 1–200

Один стабильный ключ на логический запрос. Повторяйте с тем же телом и тем же credential/endpoint. Новый ключ создаёт новый запрос.

Тело запроса

application/json · обязательное

modelstringобязательныйдлина 1–200

Публичный ID модели из каталога.

max_cost_microrubinteger0 … 9007199254740991

Максимальная разрешённая оценка резерва в микрорублях.

promptstringдлина 0–32000

Текст запроса; не передавайте одновременно с input.

inputstringдлина 0–32000

Текст запроса; не передавайте одновременно с prompt.

file_idstringuuid

ID собственного файла, завершившего загрузку и проверку.

file_idsstring[]элементов 1–16

ID собственных файлов без повторов. Допустимое количество зависит от модели.

ninteger1 … 16

Количество изображений при генерации или редактировании, если модель это поддерживает. Проверяется по ограничениям модели.

settingsobject

Только поддерживаемые моделью настройки из каталога; неизвестные настройки отклоняются до резерва.

Ответы

200Повтор уже завершённого задания

application/json

idstringобязательныйuuid
object"generation.job"обязательный
modelstringобязательный
operationstringобязательный
Значения: "image_generation" "image_editing" "video_generation" "three_d" "music" "audio_generation" "text_to_speech" "speech_to_text" "audio_processing" "audio_analysis" "voice_clone" "lyrics" "ocr" "translation" "text_analysis" "image_analysis" "video_analysis" "moderation" "search"
statusstringобязательный
Значения: "queued" "running" "storing" "succeeded" "cancelled" "failed" "unknown"
mockbooleanобязательный
created_atstringобязательныйdate-time
updated_atstringобязательныйdate-time
outputobject | nullобязательный
Вложенные поля
Один из вариантов
Вариант 1
file_idstringобязательныйuuid
filesobject[]обязательный

Файлы результата, включая текстовые файлы или PDF, если это поддерживается операцией.

Вложенные поля
idstringобязательныйuuid
namestringобязательный
mimeTypestringобязательный
sizeBytesintegerобязательный0 … ∞
errorobject | nullобязательный
Вложенные поля
Один из вариантов
Вариант 1
codestringобязательный
billingobjectобязательный
Вложенные поля
statusstring
estimated_cost_microrubinteger0 … 9007199254740991
cost_microrubinteger | null
recoveryobject | null

Есть, пока платформа восстанавливает результат, который уже вернула модель, но который ещё не дошёл до вас. Платная генерация повторно не отправляется. Если к deadline_at результат не получен, деньги возвращаются автоматически, а задание получает status failed и error.code result_not_delivered.

Вложенные поля
Один из вариантов
status: "recovering"
status"recovering"обязательный
messagestringобязательный
attemptsintegerобязательный1 … ∞
next_attempt_atstringобязательныйdate-time
deadline_atstringобязательныйdate-time
202Задание принято

application/json

idstringобязательныйuuid
object"generation.job"обязательный
modelstringобязательный
operationstringобязательный
Значения: "image_generation" "image_editing" "video_generation" "three_d" "music" "audio_generation" "text_to_speech" "speech_to_text" "audio_processing" "audio_analysis" "voice_clone" "lyrics" "ocr" "translation" "text_analysis" "image_analysis" "video_analysis" "moderation" "search"
statusstringобязательный
Значения: "queued" "running" "storing" "succeeded" "cancelled" "failed" "unknown"
mockbooleanобязательный
created_atstringобязательныйdate-time
updated_atstringобязательныйdate-time
outputobject | nullобязательный
Вложенные поля
Один из вариантов
Вариант 1
file_idstringобязательныйuuid
filesobject[]обязательный

Файлы результата, включая текстовые файлы или PDF, если это поддерживается операцией.

Вложенные поля
idstringобязательныйuuid
namestringобязательный
mimeTypestringобязательный
sizeBytesintegerобязательный0 … ∞
errorobject | nullобязательный
Вложенные поля
Один из вариантов
Вариант 1
codestringобязательный
billingobjectобязательный
Вложенные поля
statusstring
estimated_cost_microrubinteger0 … 9007199254740991
cost_microrubinteger | null
recoveryobject | null

Есть, пока платформа восстанавливает результат, который уже вернула модель, но который ещё не дошёл до вас. Платная генерация повторно не отправляется. Если к deadline_at результат не получен, деньги возвращаются автоматически, а задание получает status failed и error.code result_not_delivered.

Вложенные поля
Один из вариантов
status: "recovering"
status"recovering"обязательный
messagestringобязательный
attemptsintegerобязательный1 … ∞
next_attempt_atstringобязательныйdate-time
deadline_atstringобязательныйdate-time
ОшибкаОшибка проверки, прав, лимита или доступности. Код error.code; результат запроса при неизвестном исходе не следует считать отменённым.

application/json

errorobjectобязательный
Вложенные поля
codestringобязательный
messagestringобязательный
request_idstring
typestring
Esc
↑↓ выбратьEnter открытьEsc закрыть