Перейти к основному содержанию
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7-image-pro",
    "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
  }'

{
  "code": "success",
  "data": [
    {
      "task_id": "task_01HX...",
      "status": "processing"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7-image-pro",
    "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
  }'

{
  "code": "success",
  "data": [
    {
      "task_id": "task_01HX...",
      "status": "processing"
    }
  ]
}

​
Авторизация

​
Authorization
string
обязательно
Все запросы требуют аутентификации Bearer Token.Перейдите на страницу управления API ключами, чтобы получить свой API Key, затем добавьте его в заголовок запроса:
Authorization: Bearer YOUR_API_KEY

​
Доступные модели

МодельОписаниеМакс. разрешение (text-to-image)Макс. разрешение (редактирование / последовательная)Цена
wan2.7-image-proПрофессиональная редакция, лучше детали, поддерживает 4K4K2K¥0.50 / изображение
wan2.7-imageСтандартная редакция, более быстрая генерация2K2K¥0.20 / изображение
Тарификация рассчитывается как успешно сгенерированные изображения × цена за единицу. Входные данные не тарифицируются. Разрешение и соотношение сторон не влияют на стоимость. Неудачные запросы не оплачиваются.

​
Тело запроса

​
model
string
обязательно
Название модели генерации изображений.
  • wan2.7-image-pro — профессиональная редакция, до 4K для text-to-image
  • wan2.7-image — стандартная редакция, более быстрая, до 2K
​
prompt
string
Текстовое описание для генерации изображения, до 5000 символов.
  • Text-to-image (без image_urls): обязательно
  • Редактирование изображения (с image_urls): необязательно, но рекомендуется
Пример: "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
​
image_urls
array<string>
Массив URL входных изображений для сценариев редактирования и мультиизображенческих референсов.Указание этого поля переключает запрос в режим редактирования изображения.Поддерживаемые форматы: HTTP/HTTPS URL; data:image/...;base64,... Base64Ограничения: до 9 изображений; JPEG / PNG / WEBP / BMP; 240–8000 px, соотношение сторон 1:8 ~ 8:1; ≤ 20MB на изображение
Соотношение сторон вывода автоматически соответствует последнему входному изображению. Режим редактирования поддерживает только до 2K — 4K недоступно.
​
n
integer
по умолчанию:"1"
Количество генерируемых изображений.
  • Стандартный режим: 1–4 (по умолчанию 1)
  • Последовательный режим (enable_sequential: true): 1–12 (по умолчанию 1)
Тарификация за каждое успешно сгенерированное изображение. Предоплата на основе n.
​
size
string
Выходное разрешение или соотношение сторон. Поддерживает три формата:① Ключевое слово разрешения (рекомендуется): 1K / 2K (по умолчанию) / 4K (только text-to-image для wan2.7-image-pro)② Соотношение сторон: 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 (по умолчанию уровень 2K)③ Размеры в пикселях: 1024x1024 или 1024*1024
​
resolution
string
Ключевое слово уровня разрешения: 1K / 2K / 4K. Можно сочетать с size (соотношение сторон).
МодельСценарийПоддерживаемые уровниДиапазон пикселей
wan2.7-image-proText-to-image (не последовательный)1K / 2K / 4K768×768 ~ 4096×4096
wan2.7-image-proРедактирование / последовательная1K / 2K768×768 ~ 2048×2048
wan2.7-imageВсе сценарии1K / 2K768×768 ~ 2048×2048
​
negative_prompt
string
Негативный промпт, описывающий элементы, которых следует избегать. Пример: "blurry, distorted, low quality"
​
watermark
boolean
по умолчанию:"false"
Добавлять ли водяной знак “AI Generated” в правый нижний угол.
​
seed
integer
Случайное зерно, диапазон 0–2147483647. Одно и то же зерно с идентичными параметрами даёт визуально согласованные результаты.
​
thinking_mode
boolean
по умолчанию:"true"
Включить улучшенный режим рассуждения для повышения качества изображения за счёт увеличения времени генерации.
Действует только когда последовательный режим отключён и не передано входное изображение.
​
enable_sequential
boolean
по умолчанию:"false"
Включить режим последовательной генерации изображений — генерирует несколько тематически связных изображений за один запрос. Идеально для раскадровок и серий.
  • Максимум n равен 12 при включении
  • thinking_mode и color_palette игнорируются в последовательном режиме
  • wan2.7-image-pro поддерживает до 2K в последовательном режиме (4K не поддерживается)
​
bbox_list
array
Ограничивающие рамки для интерактивного редактирования — задаёт точные области для редактирования или вставки контента.Структура: [[[x1, y1, x2, y2], ...], ...]
  • Длина внешнего массива должна совпадать с длиной image_urls
  • Передавайте [] для изображений без ограничивающей рамки
  • Максимум 2 рамки на изображение; координаты — абсолютные значения в пикселях, начало координат (0,0) в левом верхнем углу
Пример: [[], [[989, 515, 1138, 681]]]
​
color_palette
array<object>
Пользовательская цветовая тема. Только стандартный режим (не последовательный режим).
  • 3–10 записей (рекомендуется 8); каждая запись требует hex и ratio
  • Сумма всех значений ratio должна быть точно равна 100.00%
[
  { "hex": "#C2D1E6", "ratio": "23.51%" },
  { "hex": "#636574", "ratio": "76.49%" }
]

​
Ответ

​
code
string
Статус ответа. Возвращает "success" при успехе.
​
data
array

​
Примеры

​
Text-to-image (минимальный)

{
  "model": "wan2.7-image-pro",
  "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
}

​
Text-to-image (с разрешением)

{
  "model": "wan2.7-image-pro",
  "prompt": "Summer beach, blue sky and white clouds, 4K ultra HD",
  "size": "4K",
  "thinking_mode": true
}

​
Text-to-image (пользовательская цветовая палитра)

{
  "model": "wan2.7-image-pro",
  "prompt": "Minimalist modern living room",
  "size": "2K",
  "color_palette": [
    { "hex": "#C2D1E6", "ratio": "23.51%" },
    { "hex": "#CDD8E9", "ratio": "20.13%" },
    { "hex": "#B5C8DB", "ratio": "15.88%" },
    { "hex": "#C0B5B4", "ratio": "13.27%" },
    { "hex": "#DAE0EC", "ratio": "10.11%" },
    { "hex": "#636574", "ratio": "8.93%" },
    { "hex": "#CACAD2", "ratio": "5.55%" },
    { "hex": "#CBD4E4", "ratio": "2.62%" }
  ]
}

​
Последовательная генерация изображений

{
  "model": "wan2.7-image-pro",
  "prompt": "Cinematic series: the same stray orange cat, consistent features. First: under cherry blossoms in spring. Second: old street shade in summer. Third: fallen leaves in autumn. Fourth: snow footprints in winter.",
  "enable_sequential": true,
  "n": 4,
  "size": "2K"
}

​
Редактирование одного изображения

{
  "model": "wan2.7-image",
  "prompt": "Replace the background with a sunset scene, warm color tones",
  "image_urls": ["https://example.com/portrait.jpg"],
  "size": "2K"
}

​
Мультиизображенческий референс / объединение элементов

{
  "model": "wan2.7-image-pro",
  "prompt": "Apply the graffiti from image 2 onto the car in image 1",
  "image_urls": [
    "https://example.com/car.webp",
    "https://example.com/paint.webp"
  ],
  "size": "2K"
}

​
Интерактивное редактирование (ограничивающая рамка)

bbox_list соответствует image_urls один к одному. Передавайте [] для изображений без выделения. 
{
  "model": "wan2.7-image-pro",
  "prompt": "Place the alarm clock from image 1 into the selected area of image 2, blending naturally",
  "image_urls": [
    "https://example.com/clock.webp",
    "https://example.com/desk.webp"
  ],
  "bbox_list": [
    [],
    [[989, 515, 1138, 681]]
  ],
  "size": "2K"
}
Запрос результатовГенерация изображений выполняется асинхронно. Опрашивайте конечную точку статуса задачи, используя возвращённый task_id, пока status == completed.