Introducción
Qué hace este endpoint
Llama a Recraft 20B en modo SVG y devuelve un archivo vectorial.
Entradas importantes
prompt indica el tema. style selecciona uno de los 21 estilos (predeterminado: vector_illustration). aspect_ratio puede ser 1:1, 16:9, 9:16, 4:3 o 3:4.
Qué recibes
Un archivo .svg (MIME image/svg+xml).
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Salida | Imagen |
| Estilos | 21 (10 de íconos, 11 de ilustraciones) |
| Relaciones de aspecto | 1:1, 16:9, 9:16, 4:3, 3:4 |
Funciones y aspectos destacados
Un modelo, dos estilos de íconos
Izquierda: una taza de café en icon/colored_outline, con 14 trazados, contorno marrón y rellenos suaves. Derecha: un ícono de viajes con una montaña y un sol en icon/outline, con 13 trazados de líneas puras. Mantén un solo estilo para que los íconos del conjunto combinen.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Un solo tema se entiende mejor, sobre todo en íconos: una taza de café humeante o una montaña con un sol naciente. Si quieres colores específicos, indícalos con palabras. mínimo 1 caracteres · máximo 1000 caracteres |
style | No | Diez estilos de íconos (outline, |
aspect_ratio | No | 1:1 (predeterminado) para íconos; 16:9, 9:16, 4:3 o 3:4 para banners y escenas. Define la forma del lienzo SVG sin costo adicional. |
Precios
$0.053 / SVG
Cada ícono o ilustración entregado tiene una tarifa fija, sin importar el estilo o la proporción que elijas. Si la generación falla, no se cobra nada.
Casos de uso
Conjuntos de íconos para apps y sitios web
Genera íconos para menús, funciones y estados vacíos con un mismo estilo. Después, cambia los colores para adaptarlos a tu interfaz.
Gráficos rápidos para blogs y redes sociales
Crea en segundos una pequeña ilustración cartoon o kawaii para una publicación o un boletín.
Proyectos de manualidades e impresión
Usa estilos de dibujo lineal, grabado o linograbado para calcomanías, sellos, máquinas de corte y tarjetas impresas.
Guía de prompts y consejos prácticos
Elige un estilo
Elige un estilo icon/* para íconos de interfaz o vector_illustration/* para escenas; el valor predeterminado es
vector_illustration.Describe un solo tema
Los íconos funcionan mejor con un solo objeto, como una taza de café humeante o una montaña con un sol naciente.
Descarga el SVG
Consulta periódicamente el estado de la tarea, descarga el archivo .svg e incorpóralo a tu herramienta de diseño o base de código.
Introducción
Recraft 20B SVG genera íconos e ilustraciones vectoriales de forma rápida y económica. En lugar de describir un estilo con palabras, lo eliges de una lista de 21 estilos definidos.
Funciones y ventajas principales
21 estilos definidos
Los estilos de íconos incluyen outline, broken_line, colored_outline, colored_shapes, colored_shapes_gradient, doodle_fill, doodle_offset_fill, offset_fill, outline_gradient y uneven_fill. Los estilos de ilustración incluyen cartoon, doodle_line_art, engraving, flat_2, kawaii, line_art, line_circuit, linocut y seamless.
Resultados rápidos
Nuestras pruebas tardaron unos 11 segundos cada una, lo que facilita crear íconos por lotes.
Archivos pequeños
Los íconos generados pesaron 20–25 KB.
Casos de uso
Bibliotecas de íconos para productos
Genera un conjunto coherente para la navegación, los ajustes y las listas de funciones.
Ilustraciones para contenido
Agrega una imagen cartoon o kawaii a un artículo, boletín o diapositiva.
Calcomanías y sellos
Usa linograbado, grabado o dibujo lineal para impresión y máquinas de corte.
Guía de prompts y consejos prácticos
Un objeto por ícono
Los prompts cortos, como una montaña con un sol naciente, producen íconos más claros que las descripciones largas de escenas.
Mantén el estilo del conjunto
Usa el mismo valor de style para todos los íconos de un conjunto.
Evita el texto en los íconos
El modelo tiene limitaciones al generar letras; agrega las etiquetas en tu herramienta de diseño.
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": "recraft/20b-svg/text-to-image",
"input": {
"style": "vector_illustration",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1"
}
}'
# 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.
