Изображения, текст и аудио

REST-контракты шести модулей Make; доступ и стоимость зависят от аккаунта и выбранной операции.

Подключение и выполнение запроса

Все пути ниже полные, начиная с /franklab/api. Используйте ключ своего аккаунта в X-API-Key; храните его только в переменной окружения сервера. Пример одного запроса:

export FRANKLAB_BASE_URL='https://apergrex.ru/franklab/api'
# FRANKLAB_KEY уже задан через защищённое окружение
cat > request.json <<'JSON'
{"model_key":"moon_gpt","prompt":"Return the word OK.","max_output_tokens":16,"async_mode":true}
JSON
curl --fail-with-body --max-time 300 -X POST \
  -H "X-API-Key: ${FRANKLAB_KEY:?Set your account key}" \
  -H 'Content-Type: application/json' \
  --data-binary @request.json \
  "$FRANKLAB_BASE_URL/make/dola/generate"

Пример вызывает генерацию и может резервировать средства. Для другого действия замените суффикс пути, метод и JSON по таблице. REPLACE_WITH_… и example.com — шаблоны, которые надо заменить собственными ID/медиа; примеры не следует запускать подряд. GET принимает указанные query-параметры, path ID подставляется в URL, тело не отправляется.

Обязательность и варианты относятся к выбранной операции; условия указаны отдельно. «Make default» — значение формы, которое REST-клиент должен передать явно, если хочет повторить поведение Make. Это не обещание серверного default.

Биллинг, ошибки и повторные запросы

Сначала проверьте баланс и тариф. Alibaba предоставляет /make/alibaba/estimate; общий /v1/billing/pricing/estimate принимает modelId из актуального /v1/billing/pricing/catalog и только поддерживаемые параметры. Идентификатор ценового каталога не равен автоматически model_key/model_name. У остальных действий может не быть отдельного публичного estimate; неизвестная цена не равна нулю. Сверяйте резерв, итоговую стоимость и возврат по задаче и транзакциям. Франк (₣) — внутренняя расчётная единица.

Ошибки: 400 — неверные поля/модель/ссылки, 401 — ключ, 403 — доступ, 404 — отсутствующий или недоступный вашему аккаунту ресурс, 429 — ограничение частоты. Недоступность модели, недостаточный баланс и ошибки выполнения также могут быть внутри code, message/msg, data.error/error_message при HTTP 200. Проверяйте HTTP и тело. При неизвестном исходе POST сохраните идентификаторы и обратитесь к истории/поддержке; не повторяйте платную отправку автоматически. Состояния, ошибки и поля результатов зависят от модуля.

FrankLab Alibaba Image

Если оценка недоступна для вашего аккаунта, уточните доступ к модели в поддержке перед отправкой генерации.

Создание изображения Z-Image, генерация и редактирование Qwen Image 3.0 и Qwen Image 3.0 Pro. REST-операции синхронные: сначала разбирайте ответ. Оценка и генерация требуют доступа аккаунта к выбранной операции.

Для редактирования Qwen укажите operation:"image_edit" и editImageUrls: 1–3 прямые публичные HTTPS-ссылки на изображения PNG/JPEG/WebP, до 10 MiB каждое. Сервер импортирует изображения для вашего аккаунта. Альтернатива: загрузите каждое изображение через multipart-поле file в POST /franklab/api/franklab/jobs/upload, затем соберите значения data.storedFileId из ответов в editImageIds. Передавайте ровно одно поле: editImageUrls или editImageIds; ID должны принадлежать вашему аккаунту. Qwen требует width/height: каждая сторона до 2048, площадь от 512² до 2048² пикселей; n от 1 до 6 (по умолчанию 1). prompt_extend_mode=agent работает только для text-to-image. Результат Qwen — PNG. Размер Z-Image записывается через *, например 1024*1024.

В успешном ответе проверяйте data.imageUrl (первое изображение), data.taskId, размеры и estimated_cost_franks/final_cost_franks/cost_status. Кроме HTTP проверяйте code и error_message. Оценка не создаёт изображение. Для оценки Qwen поле называется qwenOperation, для генерации — operation. /make/alibaba/status/:taskId опрашивает видео и не подходит для результата изображения.

z-image-turbo:text_to_image

POST /franklab/api/make/alibaba/images

JSON-шаблон:

{
  "model": "z-image-turbo",
  "prompt": "A short calm synthetic test.",
  "size": "1024*1024"
}

