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

Ideogram 3: редактирование изображения с маской и промптом | RunComfy

ideogram/ideogram-v3/edit

Отредактируйте частично замаскированную область по промпту и задайте другие параметры генерации.

Содержание

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

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

Используйте API RunComfy для запуска ideogram/ideogram-v3/edit. Допустимые входы и выходы см. в схеме.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/ideogram/ideogram-v3/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image": "https://playgrounds-storage-public.runcomfy.net/tools/7018/media-files/usecase3-1-input.png",
    "mask": "",
    "prompt": "Add a luxury titanium wristwatch to his left wrist, glinting subtly in the sunlight"
  }'

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/ideogram/ideogram-v3/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image": "https://playgrounds-storage-public.runcomfy.net/tools/7018/media-files/usecase3-1-input.png",
    "mask": "",
    "prompt": "Add a luxury titanium wristwatch to his left wrist, glinting subtly in the sunlight"
  }'

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

Текущее состояние по 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": [
    "image",
    "mask",
    "prompt"
  ],
  "properties": {
    "image": {
      "title": "Изображение",
      "description": "Обязательное изображение для редактирования.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7018/media-files/usecase3-1-input.png"
    },
    "prompt": {
      "title": "Промпт",
      "description": "Обязательное описание изменения в замаскированной области.",
      "type": "string",
      "default": "Add a luxury titanium wristwatch to his left wrist, glinting subtly in the sunlight"
    },
    "seed": {
      "title": "Сид",
      "description": "Целое число от 0 до 2147483647; значение по умолчанию — `99097570`.",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer",
      "default": 99097570
    },
    "rendering_speed": {
      "title": "Скорость рендеринга",
      "description": "Выберите `TURBO`, `BALANCED` или `QUALITY`; по умолчанию — `BALANCED`.",
      "type": "string",
      "enum": [
        "TURBO",
        "BALANCED",
        "QUALITY"
      ],
      "default": "BALANCED"
    },
    "magic_prompt": {
      "title": "Расширение промпта",
      "description": "Выберите `AUTO`, `ON` или `OFF`; по умолчанию — `ON`.",
      "type": "string",
      "default": "ON",
      "enum": [
        "AUTO",
        "ON",
        "OFF"
      ]
    },
    "color_palette": {
      "title": "Цветовая палитра",
      "description": "Настраивает цветовую палитру; по умолчанию — `Ember`.",
      "type": "object",
      "default": {
        "name": "Ember"
      }
    },
    "style": {
      "title": "Стиль",
      "description": "Настраивает стиль; тип по умолчанию — `Auto`.",
      "type": "object",
      "default": {
        "style_type": "Auto"
      }
    },
    "mask": {
      "title": "Маска",
      "description": "Обязательная частичная маска; полная или отсутствующая маска недопустима.",
      "type": "string"
    }
  }
}

Схема выхода

{
  "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 для создания невероятного искусства.