API Syntet.ru

1. Сценарий (один проход)

1. POST …/external/generate — тело с id_model, промптом и параметрами модели.
2. Сохраните из ответа идентификатор истории и передавайте его в поле id_history для картинок, видео и аудио.
3. При необходимости пауза 30–60 с перед первым опросом (одно изображение редко готово быстрее).
4. POST …/external/status каждые ~5 с, пока статус не станет успешным (например SUCCESS) или не вернётся ошибка.
5. POST …/external/files — в ответе список URL готовых файлов (картинка / видео / аудио по типу задачи).

При ошибке можно повторить generate с другим id_model.

2. Базовый URL

Запросы: POST, заголовок Content-Type: application/json.

3. Эндпоинты

Полный URL: https://syntet.ru + путь из таблицы.

4. Тела запросов для status и files

Изображения — поле истории id_history:

{
  "auth_key": "ваш_ключ",
  "id_history": "ИД_ИЗ_ОТВЕТА_GENERATE"
}

Видео и аудио используют то же поле id_history:

{
  "auth_key": "ваш_ключ",
  "id_history": "ИД_ИЗ_ОТВЕТА_GENERATE"
}

Ответ files содержит ссылки на результат (или URL после обработки callback).

5. Примеры curl

Замените YOUR_API_KEY и идентификаторы. В Windows: Git Bash или curl.exe.

Изображения

Генерация

curl -sS -X POST "https://syntet.ru/api/imageAiModel/external/generate" \
  -H "Content-Type: application/json" \
  -d '{
    "auth_key": "YOUR_API_KEY",
    "id_model": "1",
    "referenceUrls": ["https://example.com/image1.jpg","https://example.com/image2.jpg","https://example.com/image3.jpg"],
    "prompt": "Your prompt here.",
    "aspectRatio": "2:3",
    "quality": "1k",
    "amount": "1"
  }'

Статус · файлы

curl -sS -X POST "https://syntet.ru/api/imageAiModel/external/status" \
  -H "Content-Type: application/json" \
  -d '{"auth_key":"YOUR_API_KEY","id_history":"1"}'

curl -sS -X POST "https://syntet.ru/api/imageAiModel/external/files" \
  -H "Content-Type: application/json" \
  -d '{"auth_key":"YOUR_API_KEY","id_history":"1"}'

Видео

Генерация (пример: LTX2.3, id_model 2)

curl -sS -X POST "https://syntet.ru/api/modelAiVideo/external/generate" \
  -H "Content-Type: application/json" \
  -d '{
    "auth_key":"YOUR_API_KEY",
    "id_model":2,
    "prompt":"Slow camera move over a city at sunset",
    "aspectRatio":"16:9",
    "videoLength":"5s",
    "referenceUrls":[
      "https://example.com/video-ref-image-1.jpg",
      "https://example.com/video-ref-image-2.jpg"
    ],
    "generateAudio":false,
    "multiShot":false,
    "enhancedPrompt":false,
    "fixedLens":false,
    "keepOriginalSound":false
  }'

curl -sS -X POST "https://syntet.ru/api/modelAiVideo/external/status" \
  -H "Content-Type: application/json" \
  -d '{"auth_key":"YOUR_API_KEY","id_history":"1"}'

curl -sS -X POST "https://syntet.ru/api/modelAiVideo/external/files" \
  -H "Content-Type: application/json" \
  -d '{"auth_key":"YOUR_API_KEY","id_history":"1"}'

Аудио

Генерация (MiniMax Voice Clone)

curl -sS -X POST "https://syntet.ru/api/modelAiAudio/external/generate" \
  -H "Content-Type: application/json" \
  -d '{
    "auth_key":"YOUR_API_KEY",
    "id_model":1,
    "prompt":"Спокойный голос за кадром, дружелюбный тон",
    "model":"speech-02-turbo",
    "languageBoost":"Russian",
    "voiceId":"maximus007",
    "pronunciationDict":[],
    "speed":1,
    "audioReferenceUrl":"https://example.com/voice-sample.wav"
  }'

curl -sS -X POST "https://syntet.ru/api/modelAiAudio/external/status" \
  -H "Content-Type: application/json" \
  -d '{"auth_key":"YOUR_API_KEY","id_history":"1"}'

curl -sS -X POST "https://syntet.ru/api/modelAiAudio/external/files" \
  -H "Content-Type: application/json" \
  -d '{"auth_key":"YOUR_API_KEY","id_history":"1"}'

6. Полный опрос статуса (Bash)

Переключатель API_KIND: image · video · audio. После выхода из цикла вызовите нужный /external/files.

AUTH="YOUR_API_KEY"
HISTORY_ID="1"
API_KIND="video"

sleep 45

while true; do
  case "$API_KIND" in
    image)
      BODY=$(printf '{"auth_key":"%s","id_history":"%s"}' "$AUTH" "$HISTORY_ID")
      STATUS_URL="https://syntet.ru/api/imageAiModel/external/status"
      ;;
    video)
      BODY=$(printf '{"auth_key":"%s","id_history":"%s"}' "$AUTH" "$HISTORY_ID")
      STATUS_URL="https://syntet.ru/api/modelAiVideo/external/status"
      ;;
    audio)
      BODY=$(printf '{"auth_key":"%s","id_history":"%s"}' "$AUTH" "$HISTORY_ID")
      STATUS_URL="https://syntet.ru/api/modelAiAudio/external/status"
      ;;
  esac
  RESP=$(curl -sS -X POST "$STATUS_URL" -H "Content-Type: application/json" -d "$BODY")
  echo "$RESP"
  echo "$RESP" | grep -q 'SUCCESS' && break
  echo "$RESP" | grep -qi 'ERR\|FAILED\|ERROR' && exit 1
  sleep 5
done

7. Модели изображений

Общая схема тела: auth_key, id_model, prompt, aspectRatio, quality, amount: 1, referenceUrls (длина по таблице), enhancedPrompt. У Ultra Upscale добавляется scaleFactor (x1/x2/x4), prompt может быть пустой строкой.

8. Модели видео (сводная таблица)

У большинства моделей общий набор полей: prompt, при необходимости aspectRatio, resolution, videoLength, referenceUrls, флаги generateAudio, multiShot, enhancedPrompt, fixedLens, keepOriginalSound; при необходимости negativePrompt, shotPrompt1…, referenceVideo, referenceVideoDurationSec, audioReferenceUrl, presetId.

9. Модели аудио

Выберите модель, раскройте блок и скопируйте готовый JSON или curl. API-ключ замените на значение из личного кабинета.

{
  "auth_key": "YOUR_API_KEY",
  "id_model": 1,
  "prompt": "Спокойный голос за кадром, дружелюбный тон",
  "model": "speech-02-turbo",
  "languageBoost": "Russian",
  "voiceId": "maximus007",
  "pronunciationDict": [],
  "speed": 1,
  "audioReferenceUrl": "https://example.com/voice-sample.wav"
}

10. Правила полей

• referenceUrls — длина должна совпадать с требованиями модели; допускается [], где указано «0 референсов».
• id_model задаётся отдельно для графики, видео и аудио (одинаковый номер в разных таблицах — разные домены).
• Опционально presetId, если используете пресеты из кабинета.
• В музыкальных моделях текст песни может передаваться полем lirycs — при ошибке валидации сверьтесь с ответом API.
• Допустимые значения aspectRatio, videoLength и качества уточняйте по интерфейсу генерации на syntet.ru — они обновляются вместе с моделями.