qwen-image-3.0-pro:text_to_image

POST /franklab/api/make/alibaba/images

JSON-шаблон:

{
  "model": "qwen-image-3.0-pro",
  "operation": "text_to_image",
  "prompt": "A short calm synthetic test.",
  "width": 1024,
  "height": 1024
}

qwen-image-3.0-pro:image_edit

POST /franklab/api/make/alibaba/images

JSON-шаблон:

{
  "model": "qwen-image-3.0-pro",
  "operation": "image_edit",
  "prompt": "Replace the background with a pale blue studio backdrop.",
  "width": 1024,
  "height": 1024,
  "editImageUrls": [
    "https://media.example.com/product-front.png"
  ]
}

qwen-image-3.0:text_to_image

POST /franklab/api/make/alibaba/images

JSON-шаблон:

{
  "model": "qwen-image-3.0",
  "operation": "text_to_image",
  "prompt": "A short calm synthetic test.",
  "width": 1024,
  "height": 1024
}

qwen-image-3.0:image_edit

POST /franklab/api/make/alibaba/images

JSON-шаблон:

{
  "model": "qwen-image-3.0",
  "operation": "image_edit",
  "prompt": "Replace the background with a pale blue studio backdrop.",
  "width": 1024,
  "height": 1024,
  "editImageUrls": [
    "https://media.example.com/product-front.png"
  ]
}

estimate

Для оценки редактирования передайте выбранную модель, qwenOperation:"image_edit", imageCount, width, height и n. Оценка не скачивает изображения по URL.

Для оценки изображения передайте model=z-image-turbo|qwen-image-3.0-pro|qwen-image-3.0. Для HappyHorse-видео не передавайте model; для WAN используйте wan3.0-video. happyhorse-1.1 — значение переключателя Make, а не допустимое значение REST DTO.

POST /franklab/api/make/alibaba/estimate

JSON-шаблон:

{
  "media": "image",
  "model": "z-image-turbo"
}

JUPITER

Сначала выберите маршрут и модель. Поле Make mode выбирает маршрут и не передаётся в REST JSON. MIST использует model_name=mist, Kling — jupiter-v1-5; Gemini/Seedream — model_id; подписочные маршруты — execution_mode. Доступность каждого маршрута проверяется отдельно. Каталог моделей не гарантирует возможность генерации.

Формы референсов различаются: MIST/Kling/Gemini — image_list:[{"image_url":"https://…"}]; Seedream — image:["https://…"]; подписочные маршруты — reference_images:["https://…"]; прежний Nano Banana Pro — image_input:["https://…"]; редактирование Grok — image:{"url":"https://…"}. Подходят прямые публичные HTTPS-ссылки; предварительная загрузка необязательна. Для Kling (model_name:"jupiter-v1-5") укажите каждое изображение из image_list в prompt: <<<image_1>>>, <<<image_2>>> и далее по порядку массива. MIST не требует этих маркеров.

Сохраняйте маршрут отправки вместе с data.task_id/data.taskId. Обычно статус получается добавлением /:taskId; прежний Nano Banana Pro использует /v1/google/:taskId/record-info. Не отправляйте Gemini/Seedream ID в omni-image poller. Опрос — примерно раз в 5 секунд, с ограничением времени. Проверяйте data.status, task_status или state; успешные значения включают completed, succeed, success, succeeded, done. При failed/refunded/cancelled опрос прекращается. Истечение времени ожидания не разрешает повторную генерацию.

Изображения могут находиться в data.images, data.task_result.images, data.result.task_result.images, data.output.images, data.output.imageUrls; старые ответы содержат JSON-строку data.resultJson с resultUrls. Gemini также возвращает output_text, grounding, citations, search_suggestions, interaction_id. Поле Make image_url — производная проекция, а не универсальная форма REST. final_cost_franks при cost_status=reserved ещё означает резерв.

mist

POST /franklab/api/v1/images/omni-image

Опрос: GET /franklab/api/v1/images/omni-image/:taskId.

JSON-шаблон:

{
  "model_name": "mist",
  "prompt": "Place this product on a wooden table.",
  "image_list": [{"image_url": "https://media.example.com/product-front.png"}]
}

mist_2_5 (GPT Image 2.5)

POST /franklab/api/v1/images/omni-image — тот же маршрут и поллинг, что mist; модель выбирается значением model_name.

JSON-шаблон:

