APIXO стандартизирует параметры во всех моделях внутри каждой категории. Переход с Flux 2 на Midjourney требует минимум изменений кода — изучите один раз, применяйте везде.
Структура запроса Все модели генерации используют одну структуру запроса:
{ "provider" : "auto" , "request_type" : "async" , "callback_url" : "https://your-server.com/callback" , "input" : { "mode" : "text-to-image" , "prompt" : "your description" } }
Параметры верхнего уровня provider
string
по умолчанию: "auto"
Стратегия маршрутизации. Варианты: auto (оптимальный баланс), value (минимальная цена), official (прямой провайдер).
request_type
string
по умолчанию: "async"
Способ получения результатов. async — polling, callback — доставка по webhook.
URL webhook для получения результатов. Обязателен при request_type равном callback. Должен быть публично доступным HTTPS эндпоинтом.
Параметры генерации для конкретной модели. Структура зависит от категории (image, video, audio).
Параметры генерации изображений Все модели изображений (Flux 2, Midjourney, GPT Image 1 и др.) используют общие параметры input:
mode
string
по умолчанию: "text-to-image"
обязательно
Режим генерации: text-to-image или image-to-image.
Текстовое описание желаемого результата. 1–5000 символов.
Элементы, которых следует избегать (например, "blurry, low quality").
URL референсных изображений для режима image-to-image. До 5 изображений, каждое до 10 МБ.
Соотношение сторон: 1:1, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 9:16, 16:9, 21:9 или auto.
Разрешение: 1K, 2K или 4K.
Формат: png (без потерь, больше) или jpeg (сжатый, меньше).
Параметры генерации видео Все модели видео (Sora 2, Kling, Veo и др.) используют общие параметры input:
mode
string
по умолчанию: "text-to-video"
обязательно
Режим: text-to-video или image-to-video.
Текстовое описание желаемого видео.
Элементы, которых следует избегать (например, "shaky, low quality").
URL референсных изображений для режима image-to-video.
aspect_ratio
string
по умолчанию: "16:9"
Соотношение сторон: 1:1, 16:9 или 9:16.
resolution
string
по умолчанию: "1080p"
Разрешение: 480p, 720p или 1080p.
Длительность видео в секундах.
sound
boolean
по умолчанию: "false"
Генерировать ли аудио вместе с видео.
Параметры генерации аудио Модели аудио (Suno) используют следующие параметры input:
Версия Suno: V4, V4_5, V4_5PLUS или V5.
Текст песни или описание желаемой музыки.
customMode
boolean
по умолчанию: "false"
Полный контроль над стилем и текстом песни.
instrumental
boolean
по умолчанию: "false"
Только инструментальная музыка (без вокала).
Справочник соотношений сторон Значение Описание Лучше для 1:1Квадрат Соцсети, аватарки 16:9Широкоэкранный Видео, обои 9:16Вертикальный Мобильные, short video 4:3Классический Традиционные фото 3:4Портрет Портреты 21:9Ультраширокий Кинематограф, баннеры
Краткий справочник { "provider" : "auto" , "request_type" : "async" , "input" : { "mode" : "text-to-image" , "prompt" : "a serene mountain landscape at sunset" , "aspect_ratio" : "16:9" , "resolution" : "2K" } }
{ "provider" : "auto" , "request_type" : "callback" , "callback_url" : "https://your-server.com/callback" , "input" : { "mode" : "text-to-video" , "prompt" : "a drone shot flying over mountains" , "aspect_ratio" : "16:9" , "duration" : 10 } }
{ "provider" : "auto" , "request_type" : "async" , "input" : { "mode" : "V4_5PLUS" , "prompt" : "upbeat pop song about summer" , "customMode" : false , "instrumental" : false } }
См. также