Grok Imagine API: генерация изображения через SDK Pipe2

Чтобы использовать Grok Imagine API через Pipe2, запустите Image Generator с model: 'grok-imagine-image'. Отправьте текстовый промпт, проверяйте статус по полученному ID запуска и заберите созданное изображение. В этом руководстве используются API и авторизация Pipe2; прямой запрос к API xAI здесь не рассматривается.

Выберите Grok явно

Идентификатор пайплайна — image-generator; идентификатор модели передаётся внутри input. Для стандартной модели используйте grok-imagine-image, для Grok Imagine Quality — grok-imagine-image-quality. Auto может выбрать другой движок, поэтому укажите модель явно, если нужен именно Grok.

В примере выбрана стандартная модель без референсов с quality: 'fast': это допустимая конфигурация Grok с минимальной стоимостью для данного сценария. Fast задаёт выходное изображение 1K; auto и hd — 2K. У стандартной модели Grok базовая цена изображения сейчас одинакова для обоих размеров: fast не даёт дополнительной скидки. Референсы увеличивают стоимость. Перед серией генераций вызовите EstimatePipelineCost с тем же идентификатором пайплайна и теми же входными данными.

Запустите пример с SDK

Установите пакет командой npm install @pipe2-ai/sdk. Сохраните код ниже как grok-image.mjs, задайте в окружении PIPE2_TOKEN с персональным токеном доступа Pipe2 и выполните node grok-image.mjs. На аккаунте должно быть достаточно кредитов. Храните токен на сервере.

import { createClient } from '@pipe2-ai/sdk';

const token = process.env.PIPE2_TOKEN;
if (!token) throw new Error('Set PIPE2_TOKEN');
const client = createClient(token);
const input = {
  model: 'grok-imagine-image',
  prompt: 'A small red paper boat on a rain-darkened stone step, soft morning light, editorial photograph, no text.',
  quality: 'fast',
  enhance_prompt: false,
};
const { run_pipeline } = await client.RunPipeline({
  pipeline_slug: 'image-generator',
  input,
});

for (let attempt = 0; attempt < 60; attempt++) {
  const { pipeline_runs_by_pk: run } = await client.GetPipelineRun({
    id: run_pipeline.run_id,
  });
  if (!run) throw new Error('Run not found');
  if (run.status === 'failed' || run.status === 'cancelled') {
    throw new Error(run.error_message ?? run.status);
  }
  if (run.status === 'completed') {
    const url = run.assets?.[0]?.url;
    if (!url) throw new Error('Completed run has no image asset');
    console.log(url);
    process.exit(0);
  }
  await new Promise((resolve) => setTimeout(resolve, 3000));
}
throw new Error(`Polling timed out; resume with run ID ${run_pipeline.run_id}`);

Соответствующий запрос к пайплайну:

{
  "pipeline_slug": "image-generator",
  "input": {
    "model": "grok-imagine-image",
    "prompt": "A small red paper boat on a rain-darkened stone step, soft morning light, editorial photograph, no text.",
    "quality": "fast",
    "enhance_prompt": false
  }
}

Клиент, используемый в этом JavaScript-модуле, описан в документации TypeScript SDK, а публичный API — в справочнике API.

Сохраните ID, пока изображение не будет готово

RunPipeline возвращает ID запуска, а не готовое изображение. GetPipelineRun получает статус и выходные файлы. Пример останавливается при ошибке или отмене, проверяет наличие файла у завершённого запуска и выводит URL первого изображения. Опрос ограничен 60 проверками с паузами по три секунды. Это решение приложения, а не гарантия времени генерации.

Если время опроса истекло, продолжите проверять тот же ID, не отправляя повторную генерацию. Сохраните ID сразу после успешного запуска. В рабочем приложении также обрабатывайте сетевые ошибки и сохраняйте ссылку на выходной файл там, где она потребуется.

Добавляйте референсы по необходимости

Текстового промпта достаточно. Обе модели изображений Grok поддерживают до трёх JPEG- или PNG-файлов в reference_images, не более 20 MB на изображение. В этом пайплайне они не принимают reference_videos. Доступные соотношения сторон: 1:1, 16:9, 9:16, 4:3 и 3:4; пример использует квадратный формат по умолчанию.

enhance_prompt: false отключает переписывание промпта перед генерацией для запроса только с текстом. Опишите объект, окружение, кадрирование и свет, затем проверьте результат перед использованием. Для более продуманной композиции обратитесь к руководству по промптам Grok Imagine. Добавляя референсы, объясните роль каждого и заново оцените стоимость изменённого запроса.