{
  "model_name": "gpt-image-2.5-sunburst",
  "prompt": "Place this product on a wooden table, photorealistic.",
  "quality": "xhigh",
  "output_format": "webp",
  "background": "transparent"
}

gpt_image_codex

POST /franklab/api/v1/images/gpt-image-codex

Опрос: GET /franklab/api/v1/images/gpt-image-codex/:taskId.

Примечания к model:

• Цена не зависит от модели: тариф определяется только тиром quality. Выбор 2.5 не меняет сумму списания.
• Тиры на этой поверхности — только low/medium/high. xhigh/max не поддерживаются; неизвестный quality молча сводится к medium (сохранённое поведение поверхности).
• Прозрачный фон на codex-маршруте недоступен ни для одной из 2.5-моделей — ограничение провайдера, а не нашей валидации.
• size/точный пиксельный размер codex-бэкендом игнорируется: aspect_ratio остаётся рекомендацией.
• Если подписочный маршрут временно не может исполнить 2.5, приходит типизированный 503 ДО резерва — списания не происходит. Запросы без model этим не затрагиваются.

JSON-шаблон:

{
  "execution_mode": "openai_codex",
  "prompt": "A short calm synthetic test."
}

google_sub_image

POST /franklab/api/v1/images/google-sub

Опрос: GET /franklab/api/v1/images/google-sub/:taskId.

JSON-шаблон:

{
  "execution_mode": "google_subscription",
  "prompt": "A short calm synthetic test."
}

jupiter

POST /franklab/api/v1/images/omni-image

Опрос: GET /franklab/api/v1/images/omni-image/:taskId.

JSON-шаблон:

{
  "model_name": "jupiter-v1-5",
  "resolution": "1k",
  "prompt": "Place the product from <<<image_1>>> on a wooden table.",
  "image_list": [{"image_url": "https://media.example.com/product-front.png"}]
}

xai_imagine_image_2

POST /franklab/api/v1/images/xai-imagine

Опрос: GET /franklab/api/v1/images/xai-imagine/:taskId.

JSON-шаблон:

{
  "model_name": "xai-imagine-image-2",
  "response_format": "url",
  "prompt": "A short calm synthetic test.",
  "quality": "medium",
  "aspect_ratio": "auto",
  "resolution": "1k",
  "n": 1
}

xai_imagine_image

POST /franklab/api/v1/images/xai-imagine

Опрос: GET /franklab/api/v1/images/xai-imagine/:taskId.

JSON-шаблон:

{
  "model_name": "xai-imagine-image-quality",
  "response_format": "url",
  "prompt": "A short calm synthetic test."
}

google_gemini_image

POST /franklab/api/v1/google/gemini-image

Опрос: GET /franklab/api/v1/google/gemini-image/:taskId.

JSON-шаблон:

{
  "model_id": "gemini-3.1-flash-image",
  "prompt": "A flat blue circle on white.",
  "image_size": "0.5K"
}

seedream_image

POST /franklab/api/v1/images/seedream-image

Опрос: GET /franklab/api/v1/images/seedream-image/:taskId.

JSON-шаблон:

{
  "model_id": "seedream-5-0-lite",
  "prompt": "A flat blue circle on white.",
  "resolution": "2K"
}

google_nano_banana_pro

POST /franklab/api/v1/google/nano-banana-pro

Опрос: GET /franklab/api/v1/google/:taskId/record-info.

JSON-шаблон:

{
  "resolution": "1K",
  "prompt": "A blue circle on white."
}

poll:v1/google/:taskId/record-info

GET /franklab/api/v1/google/:taskId/record-info

poll:v1/google/gemini-image/:taskId

GET /franklab/api/v1/google/gemini-image/:taskId

poll:v1/images/google-sub/:taskId

GET /franklab/api/v1/images/google-sub/:taskId

poll:v1/images/gpt-image-codex/:taskId

GET /franklab/api/v1/images/gpt-image-codex/:taskId

poll:v1/images/omni-image/:taskId

GET /franklab/api/v1/images/omni-image/:taskId

poll:v1/images/seedream-image/:taskId

GET /franklab/api/v1/images/seedream-image/:taskId

poll:v1/images/xai-imagine/:taskId

GET /franklab/api/v1/images/xai-imagine/:taskId

KUSOK v.2

Все 16 действий используют POST /make/kusok/operation с backend и action. backend=kusok управляет элементами и голосами, backend=moon — верификацией и Moon assets. Для KUSOK старые сервисные ключи отклоняются. Идентификаторы принадлежат аккаунту; ID задачи, элемента, asset и голоса не взаимозаменяемы.

