0xsline/openchatcut

Generación de Imágenes

Genera imágenes mediante IA a través de submit_image (solo con claves de proveedor configuradas). Prefiere una imagen fija clara por solicitud a menos que el usuario haya solicitado variantes.

Selección de Modelo

Modelo	Referencia	Fortalezas	Máx. referencias
fal + falModel	references/fal.md	Catálogo explícito de Fal; consulta el esquema de la herramienta para límites por modelo	Específico del modelo
gpt-image-2	references/gpt-image-2.md	Mejor renderizado de texto, mejor adherencia al prompt	16
nano-banana	references/nano-banana.md	Máxima fidelidad a la imagen de referencia	14
image-01	references/image-01.md	Estilo estático/animado MiniMax; una referencia de sujeto vía R2	1
grok-imagine	references/grok-imagine.md	xAI Grok Imagine; texto a imagen, ≤4 salidas, 1K/2K	0

• Si se selecciona Fal.ai o el usuario lo solicita, usa model: "fal" y el falModel solicitado o el valor por defecto guardado de Fal en las capacidades. Pregunta si no se ha seleccionado ninguno. Los controles y valores por defecto de los proveedores nativos a continuación no aplican para Fal.
• Por defecto: gpt-image-2 cuando la clave de ese proveedor está activa.
• Muchas referencias → nano-banana.
• El usuario menciona MiniMax / solo clave de imagen MiniMax activa → image-01.
• Respeta las capacidades: no invoques un modelo cuyo proveedor no esté configurado.

IMPORTANTE: Antes de generar, LEE la referencia del modelo elegido.

Parámetros de la Herramienta

Parámetro	Valores	Por defecto
aspectRatio	1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 21:9	16:9
imageSize	512px, 1K, 2K, 4K (específico del modelo)	1K
width / height	GPT Image: 512–3840, /16; MiniMax: 512–2048, /8	—
quality	low, medium, high, auto (solo gpt-image-2)	high
referenceAssetIds	Array de IDs de assets del proyecto — el backend resuelve bytes del lado del servidor	—
name	Nombre corto descriptivo del asset que se muestra en la biblioteca	—
count	Número de imágenes a generar (1–10; image-01 máximo 9)	1
promptOptimizer	Solo MiniMax image-01 — prompt_optimizer	false
seed	Solo MiniMax image-01	—
maskAssetId, background, moderation, inputFidelity	Controles de edición/salida GPT Image	—
outputFormat, outputCompression	Controles PNG/JPEG/WebP GPT Image	PNG

Valores por Defecto

• Relación de aspecto: 16:9. Si la composición del proyecto no es 16:9, PREGUNTA al usuario qué relación de aspecto quiere antes de generar.
• Tamaño: 1K.

Preguntar Antes de Enviar

• Nunca subir el tamaño automáticamente.
• Solo pasa imageSize: "2K" o "4K" cuando el usuario lo solicite explícitamente. Advierte que 2K/4K son EXPERIMENTALES y pueden ser más lentos.

Imágenes de Referencia

Úsalas cuando el usuario proporcione material fuente para editar, combinar o usar como guía visual (p. ej., "cambia el fondo", "combina esto en un cartel").

• Pasa los IDs de assets del proyecto mediante referenceAssetIds. El backend los obtiene y codifica del lado del servidor — nunca obtengas los bytes del asset tú mismo.
• Cuando el usuario haga @-referencia a un asset de imagen, pasa su ID directamente en referenceAssetIds.
• Formatos aceptados por el backend: png, jpeg, webp, svg (auto-rasterizado a png), heic, heif. Cada uno ≤ 50MB.

Ejecución

// Generación básica
submit_image({
  model: "gpt-image-2",
  prompt: "un gato naranja bonito",
  name: "Gato",
});

// Con calidad (solo gpt-image-2)
submit_image({
  model: "gpt-image-2",
  prompt: "cartel de héroe con título en negrita",
  quality: "high",
  name: "Cartel Héroe",
});

// Con imágenes de referencia — pasar IDs de assets del proyecto; el backend resuelve los bytes
submit_image({
  model: "gpt-image-2",
  prompt: "cambia el fondo a una playa",
  referenceAssetIds: ["<assetId>"],
  name: "Edición Playa",
});

// Muchas referencias con nano-banana
submit_image({
  model: "nano-banana",
  prompt: "cartel compuesto",
  referenceAssetIds: ["<id1>", "<id2>"],
  name: "Compuesto",
});

// Múltiples imágenes
submit_image({
  model: "gpt-image-2",
  prompt: "fotos de producto",
  count: 3,
  name: "Producto",
});

// MiniMax (referencia de sujeto única opcional; R2 debe estar configurado para referencias)
submit_image({
  model: "image-01",
  prompt: "botella de producto mate sobre mármol, luz suave de estudio",
  name: "Bodegón botella",
  promptOptimizer: false,
});

submit_image de OpenChatCut puede devolver assets de pool completados de forma síncrona dependiendo de la ruta del proveedor. Si se devuelve un jobId, usa track_progress; en caso contrario, trata los IDs de assets en el resultado como terminados.

Reglas

• Proporciona siempre name con un nombre corto y descriptivo del asset.
• Antes de enviar, informa brevemente al usuario de lo que estás a punto de generar — especialmente al generar múltiples imágenes.
• Solo invocar modelos cuya clave de proveedor esté configurada (capacidades del prompt).