logo
RunComfy
  • ComfyUI
  • ТренерНовое
  • Модели
  • API
  • Цены
discord logo
МОДЕЛИ
Обзор
Все модели
БИБЛИОТЕКА
Генерации
API МОДЕЛЕЙ
Документация API
API-ключи
АККАУНТ
Использование

Z Image Turbo: генерация с шестью форматами кадра | RunComfy

tongyi-mai/z-image/turbo/text-to-image

Создавайте по тексту до четырёх изображений и настраивайте размер, шаги, сид и формат.

Содержание

1. Начало работы2. Аутентификация3. Справочник APIОтправить запросСтатус запросаПолучить результатыОтменить запрос4. Входные файлыРазмещённый файл (URL)5. СхемаСхема входаСхема выхода

1. Начало работы

Используйте API RunComfy для запуска tongyi-mai/z-image/turbo/text-to-image. Допустимые входы и выходы см. в схеме.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/tongyi-mai/z-image/turbo/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A flash-lit, intimate close-up reveals a front pocket of acid-washed denim jeans, threads softened and grainy with wear. Nestled inside, a cluster of black-and-white photobooth strips peeks out, their glossy surfaces curling and one corner torn, capturing a group of friends mid-smirk. They hold lighters aloft, their faces alive with chaotic joy and youthful rebellion. The hard flash splinters against metal rivets and creased fabric, accentuating the textured weave of denim and the faint creases in the photographs. The composition’s tight crop focuses tension between rough fabric and fleeting memories, conjuring an authentic snapshot of carefree moments preserved in stillness."
  }'

2. Аутентификация

Задайте для переменной окружения YOUR_API_TOKEN ваш API-ключ (управление в Профиль) и передавайте в каждом запросе Bearer-токен в заголовке Authorization : Authorization: Bearer $YOUR_API_TOKEN.

3. Справочник API

Отправить запрос

Отправьте асинхронную задачу генерации и сразу получите request_id и URL для статуса, результатов и отмены.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/tongyi-mai/z-image/turbo/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A flash-lit, intimate close-up reveals a front pocket of acid-washed denim jeans, threads softened and grainy with wear. Nestled inside, a cluster of black-and-white photobooth strips peeks out, their glossy surfaces curling and one corner torn, capturing a group of friends mid-smirk. They hold lighters aloft, their faces alive with chaotic joy and youthful rebellion. The hard flash splinters against metal rivets and creased fabric, accentuating the textured weave of denim and the faint creases in the photographs. The composition’s tight crop focuses tension between rough fabric and fleeting memories, conjuring an authentic snapshot of carefree moments preserved in stillness."
  }'

Статус запроса

Текущее состояние по request_id: «in_queue», «in_progress», «completed» или «cancelled».

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Получить результаты

Финальные выходные данные и метаданные для request_id; если задача не завершена, в ответе — текущее состояние для дальнейшего опроса.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Отменить запрос

Отмена задачи в очереди по request_id; выполняющиеся задачи отменить нельзя.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. Входные файлы

Размещённый файл (URL)

Укажите публично доступный HTTPS URL. Хост должен разрешать серверные запросы (без входа и cookie), без жёсткого лимита и блокировки ботов. Рекомендуется: изображения ≤ 50 МБ (~4K), видео ≤ 100 МБ (~2–5 мин при 720p). Для приватных ресурсов — стабильные или подписанные URL.

5. Схема

Схема входа

{
  "type": "object",
  "title": "Схема входа",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "Промпт",
      "description": "",
      "type": "string",
      "default": "A flash-lit, intimate close-up reveals a front pocket of acid-washed denim jeans, threads softened and grainy with wear. Nestled inside, a cluster of black-and-white photobooth strips peeks out, their glossy surfaces curling and one corner torn, capturing a group of friends mid-smirk. They hold lighters aloft, their faces alive with chaotic joy and youthful rebellion. The hard flash splinters against metal rivets and creased fabric, accentuating the textured weave of denim and the faint creases in the photographs. The composition’s tight crop focuses tension between rough fabric and fleeting memories, conjuring an authentic snapshot of carefree moments preserved in stillness."
    },
    "image_size": {
      "title": "Соотношение сторон (Ш:В)",
      "description": "",
      "type": "string",
      "enum": [
        "square_hd",
        "square",
        "portrait_4_3",
        "portrait_16_9",
        "landscape_4_3",
        "landscape_16_9"
      ],
      "default": "landscape_4_3"
    },
    "num_inference_steps": {
      "title": "Количество шагов генерации",
      "description": "",
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "default": 8
    },
    "num_images": {
      "title": "Количество изображений",
      "description": "Количество изображений, которые нужно сгенерировать.",
      "type": "integer",
      "minimum": 1,
      "maximum": 4,
      "default": 1
    },
    "output_format": {
      "title": "Формат вывода",
      "description": "Определяет формат выходного изображения.",
      "type": "string",
      "enum": [
        "jpeg",
        "png",
        "webp"
      ],
      "default": "png"
    },
    "seed": {
      "title": "Сид",
      "description": "",
      "type": "integer",
      "default": 0
    }
  }
}

Схема выхода

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL одного изображения"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL одного видео"
      },
      "images": {
        "type": "array",
        "description": "несколько URL изображений",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "несколько URL видео",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}
Подписывайтесь на нас
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
Поддержка
  • Discord
  • Email
  • Статус системы
  • партнёр
Модели видео
  • MiniMax H3 Open
  • FLUX 3 Image to Video
  • MiniMax H3 Open Image to Video
  • Wan 2.6 Flash
  • Happy Horse 1.1 reference to video
  • Seedance 1.5 Pro Text to Video
  • Посмотреть все модели →
Модели изображений
  • Seedream 5.0 Pro Image Edit
  • Flux 2 Flash Edit
  • Nano Banana Pro
  • seedream 4.0
  • GPT Image 2
  • Qwen Image Edit 2511 LoRA
  • Посмотреть все модели →
Юридическая информация
  • Условия обслуживания
  • Политика конфиденциальности
  • Политика в отношении файлов cookie
RunComfy
Авторское право 2026 RunComfy. Все права защищены.

RunComfy - ведущая ComfyUI платформа, предлагающая ComfyUI онлайн среду и услуги, а также рабочие процессы ComfyUI с потрясающей визуализацией. RunComfy также предоставляет AI Models, позволяя художникам использовать новейшие инструменты AI для создания невероятного искусства.