Создание требует element_name (1–20 символов), element_description (до 100) и reference_type. Для image_refer передайте собственное frontal_image и при необходимости refer_images:[{"image_url":"…","type":"side"}]; для video_refer — refer_videos:[{"video_url":"…"}]. Создание голоса требует аудио/видео, которое вы вправе использовать. Для проверок интеграции используйте синтетические материалы.

Следуйте data.should_poll и data.taskId/task_id: create/recognize могут вернуть async-задачу, остальные действия имеют собственные ответы. Опрос /make/kusok/async/tasks/:taskId — до completed или failed, затем проверка data.result, error_message и пригодного element_id/результата распознавания. Ответ диспетчера poll_task лишь предписывает опрос, а не доказывает состояние очереди.

Moon verify_start запускает H5-верификацию человеком. Полученный токен передаётся в REST как byted_token, а не поле Make verification_token. verify_get_result: HTTP 200 — результат, 202 — ожидание, 409 — ошибка, 410 — срок истёк. Ссылки H5 и токены храните приватно. Для загрузки asset используйте подтверждённый group_id; до использования референса дождитесь Active. Удаление изменяет ресурсы и не служит проверкой подключения.

kusok:create

POST /franklab/api/make/kusok/operation

JSON-шаблон:

{
  "backend": "kusok",
  "action": "create",
  "element_name": "Synthetic circle",
  "element_description": "A blue synthetic circle.",
  "reference_type": "image_refer",
  "frontal_image": "https://example.com/owned-synthetic-image.png"
}

kusok:get

POST /franklab/api/make/kusok/operation

JSON-шаблон:

{
  "backend": "kusok",
  "action": "get",
  "element_id": "REPLACE_WITH_OWNED_ELEMENT_ID"
}

kusok:list

POST /franklab/api/make/kusok/operation

JSON-шаблон:

{
  "backend": "kusok",
  "action": "list"
}

kusok:delete

POST /franklab/api/make/kusok/operation

JSON-шаблон:

{
  "backend": "kusok",
  "action": "delete",
  "element_id": "REPLACE_WITH_OWNED_ELEMENT_ID"
}

kusok:recognize

POST /franklab/api/make/kusok/operation

JSON-шаблон:

{
  "backend": "kusok",
  "action": "recognize",
  "image": "https://example.com/owned-synthetic-media.png"
}

kusok:poll_task

POST /franklab/api/make/kusok/operation

JSON-шаблон:

{
  "backend": "kusok",
  "action": "poll_task",
  "task_id": "REPLACE_WITH_OWNED_TASK_ID"
}

kusok:create_voice

POST /franklab/api/make/kusok/operation

JSON-шаблон:

{
  "backend": "kusok",
  "action": "create_voice",
  "voice_name": "Synthetic Voice",
  "voice_url": "https://example.com/owned-synthetic-audio.mp3"
}

kusok:get_voice

POST /franklab/api/make/kusok/operation

JSON-шаблон:

{
  "backend": "kusok",
  "action": "get_voice",
  "voice_id": "REPLACE_WITH_OWNED_VOICE_ID"
}

kusok:list_voices

POST /franklab/api/make/kusok/operation

JSON-шаблон:

{
  "backend": "kusok",
  "action": "list_voices"
}

kusok:list_preset_voices

POST /franklab/api/make/kusok/operation

JSON-шаблон:

{
  "backend": "kusok",
  "action": "list_preset_voices"
}

kusok:delete_voice

POST /franklab/api/make/kusok/operation

JSON-шаблон:

{
  "backend": "kusok",
  "action": "delete_voice",
  "voice_id": "REPLACE_WITH_OWNED_VOICE_ID"
}

moon:verify_start

POST /franklab/api/make/kusok/operation

JSON-шаблон:

{
  "backend": "moon",
  "action": "verify_start"
}

moon:verify_get_result

POST /franklab/api/make/kusok/operation

JSON-шаблон:

{
  "backend": "moon",
  "action": "verify_get_result",
  "byted_token": "REPLACE_WITH_OWNED_BYTED_TOKEN"
}

moon:create_asset

POST /franklab/api/make/kusok/operation

JSON-шаблон:

{
  "backend": "moon",
  "action": "create_asset",
  "group_id": "REPLACE_WITH_OWNED_GROUP_ID",
  "url": "https://example.com/owned-synthetic-media.png",
  "asset_type": "Image"
}

