Introducción
Qué hace este endpoint
Genera un SVG a partir de un prompt de texto con Ideogram Vector 1.0. El archivo está formado por trazados y degradados, por lo que se puede escalar a cualquier tamaño y abrir como formas editables.
Entradas principales
prompt describe el diseño. quality permite elegir low, medium o high. aspect_ratio define la forma del lienzo entre 17 relaciones de aspecto. reference_image_urls es opcional: hasta cinco imágenes para orientar el estilo.
Qué recibes
Un archivo .svg por solicitud (MIME image/svg+xml).
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Salida | Imagen |
| Entrada para vectorizar | JPEG, PNG o WebP, hasta 50 MB |
| Longitud del prompt | Hasta 9,500 caracteres |
| Imágenes de referencia | Hasta 5 para diseños generados |
Funciones y aspectos destacados
Un retrato de café reconstruido con formas de color plano
Vectorizamos una foto de 1024×1536 con detailed. El SVG tenía unos 2,000 trazados y 580 degradados: el cabello, el tejido y la luz de la ventana se convirtieron en áreas de color posterizado que conservan la escena original, en un archivo de unos 2 MB.
Un ícono PNG plano se convierte en 17 trazados limpios
Un ícono de taza de café exportado en PNG se convirtió en un SVG de 6 KB cuyos contornos, curvas de vapor y emblema de hoja coinciden con el mapa de bits. Cada forma es un trazado independiente: basta un clic en un editor vectorial para cambiar su color.
simple une las formas pequeñas
A la izquierda está el original; al centro, la vectorización con simple; a la derecha, con detailed. simple redujo los trazados de unos 2,000 a menos de 1,000 y el archivo de 2 MB a 1.1 MB. Los bordes del cabello y del suéter se convirtieron en bloques más amplios.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Describe el tema, el estilo (plano, dibujo de líneas, geométrico), los colores y el texto que quieres incluir. mínimo 1 caracteres · máximo 9500 caracteres |
quality | No | low, medium (predeterminado) o high. Los niveles superiores agregan detalle y tardan más; cada uno tiene su propio precio por SVG. |
aspect_ratio | No | Forma del lienzo vectorial: de 1:4 vertical a 4:1 horizontal; el valor predeterminado es 1:1. |
reference_image_urls | No | Opcional: hasta cinco imágenes JPEG, PNG o WebP de hasta 10 MB cada una, como referencia de estilo y composición. La primera tiene más peso. máximo 5 elementos |
Precios
Cada SVG terminado se cobra una sola vez según su nivel de calidad. Las imágenes de referencia solo aumentan la tarifa con high. Las solicitudes fallidas o que no generan un SVG no se cobran.
| With references | Calidad: low | Calidad: medium | Calidad: high |
|---|---|---|---|
| $0.174 / imagen | $0.216 / imagen | $0.264 / imagen |
| $0.174 / imagen | $0.216 / imagen | $0.432 / imagen |
Casos de uso
Logos y símbolos de marca con texto
Pide un símbolo con un nombre corto y conserva las letras como contornos vectoriales que se ven nítidos en una tarjeta de presentación o un letrero.
Recupera un logo de baja resolución
Convierte un logo antiguo en PNG o JPEG a SVG para imprimirlo en grande, cambiar sus colores o enviarlo a una imprenta.
Pósters, calcomanías y archivos de corte
Genera un póster o una calcomanía con formas vectoriales, o vectoriza diseños para cortadoras de vinilo, grabadoras láser y programas de bordado que requieren vectores.
Guía de prompts y consejos prácticos
Elige qué quieres hacer
Envía prompt para un diseño nuevo (text-to-image) o
image_urlpara vectorizar una imagen existente (edit). Las solicitudes conimage_urlse dirigen automáticamente a vectorización.Elige los ajustes
Para un diseño nuevo, elige quality y
aspect_ratioy, si quieres, hasta cinco imágenes de referencia. Para vectorizar, eligedetail_level: detailed o simple.Descarga el SVG
Consulta el estado de la tarea y descarga el .svg del almacenamiento de la plataforma. Ábrelo en Figma, Illustrator o Inkscape para editar los trazados y rellenos de inmediato.
Introducción
La función de texto a SVG de Ideogram Vector 1.0 crea un archivo vectorial nuevo a partir de una descripción. Está pensada para logos, emblemas, pósters, calcomanías e ilustraciones simples que deben verse nítidos a cualquier tamaño.
Funciones y ventajas
Salida vectorial nativa
El modelo devuelve elementos de trazado y degradado, sin una imagen dentro de un contenedor SVG. Ábrelo en Figma, Illustrator o Inkscape y podrás seleccionar cada forma.
Letras legibles
Ideogram es conocido por su tipografía. En nuestras pruebas, textos cortos como FOXTROT y NORTH SHORE se escribieron correctamente y se integraron en la composición.
Tres niveles y 17 relaciones de aspecto
low sirve para borradores rápidos, medium para la mayoría de los trabajos y high para obtener más detalle. El lienzo va de 1:4 vertical a 4:1 horizontal.
Usos
Crea un símbolo de marca
Genera varias propuestas de logo y perfecciona la que elijas en un editor vectorial.
Pósters para eventos y tiendas
Crea un póster con un título que puedas imprimir en A2 sin que se pixele.
Calcomanías y productos promocionales
Crea diseños para corte de vinilo, serigrafía o bordado que requieren archivos vectoriales.
Guía de prompts y consejos
Describe el estilo con claridad
Palabras como plano, geométrico, dibujo de líneas, dos colores o emblema ayudan al modelo a mantener las formas simples y editables.
Escribe el texto entre comillas o en mayúsculas
Indica exactamente el texto que quieres incluir y limítalo a pocas palabras.
Indica los colores
No hay un control de paleta; enumera los colores en el prompt, por ejemplo azul marino y durazno.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "ideogram/vector-1/text-to-image",
"input": {
"aspect_ratio": "1:1",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
