Wan 2.7 Image API

ПровайдерAlibaba

wan-27-image — генерация изображений-модель от Alibaba.

image_to_imagetext_to_image

Попробуйте прямо здесь

Что умеет Wan 2.7 Image

  • Редактирование изображений
  • Изображение по тексту

Стоимость

за изображение
1024
3.96 ₽

Цены указаны в рублях и списываются с баланса проекта за успешные запросы. Надбавки (+) суммируются с базовой ставкой.

Технические характеристики

Vendor
alibaba
Modality
image

Wan 2.7 Image: генерация и редактирование изображений

Wan 2.7 Image — модель Alibaba Cloud из Китая, выпущенная 1 апреля 2026 года. Она объединяет генерацию изображений по тексту, редактирование по инструкциям и работу с несколькими референсами в едином API. Модель выделяется вниманием к сложным композициям, пространственным связям и точности текстовых запросов; стандартная версия ориентирована на более быструю генерацию.

Параметры запроса

Параметры, которые принимает модель. Передаются в теле запроса.

ПараметрТипДиапазон / значенияПо умолчаниюОписание
positivePromptreq
string
max: 3000
—
Текстовый промпт описывающий желаемое изображение. Поддерживается multilingual text rendering в 12 языках.
1 пример
Примеры
Постер фильма: герой смотрит в горизонт, заголовок "BEYOND" крупным шрифтом, кинематографическая палитра.
widthreq
integer
min: 768 · max: 2048
—
Ширина в px. Любое значение от 768 до 2048 с шагом 16. Парный к height.
3 примеров
Примеры
1024
1536
2048
heightreq
integer
min: 768 · max: 2048
—
Высота в px. Любое значение от 768 до 2048 с шагом 16. Парный к width.
3 примеров
Примеры
1024
1536
2048
seed
integer
min: 0 · max: 2147483647
—
Seed для воспроизводимой генерации (32-bit). Если не указан — выбирается случайно.
inputs.referenceImages
array of strings
min: 1 · max: 9
—
Reference-изображения (UUID / URL / Data URI / Base64). До 9 шт — для image-to-image, edit, virtual avatar customization.
1 пример
Примеры
[
  "https://example.com/ref.jpg"
]
providerSettings.alibaba.colorPalette
array of objects
min: 3 · max: 10
—
Палитра цветов для guidance. Каждый item — объект {hex, ratio}.
1 формата ввода
Color palette entries
ПолеТипЗначенияОписание
hexreqstring—Hex-код цвета (например, "#C2D1E6").
ratioreqstring—Процент использования цвета (например, "23.51%").
[
  {
    "hex": "#C2D1E6",
    "ratio": "40%"
  },
  {
    "hex": "#1E2C3F",
    "ratio": "35%"
  },
  {
    "hex": "#F4E3C1",
    "ratio": "25%"
  }
]
providerSettings.alibaba.editRegions
array
—
—
Bounding-box регионы для interactive editing. Каждый элемент — массив [x1, y1, x2, y2] с абсолютными пиксельными координатами. Количество должно совпадать с количеством входных изображений; пустой массив [] для изображений без редактирования.
1 пример
Примеры
[
  [
    100,
    100,
    500,
    500
  ],
  []
]
providerSettings.alibaba.sequential
boolean
—
false
Image set output mode — генерация нескольких связанных изображений (например, для storyboard).
providerSettings.alibaba.thinking
boolean
—
true
Thinking mode — улучшенное качество ценой увеличенного времени генерации.
numberResults
integer
min: 1 · max: 20
1
Сколько вариаций сгенерировать.
outputType
enum
URL, base64Data, dataURI
URL
Формат доставки.
outputFormat
enum
JPG, PNG, WEBP
JPG
Формат изображения.
outputQuality
integer
min: 20 · max: 99
95
Качество компрессии.
async
boolean
—
false
true → task_id для async-polling. false (default) → sync.
safety.checkContent
boolean
—
false
Включить проверку контента.
safety.mode
enum
none, fast
none
Режим safety-сканера.
webhookURL
string
—
—
URL для POST-уведомления async.
1 пример
Примеры
https://yourapp.com/webhooks/runware
uploadEndpoint
string
—
—
Presigned URL для автозагрузки.
1 пример
Примеры
https://bucket.s3.amazonaws.com/result.png?X-Amz-Signature=...

Параметры ответа

Что возвращает API. У медиа-моделей формат зависит от режима: sync — сразу результат, async — task_id для опроса через GET /v1/tasks/{id}.

Sync (HTTP 200)

Sync-ответ (default). HTTP 200 + JSON.

ПолеТипЗначенияОписание
created
integer
—
Unix timestamp когда сгенерировано.
data
array
—
Каждый элемент:
  • url— string · CDN URL картинки (если outputType=URL).
  • b64_json— string · Base64-кодированный PNG/JPG (если outputType=base64Data).
  • taskUUID— string · Идентификатор upstream-задачи (для chain в i2i и т.п.).
  • seed— integer · Использованный seed (если детерминистичная генерация).
provider
string
—
Вендор для отладки.

Async (HTTP 202)

Если в запросе передан async:true → HTTP 202.

ПолеТипЗначенияОписание
id
string
—
task_id для опроса через GET /v1/tasks/{id}.
object
string
image.task
status
enum
queued, processing, completed, failed
model
string
—
Public model id.
created
integer
—

Опрос статуса (GET /v1/tasks/{id})

GET /v1/tasks/{id} — опрос статуса async-задачи.

ПолеТипЗначенияОписание
id
string
—
object
string
task
status
enum
queued, processing, completed, failed, canceled
modality
string
image
model
string
—
created
integer
—
data
array
—
Каждый элемент:
  • url— string · CDN URL артефакта (если completed).
error
string
—
Сообщение об ошибке (если failed).

Пример кода

wan-27-image_example.py
from openai import OpenAI

client = OpenAI(api_key="rk_live_...", base_url="https://api.ranvik.ru/v1")
resp = client.images.generate(
    model= "wan-27-image",
    positivePrompt= "Пример промпта",
    width= 1408,
    height= 1408,
    seed= 1073741824,
    numberResults= 1,
    outputType= "URL",
    outputFormat= "JPG",
    outputQuality= 95,
    async= False,
    webhookURL= "https://example.com/...",
    uploadEndpoint= "value",
    inputs= {
        "referenceImages": []
    },
    providerSettings= {
        "alibaba": {
            "colorPalette": [],
            "editRegions": [],
            "sequential": False,
            "thinking": True
        }
    },
    safety= {
        "checkContent": False,
        "mode": "none"
    },
)
print(resp)
Полная документация модели

Частые вопросы о Wan 2.7 Image

Wan 2.7 Image — модель Alibaba Cloud для генерации и редактирования изображений по тексту и референсам. В Ranvik API она доступна через единый API.
Модель помогает создавать визуалы для карточек товаров, рекламы, соцсетей и дизайна, а также редактировать изображения по инструкции без сложной обработки.
API Wan 2.7 Image можно получить в Ranvik API: зарегистрируйтесь, выберите модель и используйте единый интерфейс сервиса для интеграции в свой продукт.
В России API Wan 2.7 Image можно использовать через Ranvik API без VPN: сервис предоставляет удобный доступ к модели для рабочих задач и интеграций.
Да, в Ranvik API доступна оплата в российских рублях. Это упрощает подключение Wan 2.7 Image и помогает планировать расходы на генерацию.
Wan 2.7 Image поддерживает создание изображений по текстовому описанию, редактирование по инструкции и работу с несколькими изображениями-референсами.