moon:get_asset

POST /franklab/api/make/kusok/operation

JSON-шаблон:

{
  "backend": "moon",
  "action": "get_asset",
  "asset_id": "REPLACE_WITH_OWNED_ASSET_ID"
}

moon:list_assets

POST /franklab/api/make/kusok/operation

JSON-шаблон:

{
  "backend": "moon",
  "action": "list_assets"
}

poll

GET /franklab/api/make/kusok/async/tasks/:taskId

getAllKusoks RPC

GET /franklab/api/make/kusok/elements

MOON GPT

Генерация текста, структурированного JSON и мультимодальных ответов через /make/dola. Нужен ключ партнёра; старые сервисные ключи получают 403. Получайте model_key и возможности моделей через GET /make/dola/models. По умолчанию выбирается moon_gpt; статический список ниже описывает исходный контракт, а не права аккаунта.

Обязателен prompt. Без REST async_mode запрос синхронный; передайте true, чтобы получить billing_task_id и опрашивать /make/dola/tasks/:billing_task_id. Пока data.cost_status=pending, продолжайте ограниченный опрос. Результат: output_text/content, parsed_json, json_parse_ok/json_parse_error, usage, conversation_id и поля списания. Завершённый биллинг сам по себе не подтверждает соответствие JSON вашей схеме.

Для response_format=json_schema нужны json_schema_name и JSON-объект json_schema, не строка. Поле Make max_tokens преобразуется в REST max_output_tokens; API принимает и max_tokens, но оба одновременно передавать не следует. Максимум зависит от модели и не превышает 65536. thinking_level и thinking_budget взаимоисключающие. Новые Gemini отклоняют temperature и прежний budget. Продолжение диалога сохраняет модель и собственный conversation_id либо поддерживаемый previous_response_id.

Загрузка URL: /files/from-url; загрузка файла: multipart file вместе с filename в /files/upload, максимум 100 МиБ. Затем запрашивайте /files/:file_id. JSON-вариант: base64 file_data, filename, необязательные mime_type/purpose; файл и base64 вместе запрещены. MIME: PDF, JPEG, PNG, GIF, WebP, MP4, QuickTime, AVI, octet-stream. Встроенные файловые объекты Make ограничены 48 КиБ. image_refs, document_refs, video_refs принимают HTTPS/data URI; ссылки file-* работают только с транспортом MOON GPT. Claude Fable 5.1 и GPT-6 Astra принимают изображения и PDF, но по умолчанию отключены независимыми rollout-флагами; это исходный контракт, а не утверждение о текущей готовности. Проверяйте поддержку модальности моделью и готовность файла. RPC JSON-схемы формирует поля редактора Make и не является REST endpoint.

generate

POST /franklab/api/make/dola/generate

JSON-шаблон:

{
  "model_key": "moon_gpt",
  "prompt": "Return the word OK.",
  "max_output_tokens": 16,
  "async_mode": true
}

upload_file_from_url

POST /franklab/api/make/dola/files/from-url

JSON-шаблон:

{
  "url": "https://example.com/owned-synthetic-media.png"
}

upload_file

POST /franklab/api/make/dola/files/upload

JSON-шаблон:

{
  "filename": "synthetic.png",
  "mime_type": "image/png",
  "file_data": "REPLACE_WITH_BASE64"
}

curl --fail-with-body --max-time 120 -X POST \
  -H "X-API-Key: ${FRANKLAB_KEY:?Set your account key}" \
  -F 'file=@./synthetic.png' -F 'filename=synthetic.png' \
  "$FRANKLAB_BASE_URL/make/dola/files/upload"

get_file

GET /franklab/api/make/dola/files/:file_id

delete_file

DELETE /franklab/api/make/dola/files/:file_id

task_status

GET /franklab/api/make/dola/tasks/:billing_task_id

models

GET /franklab/api/make/dola/models

Тело и параметры не требуются.

list_files

GET /franklab/api/make/dola/files

Тело и параметры не требуются.

ORKESTR

lyrics временно недоступна. Если задача уже создана и опрос остаётся в processing, обратитесь в поддержку с её ID перед повторной отправкой.

18 операций музыки/текста/обработки и опрос. Выбирайте путь запроса; поле Make operation в JSON не передаётся. Требуется ключ партнёра; старые сервисные ключи отклоняются. Большинство Suno-операций принимают model: V5, V4_5PLUS, V4_5ALL, V4_5, V4. Только generate добавляет по умолчанию V5, customMode=false, instrumental=false.

