Introducción
Qué hace este endpoint
Envía un prompt a Recraft V4 y devuelve un SVG nativo.
Entradas importantes
prompt (hasta 10,000 caracteres) describe el diseño. aspect_ratio elige una de siete formas de lienzo; el valor predeterminado es 1:1.
Qué recibes
Un archivo .svg (MIME image/svg+xml) formado por trazados.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Salida | Imagen |
| Longitud del prompt | Hasta 10,000 caracteres |
| Relaciones de aspecto | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 |
Funciones y aspectos destacados
Un zorro y un distintivo de panadería, ambos editables
Izquierda: un símbolo de zorro de dos colores formado por 18 figuras. Derecha: un distintivo de panadería de estilo vintage con el nombre Rise & Crumb y espigas de trigo alrededor, formado por 124 figuras en crema y café. Ambos se abrieron en un editor vectorial con todos los elementos seleccionables.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Indica el tema, el formato (símbolo de logo, distintivo, ilustración plana), la paleta y cualquier nombre del logo entre comillas. mínimo 1 caracteres · máximo 10000 caracteres |
aspect_ratio | No | 1:1 (predeterminado), 4:3, 3:4, 3:2, 2:3, 16:9 o 9:16. Define las proporciones del lienzo del SVG; la proporción no cambia el precio. |
Precios
$0.096 / SVG
Una tarifa fija por cada SVG entregado, sin importar la proporción del lienzo. Las solicitudes fallidas y los resultados vacíos no tienen costo.
Casos de uso
Exploración de logos
Genera varios símbolos para un producto o una tienda nueva y termina el mejor en un editor vectorial.
Ilustración editorial plana
Crea ilustraciones de apoyo para blogs, páginas de destino y presentaciones que conserven su nitidez en cualquier pantalla.
Gráficos listos para imprimir
Crea distintivos, etiquetas y diseños para empaques como vectores que una imprenta pueda ampliar sin perder calidad.
Guía de prompts y consejos prácticos
Describe el diseño
Describe el tema, el estilo (símbolo de logo, distintivo, ilustración plana) y los colores. Pon entre comillas cualquier nombre o texto del logo.
Elige una proporción
Elige
aspect_ratio: 1:1 funciona bien para símbolos y distintivos; 3:2 o 16:9, para escenas y banners.Edita el SVG
Descarga el archivo .svg y ábrelo en Figma, Illustrator o Inkscape para ajustar los colores, el espaciado y las letras.
Introducción
Recraft V4 Vector convierte una descripción escrita en un archivo SVG. Recraft creó V4 para diseñadores, con atención a la composición, el color y la geometría limpia. Este endpoint utiliza su modo vectorial.
Funciones y aspectos destacados
Geometría limpia y en capas
Las formas son trazados independientes, así que puedes cambiar el color de la oreja de un zorro o mover la cinta de un distintivo sin volver a dibujar nada.
Paletas que se respetan
En nuestras pruebas, el modelo siguió de cerca las paletas indicadas en el prompt, como verde azulado y coral o crema y café.
Nombres integrados en el diseño
Los nombres cortos, como Rise & Crumb, se dibujan como parte de la imagen.
Casos de uso
Bocetos de identidad de marca
Explora símbolos y distintivos para un negocio nuevo antes de entregar el mejor a un diseñador.
Ilustraciones para sitios web y apps
Crea ilustraciones principales y para estados vacíos que se vean nítidas en cualquier pantalla.
Empaques y etiquetas
Dibuja diseños para etiquetas que puedan ampliarse para impresión.
Guía de prompts y consejos prácticos
Empieza por el formato
Comienza con símbolo de logo, emblema, distintivo o ilustración plana para que el modelo defina el nivel de detalle adecuado.
Mantén los símbolos sencillos
Para logos, pide formas planas o geométricas y dos o tres colores.
Revisa las letras
Comprueba la ortografía y el espaciado, y ajusta lo necesario en un editor vectorial.
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/v4-vector/text-to-image",
"input": {
"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.
