MiniMax H3 Image API
Полный справочник API моделей MiniMax H3 Image для генерации изображений по тексту и редактирования изображений.
Варианты модели
Этот API поддерживает два варианта модели:
Краткое сравнение
Поддерживаемые соотношения сторон
1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9
Передавайте соотношение сторон отдельными числовыми значениями width и height, а не размерами в пикселях. Если оба значения пропущены, по умолчанию используется 1:1; в противном случае укажите оба значения, используя одну из поддерживаемых пар целых чисел.
MiniMax H3 Image (генерация по тексту)
Конечная точка
POST /api/v1/image/task
Аутентификация {#}
Authorization: Bearer YOUR_API_KEY
Параметры запроса
Обязательные
Необязательные
Примечание: Соотношение ширины и высоты должно быть одним из 15 поддерживаемых соотношений, перечисленных выше.
Пример запроса
javascript
MiniMax H3 Image Edit (редактирование изображений)
Конечная точка
POST /api/v1/image/task
Параметры запроса
Обязательные
Необязательные
Примечание: Соотношение ширины и высоты должно быть одним из 15 поддерживаемых соотношений, перечисленных выше.
Пример запроса
javascript
Пример редактирования одного изображения
javascript
Пример композиции из нескольких изображений
javascript
Формат ответа
Первоначальный ответ
json
Ответ при опросе
Проверяйте статус периодическими запросами GET /api/v1/image/{task_id}. В успешных ответах на опрос URL сгенерированных изображений находятся в data.task_result.images[].url.
Значения статуса
submitted: Задача принятаprocessing: Выполняется генерация изображенияsucceed: Генерация изображения завершенаfailed: Ошибка генерации изображения
Рекомендации
- Подробные промпты: Описывайте объект, освещение и композицию, ограничивая длину промпта 5000 символами
- Выбор разрешения: Явно передавайте
1k,2kили4kв каждом запросе - Соотношение сторон: Указывайте парные значения соотношения для
widthиheightили пропускайте оба для1:1 - Качество редактирования: Предоставляйте 1-16 референсных изображений, соответствующих требованиям к поддерживаемым форматам и размерам