REST taskId соответствует Make sourceTaskId, name/description — personaName/personaDescription. Передавайте ID собственных исходных задач и аудио из предыдущих результатов, а не промпт или произвольный UUID. Для upload-cover/extend/mashup передайте прямые HTTPS-ссылки на разрешённые к использованию файлы в uploadUrl/uploadUrl1/uploadUrl2. При customMode=true заполните поля текста, стиля и названия согласно выбранной модели. continueAt, infillStartS, infillEndS, vocalStart, vocalEnd измеряются в секундах; интервалы должны быть упорядочены и находиться внутри исходного аудио. Callback-маршрут задаётся сервисом.

Сохраните FrankLab data.taskId; опрашивайте /make/orkestr/v2/tasks/:taskId примерно раз в 5 секунд, ограничивая время. queued/processing — ожидание, completed/failed — остановка. Проверяйте data.result и data.error. Медиа обычно находятся в data.result.task_result.audios, .videos, .images; lyrics/style возвращают текст/JSON, а не обязательную ссылку на аудио. timestamped_lyrics, boost_style, generate_persona возвращают результат сразу. Поля track1_*/track2_* — проекции Make, не универсальные REST-поля.

Lyria: model=clip или pro. Clip имеет фиксированную длину 30 секунд; pro создаёт полный трек и воспринимает duration_seconds как пожелание, а не точную длину. Дополнительно поддерживается output_format=mp3|wav. Результат: data.audio_url, lyrics_text, duration_seconds, interaction_id. Стоимость зависит от аккаунта; отсутствие отдельного estimate-маршрута или final-cost поля не означает бесплатность.

poll

GET /franklab/api/make/orkestr/v2/tasks/:taskId

generate

POST /franklab/api/make/orkestr/v2/generate

JSON-шаблон:

{
  "model": "V5",
  "prompt": "A short calm synthetic test."
}

extend

POST /franklab/api/make/orkestr/v2/extend

JSON-шаблон:

{
  "audioId": "REPLACE_WITH_OWNED_AUDIOID",
  "model": "V5"
}

upload_cover

POST /franklab/api/make/orkestr/v2/upload-cover

JSON-шаблон:

{
  "uploadUrl": "https://example.com/owned-synthetic-audio.mp3",
  "model": "V5"
}

upload_extend

POST /franklab/api/make/orkestr/v2/upload-extend

JSON-шаблон:

{
  "uploadUrl": "https://example.com/owned-synthetic-audio.mp3",
  "model": "V5",
  "continueAt": 1
}

add_instrumental

POST /franklab/api/make/orkestr/v2/add-instrumental

JSON-шаблон:

{
  "uploadUrl": "https://example.com/owned-synthetic-audio.mp3",
  "title": "Synthetic test",
  "tags": "REPLACE_WITH_OWNED_TAGS"
}

add_vocals

POST /franklab/api/make/orkestr/v2/add-vocals

JSON-шаблон:

{
  "uploadUrl": "https://example.com/owned-synthetic-audio.mp3",
  "prompt": "A short calm synthetic test.",
  "title": "Synthetic test",
  "style": "REPLACE_WITH_OWNED_STYLE"
}

replace_section

POST /franklab/api/make/orkestr/v2/replace-section

JSON-шаблон:

{
  "taskId": "REPLACE_WITH_OWNED_TASKID",
  "audioId": "REPLACE_WITH_OWNED_AUDIOID",
  "prompt": "A short calm synthetic test.",
  "tags": "REPLACE_WITH_OWNED_TAGS",
  "title": "Synthetic test",
  "infillStartS": 1,
  "infillEndS": 2
}

mashup

POST /franklab/api/make/orkestr/v2/mashup

JSON-шаблон:

{
  "uploadUrl1": "https://example.com/owned-synthetic-audio.mp3",
  "uploadUrl2": "https://example.com/owned-synthetic-audio-2.mp3",
  "model": "V5"
}

lyrics

POST /franklab/api/make/orkestr/v2/lyrics

Временно недоступна. Сохраните ID уже созданной задачи для поддержки; для создания песни используйте generate выше.

timestamped_lyrics

POST /franklab/api/make/orkestr/v2/timestamped-lyrics

JSON-шаблон:

{
  "taskId": "REPLACE_WITH_OWNED_TASKID",
  "audioId": "REPLACE_WITH_OWNED_AUDIOID"
}

separate_vocals

