Работа с API

    Генерация изображения Gemini

    Копировать страницу

    NeuroAPI предоставляет доступ к передовым моделям генерации изображений от Google: gemini-2.5-flash-image и gemini-3-pro-image-preview. Эти модели поддерживают как создание изображений по текстовому описанию, так и редактирование существующих изображений.

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

    МодельОписаниеРазрешение
    gemini-2.5-flash-image Быстрая и эффективная модель для генерации изображений. Только 1K
    gemini-3-pro-image-previewПродвинутая модель с высокой детализацией и качеством.1K, 2K и 4K

    Размеры и соотношение сторон

    Параметр size в API запросе используется для определения соотношения сторон генерируемого изображения. Ниже приведена таблица соответствия размеров и соотношений сторон:

    Мы поддерживаем обратную совместимость с размерами моделей DALL-E. Размеры 1024x1536 и 1536x1024 автоматически конвертируются в соответствующий Aspect Ratio для моделей Gemini.
    Size (API)Aspect RatioОписание
    1024x10241:1Квадрат
    848x1264, 1024x15362:3Классическое фото (портрет)
    1264x848, 1536x10243:2Классическое фото
    896x12003:4Стандартный монитор (портрет)
    1200x8964:3Стандартный монитор
    928x11524:5Печатный формат (портрет)
    1152x9285:4Печатный формат
    1376x76816:9Широкоформатный (ландшафт)
    768x13769:16Вертикальный (портрет)
    1584x67221:9Ультраширокий

    Качество и разрешение

    Параметр quality управляет разрешением генерируемого изображения.

    Модель gemini-2.5-flash-image поддерживает генерацию только в разрешении 1K, независимо от выбранного качества. Разрешения 2K и 4K доступны только для модели gemini-3-pro-image-preview.
    Quality (API)РазрешениеЦена
    low1K (1024x1024 и эквиваленты)x1
    medium2K (2048x2048 и эквиваленты)x1.5
    high4K (3072x3072 и эквиваленты)x2

    Примеры использования

    Генерация изображения

    import fs from 'fs';
    import OpenAI from 'openai';
    
    const client = new OpenAI({
      apiKey: 'YOUR_API_KEY',
      baseURL: 'https://neuroapi.host/v1',
    });
    
    async function generateImage() {
      const response = await client.images.generate({
        model: "gemini-3-pro-image-preview",
        prompt: "Футуристический город в стиле киберпанк, неоновые огни, дождь",
        size: "1376x768", // 16:9 aspect ratio
        quality: "high",    // 4K resolution
      });
    
      // Save the image to a file
      const image_base64 = response.data[0].b64_json;
      const image_bytes = Buffer.from(image_base64, "base64");
      fs.writeFileSync("future_city.png", image_bytes);
    }
    
    generateImage();

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

    Модели Gemini поддерживают редактирование изображений через эндпоинт /v1/images/edits. Вы можете загрузить исходное изображение и указать текстовый промпт, описывающий желаемые изменения. Модель проанализирует изображение и применит инструкции, сохраняя общую композицию там, где это возможно.

    import fs from 'fs';
    import OpenAI from 'openai';
    
    const client = new OpenAI({
      apiKey: 'YOUR_API_KEY',
      baseURL: 'https://neuroapi.host/v1',
    });
    
    async function editImage() {
      const response = await client.images.edit({
        image: fs.createReadStream("original.png"),
        prompt: "Make it snow in the photo",
        model: "gemini-3-pro-image-preview",
        size: "1024x1024",
      });
    
      // Save the image to a file
      const image_base64 = response.data[0].b64_json;
      const image_bytes = Buffer.from(image_base64, "base64");
      fs.writeFileSync("snowy_city.png", image_bytes);
    }
    
    editImage();