Variaciones de imagen
Una sola imagen generada rara vez es la definitiva: es un punto de partida que quiere explorar en varias direcciones a la vez. Este endpoint toma un prompt de texto y devuelve un conjunto de imágenes distintas para él, cada una una versión fresca de la misma descripción, dándole opciones para elegir en vez de un único resultado fijo.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
El problema real: elegir, no producir, una sola imagen
La mayor parte del trabajo creativo no se traba en producir una sola imagen, se traba en no saber cuál imagen es la correcta. Describe un banner y le gusta la idea, pero quiere verlo de varias formas —luz más cálida, un ángulo distinto, un fondo más cargado— antes de comprometerse. Correr el mismo prompt una vez es una sola tirada de dados. Este endpoint le da varias a la vez desde la misma descripción, así elige entre opciones reales en lugar de regenerar de a una.
Qué envía y qué recibe
Envía un prompt de texto que describe la imagen que quiere, junto con cuántas variaciones desea, y la tarea devuelve esa cantidad de imágenes distintas cuando termina la generación. Cada una sigue la misma descripción mientras difiere en los detalles específicos que una nueva generación cambia de forma natural, y los resultados se entregan por webhook o por un enlace firmado como tarea asíncrona.
Por qué varias versiones superan a una sola generación
Generar una única imagen desde un prompt lo compromete con lo que produjo esa sola tirada; pedir varias variaciones del mismo prompt reparte el resultado en un conjunto que puede comparar lado a lado. Como el texto solo describe lo que cabe en palabras, la primera imagen que produce un prompt rara vez es exactamente lo que imaginaba: ver varias candidatas para la misma descripción es la vía más rápida de encontrar la que coincide con lo que tenía en mente.
Dónde encaja en un flujo de trabajo
Como es asíncrono, este endpoint encaja de forma natural en cualquier paso de generación: envía un prompt, pide un conjunto de variaciones, y el webhook las entrega cuando están listas, sin que nadie espere frente a un ícono de carga. Los equipos lo usan para pruebas A/B de creatividades, para darle al usuario final un paso de elegir su favorita dentro de un flujo de personalización, o para explorar una dirección antes de comprometerse con una pieza final.
Lo que las variaciones sí y no hacen
Las variaciones amplían las opciones de un prompt; no garantizan un cambio específico solicitado, así que si necesita una edición precisa —quitar un objeto, cambiar un texto exacto— una herramienta de edición dirigida es mejor opción. Trate este endpoint como una forma de ampliar rápidamente sus opciones a partir de una única descripción, no como una manera controlada de aplicar una modificación exacta.
Qué puede hacer con ella
Pruebas A/B creativas
Un equipo de marketing genera varias variaciones de un banner principal a partir de un prompt aprobado y prueba cuál versión rinde mejor en una campaña.
Exploración de dirección con el cliente
Un estudio de diseño muestra al cliente un puñado de variaciones de un concepto aprobado en lugar de rehacer todo el brief en cada ronda de retroalimentación.
Flujos donde el usuario elige su favorita
Una app de impresión bajo demanda deja que el comprador describa un diseño y genere varias variaciones de él para elegir la que más le gusta antes de ordenar.
Expandir un conjunto limitado de piezas
Un equipo pequeño convierte un solo prompt en una familia de visuales relacionados para usar en distintas páginas y formatos.
Preguntas frecuentes
¿Cómo genero variaciones de imagen con la api?
Envía un POST a /image/variations con un prompt de texto y la cantidad de variaciones que quiere; recibe un task_id y los resultados llegan por webhook o por un enlace firmado.
¿Qué tan parecidas son las variaciones entre sí?
Todas siguen el mismo prompt mientras varían detalles específicos, así que espere una familia de imágenes relacionadas, no casi duplicados ni escenas nuevas sin relación.
¿Puedo pedir un número exacto de variaciones?
Sí, especifica cuántas variaciones quiere en la solicitud y recibe esa misma cantidad de resultados en la tarea completada.
¿Es lo mismo que generar una imagen desde un prompt?
Usa la misma generación de texto a imagen, pero en vez de una imagen devuelve varias versiones distintas del mismo prompt en una sola solicitud, para que pueda comparar y elegir. Ambas parten de sus palabras; esta le da opciones.
¿Hay un plan gratuito para la api de variaciones de imagen?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Cuánto cuestan las variaciones de imagen?
$0.002 por solicitud más $0.0065 por imagen, y solo se cobran las variaciones que efectivamente se entregan.
¿Qué pasa si la tarea de variación falla?
Reintenta automáticamente hasta tres veces; si aun así no puede completarse, recibe un error claro y nunca se cobra el intento fallido.
¿Puedo usar esto para hacer una edición precisa, como quitar un objeto?
No de forma confiable: las variaciones reinterpretan la descripción en general en lugar de aplicar un cambio dirigido, así que una edición precisa necesita una herramienta de edición dedicada.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/image/variations \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt":"un gato naranja"}'const res = await fetch("https://api.kit.forhosting.com/image/variations", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"prompt": "un gato naranja"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/image/variations",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"prompt": "un gato naranja"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/variations", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"prompt":"un gato naranja"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"prompt":"un gato naranja"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/variations", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"prompt": "un gato naranja"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "image.variations",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_mb | 15 |
max_megapixels | 12 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
422 | task_failed | La tarea falló tras 3 reintentos. No se cobra. |