POST /franklab/api/make/orkestr/v2/separate-vocals

JSON-шаблон:

{
  "taskId": "REPLACE_WITH_OWNED_TASKID",
  "audioId": "REPLACE_WITH_OWNED_AUDIOID",
  "type": "separate_vocal"
}

generate_midi

POST /franklab/api/make/orkestr/v2/generate-midi

JSON-шаблон:

{
  "taskId": "REPLACE_WITH_OWNED_TASKID"
}

convert_wav

POST /franklab/api/make/orkestr/v2/convert-wav

JSON-шаблон:

{
  "taskId": "REPLACE_WITH_OWNED_TASKID",
  "audioId": "REPLACE_WITH_OWNED_AUDIOID"
}

music_video

POST /franklab/api/make/orkestr/v2/music-video

JSON-шаблон:

{
  "taskId": "REPLACE_WITH_OWNED_TASKID",
  "audioId": "REPLACE_WITH_OWNED_AUDIOID"
}

cover_image

POST /franklab/api/make/orkestr/v2/cover-image

JSON-шаблон:

{
  "taskId": "REPLACE_WITH_OWNED_TASKID"
}

boost_style

POST /franklab/api/make/orkestr/v2/boost-style

JSON-шаблон:

{
  "content": "A short calm synthetic test."
}

generate_persona

POST /franklab/api/make/orkestr/v2/generate-persona

JSON-шаблон:

{
  "taskId": "REPLACE_WITH_OWNED_TASKID",
  "audioId": "REPLACE_WITH_OWNED_AUDIOID",
  "name": "Synthetic test",
  "description": "REPLACE_WITH_OWNED_DESCRIPTION"
}

lyria_music

POST /franklab/api/make/orkestr/v2/lyria-music

JSON-шаблон:

{
  "model": "clip",
  "prompt": "Calm original instrumental piano.",
  "instrumental": true
}

VOLNA

Все 19 действий Make отправляются в POST /make/volna/tts. Всегда указывайте operation; для действий вне TTS оно обязательно. Выбор: диалог/TTS/Turbo ElevenLabs, TTS Google Gemini, Seed Audio, TTS Grok, распознавание, эффекты, изоляция, голоса, дубляж. Список голосов/моделей проверяет метаданные, а не генерацию аудио. Создание/дизайн/сохранение голоса и usage stats отклоняют старые сервисные ключи.

ElevenLabs voice_id берите из /v1/elevenlabs/voices-rpc, Grok — из /v1/xai/voices-rpc; результат RPC: data:[{id,name,…}]. Не придумывайте ID голоса. Google google_tts_mode=single использует google_voice_name; multi — speaker_1_name, speaker_1_voice, speaker_2_name, speaker_2_voice с совпадающими метками в text. Голос Grok по умолчанию — eve. xai_tts_settings и переключатели STT существуют только в интерфейсе Make.

STT и изоляция принимают собственный audio_url; дубляж — source_url и target_lang. Передавайте JSON boolean/number, а keyterm — массив строк. Для клонирования REST использует name/description (алиасы Make clone_name/clone_description нормализуются) и разрешённый file_url. Созданный дизайн сохраняется отдельным действием с voice_name/generated_voice_id.

Seed Audio: text_prompt до 3000 символов, максимум 3 references. Элемент задаёт reference_type=audio|image и один источник: speaker, audio_url, audio_data либо audio_file_data/audio_file_name; для изображений — соответствующие image-поля. Не передавайте все альтернативы одновременно. Формат mp3/wav/pcm/ogg_opus, частота 8000/16000/24000/32000/44100/48000. Темп/громкость -50..100, высота -12..12. Переключатель метаданных REST — boolean audio_aigc_metadata_enable, не Make audio_aigc_metadata_mode.

При наличии data.taskId опрашивайте /make/volna/tasks/:taskId примерно раз в 5 секунд до completed/failed; у синхронного результата/метаданных ID может отсутствовать. Проверяйте data.result, audio_url/audioUrl, resultUrl, text, words, segments, duration_seconds, доступные поля биллинга и транзакции. Make нормализует разные формы ответа. Тайм-аут платного запроса не разрешает повторную отправку.

text-to-dialogue

POST /franklab/api/make/volna/tts

JSON-шаблон:

{
  "operation": "text-to-dialogue",
  "text": "A short calm synthetic test.",
  "voice_id": "REPLACE_WITH_OWNED_VOICE_ID"
}

text-to-speech

POST /franklab/api/make/volna/tts

JSON-шаблон:

{
  "operation": "text-to-speech",
  "text": "A short calm synthetic test.",
  "voice_id": "REPLACE_WITH_OWNED_VOICE_ID"
}

text-to-speech-turbo

POST /franklab/api/make/volna/tts

JSON-шаблон:

{
  "operation": "text-to-speech-turbo",
  "text": "A short calm synthetic test.",
  "voice_id": "REPLACE_WITH_OWNED_VOICE_ID"
}

google-3-1-tts

POST /franklab/api/make/volna/tts

JSON-шаблон:

{
  "operation": "google-3-1-tts",
  "text": "Hello.",
  "google_tts_mode": "single",
  "google_voice_name": "Kore"
}

seed-audio-1-0

POST /franklab/api/make/volna/tts

JSON-шаблон:

{
  "operation": "seed-audio-1-0",
  "text_prompt": "A short calm synthetic test."
}

xai-text-to-speech

POST /franklab/api/make/volna/tts

JSON-шаблон:

{
  "operation": "xai-text-to-speech",
  "text": "Hello.",
  "voice_id": "eve",
  "output_format": "mp3_44100_128"
}

speech-to-text

POST /franklab/api/make/volna/tts

JSON-шаблон:

{
  "operation": "speech-to-text",
  "audio_url": "https://example.com/owned-synthetic-audio.mp3"
}

xai-speech-to-text

POST /franklab/api/make/volna/tts

JSON-шаблон:

{
  "operation": "xai-speech-to-text",
  "audio_url": "https://example.com/owned-synthetic-audio.mp3"
}

google-speech-to-text

POST /franklab/api/make/volna/tts

JSON-шаблон:

{
  "operation": "google-speech-to-text",
  "audio_url": "https://example.com/owned-synthetic-audio.mp3"
}

sound-effect

POST /franklab/api/make/volna/tts

JSON-шаблон:

{
  "operation": "sound-effect",
  "text": "A short calm synthetic test."
}

audio-isolation

POST /franklab/api/make/volna/tts

JSON-шаблон:

{
  "operation": "audio-isolation",
  "audio_url": "https://example.com/owned-synthetic-audio.mp3"
}

voice-list

POST /franklab/api/make/volna/tts

JSON-шаблон:

{
  "operation": "voice-list"
}

xai-voice-list

POST /franklab/api/make/volna/tts

JSON-шаблон:

{
  "operation": "xai-voice-list"
}

voice-clone

POST /franklab/api/make/volna/tts

JSON-шаблон:

{
  "operation": "voice-clone",
  "name": "Synthetic test",
  "file_url": "https://example.com/owned-synthetic-audio.mp3"
}

voice-design

POST /franklab/api/make/volna/tts

JSON-шаблон:

{
  "operation": "voice-design",
  "voice_description": "REPLACE_WITH_OWNED_VOICE_DESCRIPTION"
}

voice-design-save

POST /franklab/api/make/volna/tts

JSON-шаблон:

{
  "operation": "voice-design-save",
  "voice_name": "REPLACE_WITH_OWNED_VOICE_NAME",
  "generated_voice_id": "REPLACE_WITH_OWNED_GENERATED_VOICE_ID"
}

dubbing

POST /franklab/api/make/volna/tts

JSON-шаблон:

{
  "operation": "dubbing",
  "source_url": "https://example.com/owned-synthetic-audio.mp3",
  "target_lang": "en"
}

usage-stats

POST /franklab/api/make/volna/tts

JSON-шаблон:

{
  "operation": "usage-stats"
}

models-list

POST /franklab/api/make/volna/tts

JSON-шаблон:

{
  "operation": "models-list"
}

poll

GET /franklab/api/make/volna/tasks/:taskId

getVoices RPC

GET /franklab/api/v1/elevenlabs/voices-rpc

Тело и параметры не требуются.

getGrokVoices RPC

GET /franklab/api/v1/xai/voices-rpc

Тело и параметры не требуются.

Дополнительные маршруты подключения и результата

Запрос подключения с несуществующим task ID может вернуть 404: это не проверка генерации. Для новых задач используйте статус-маршрут операции, которая вернула ID.

Далее

Выберите одну операцию, проверьте ключ/баланс/доступную оценку, выполните минимальный запрос со своими синтетическими данными и сохраните ID. Затем проверьте итоговый результат и списание. Порядок интеграции · Ошибки · Поддержка.