Recraft: Recraft V4 Vector
Recraft V4 Vector crea logotipos, ilustraciones y recursos gráficos SVG editables a partir de una descripción creativa. Es la edición vectorial estándar de V4, con geometría escalable, referencias de estilo opcionales y un flujo image-to-image documentado por separado.
Sobre el modelo
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
Recraft V4 Vector es la edición estándar de Recraft V4 que produce SVG. Está diseñada para gráficos que dependen de formas claras, regiones de color y composición, incluidos logotipos, sistemas de iconos e ilustraciones. El fabricante describe V4 como una familia orientada al diseño con una sólida interpretación de prompts en trabajos tanto ráster como vectoriales. El entregable de esta edición es un gráfico SVG editable que puede ajustarse en un flujo de diseño, en vez de un mapa de bits PNG o WebP.
El modelo exacto es recraftv4_vector, independiente de V4 Pro Vector y de las variantes ráster V4. La guía de tamaños del fabricante permite catorce proporciones entre anchura y altura para la salida vectorial e indica expresamente que SVG no tiene dimensiones fijas en píxeles. Selecciona la forma del recurso mediante una relación de aspecto y elige después su ubicación y tamaño de visualización en el diseño final. La etiqueta 1K del modelo ráster V4 no define la resolución de esta variante SVG.
Las indicaciones vectoriales de V4 recomiendan definir el tipo de gráfico, la lógica de formas, el sistema de color, las reglas de línea y la disposición. Para un icono pequeño, indica el objeto y la silueta que lo hace reconocible. Para un sistema de ilustraciones, mantén estables las reglas de línea y relleno entre descripciones. Para un icono de reparto, solicita una furgoneta de contorno con esquinas redondeadas, una gran forma de paquete y una paleta contenida, centrada en una composición cuadrada. Describe la geometría en vez de añadir detalles de superficie fotográficos cuando el resultado previsto sea un gráfico plano.
La generación admite prompts de hasta 10 000 caracteres, una semilla aleatoria, de una a seis imágenes y controles de colores preferidos y de fondo. Los estilos compatibles o las imágenes de referencia opcionales pueden guiar el lenguaje visual mediante correspondencia flexible o precisa. Una referencia no sustituye las instrucciones sobre el nuevo sujeto o la disposición. Usa un recurso claro o un conjunto coherente de referencias; no se garantiza la correspondencia exacta de color con una referencia. Para generar con un estilo de referencia, utiliza de una a diez imágenes PNG, JPG o WebP, con un máximo de 64 MB en total y menos de 20 MB cada una. Cada referencia necesita un lado menor de al menos 256 píxeles, un lado mayor de no más de 4096 píxeles y una resolución de no más de 16 megapíxeles. Usa estas referencias o un estilo guardado compatible, en vez de ambos.
Un flujo image-to-image independiente puede utilizar un modelo vectorial V4 para producir SVG a partir de una imagen existente y una petición textual de cambio. El ajuste obligatorio strength va de 0 a 1: los valores menores se mantienen más cerca del original, mientras que los mayores permiten más cambios. La operación admite PNG, JPG, WebP o SVG dentro de los límites documentados de tamaño y resolución y no acepta controles de estilo V4. Esta distinción importa al elegir si una imagen debe aportar el contenido que transformar o solo el tratamiento visual de un recurso nuevo. Para image-to-image, proporciona PNG, JPG, WebP o SVG de menos de 20 MB, no más de 16 megapíxeles y con ambos lados entre 256 y 4096 píxeles.
La referencia actual de generación V4 excluye los nombres de estilos predefinidos, negative_prompt, text_layout, artistic_level y no_text. Incluye la estructura y las palabras previstas en la descripción positiva. Para un logotipo o un resultado de lettering, inspecciona el SVG a tamaños pequeños y grandes para comprobar el espaciado, la legibilidad y los detalles no deseados. Especifica explícitamente la jerarquía tipográfica y las formas geométricas, y después termina y coloca el recurso vectorial según la descripción del diseño.
A través de Ailoot, selecciona el ID exacto de este modelo en /v1/images/generations y proporciona el prompt creativo. Conserva todas las entradas de data devueltas, tanto si la respuesta contiene una URL como contenido de imagen codificado, y guarda los bytes reales con el tipo de contenido devuelto. Mantén usage y cualquier task_id de medios junto con el recurso, y revisa después sus formas, letras y regiones de color en el diseño previsto.
Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-vector
recraft/recraft-v4-vectorPrimeros pasos
Recraft V4 Vector crea logotipos, ilustraciones y recursos gráficos SVG editables a partir de una descripción creativa. Es la edición vectorial estándar de V4, con geometría escalable, referencias de estilo opcionales y un flujo image-to-image documentado por separado.
- Entradas aceptadas
- Texto · Imágenes
- Resultados
- Imágenes
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Images POST /v1/images/generations
- Tipos de entrada
text,image- Tipos de salida
image- Formato de salida
- Archivo de imagen
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites recraft/recraft-v4-vector Condiciones: Usa exactamente este selector de enrutamiento de Ailoot. | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites Condiciones: | Predeterminado— |
Campon | Tipointeger | RequisitoOpcional | Valores y límites Mínimo: 1 Máximo: 6 Condiciones: | Predeterminado— |
Campoaspect_ratio | Tipostring | RequisitoOpcional | Valores y límites 1:1, 4:3, 3:4, 16:9, 9:16, auto Condiciones: | Predeterminado— |
Campooutput_format | Tipostring | RequisitoOpcional | Valores y límites svg Condiciones: | Predeterminado— |
Campoinput_references | Tipoarray | RequisitoOpcional | Valores y límites Condiciones: | Predeterminado— |
Campoquality | Tipostring | RequisitoOpcional | Valores y límites auto, low, medium, high, xhigh, max Condiciones: | Predeterminado— |
Combinaciones de materiales de entrada
Texto a imagen
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, prompt |
Parámetrooptional | Contraton, aspect_ratio, output_format, input_references, quality |
Parámetromaterial_types | Contratotext, image |
Parámetroconditions | ContratoUsa exactamente este selector de enrutamiento de Ailoot., quality es un control común documentado; los proveedores que no ofrecen un ajuste de calidad lo ignoran. No se promete una mejora de calidad para cada modelo. |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · El task_id realmente devuelto o el registro seleccionado de la biblioteca; operation_id es un identificador independiente.
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Planes
Cómo se calcula el cargo definitivo
Las tarifas mostradas estiman el coste antes de la generación. El cargo final se calcula a partir del coste registrado para la generación original. La duración medida del resultado y las cantidades previstas no constituyen la cantidad facturable final.
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
- Modo rápido
- Sin especificar Cuando se selecciona el modo rápido
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (default)
Tarifas estimadas para comparar
Precios por configuración
Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.
| Configuración | Tabla de tarifas | Cantidad prevista | Unidad de facturación | Cargo |
|---|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cantidad prevista— | Unidad de facturación— | Cargo Entrada · Tokens de entrada · Estimación solo para comparar — / 1K tokens Salida · Tokens de salida · Estimación solo para comparar — / 1K tokens Entrada · Lectura de caché · Estimación solo para comparar — / 1K tokens Entrada · Escritura en caché · Estimación solo para comparar — / 1K tokens Entrada · Escritura en caché, 1 hora · Estimación solo para comparar — / 1K tokens |
| Configuraciónimagen de salida | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor imagen de salida | Cargo Salida · imagen de salida · Estimación solo para comparar $0.16 por imagen de salida |
| ConfiguraciónCoste estimado de generación | Tabla de tarifas— | Cantidad previstaestimación para una generación | Unidad de facturación— | Cargo Salida · Coste estimado de generación · Estimación solo para comparar $0.16 estimación previa a la generación Esta estimación no es un cargo adicional ni una tarifa fija para la generación completada. |
Ailoot reserva un importe estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
Solicitudes de ejemplo
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "recraft/recraft-v4-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field."}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Recibir y guardar resultados
Ailoot Ultra · Images
Descarga cada imagen recibida o guarda su contenido Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Conserva todos los resultados completados
Guarda todas las imágenes completadas; descarga cada URL recibida o decodifica su contenido Base64.
Conserva la respuesta completa y sus cabeceras, los identificadores originales, todos los resultados reales y todos los campos de uso y contabilidad. Guarda cada recurso único bajo tu titularidad y conserva todas las funciones que apuntan a él.
Si es necesario revisar la respuesta original
Conserva el X-Client-Request-ID original, la respuesta y las cabeceras. Un resultado desconocido o result_pending_check no autoriza una segunda creación.
Campos de respuesta
| Campo | Tipo |
|---|---|
Campodata[].url | Tipostring |
Campodata[].b64_json | Tipostring |
Campousage | Tipoobject |
Errores y siguientes pasos
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta400 · invalid_request_error | CondiciónUn campo obligatorio, el selector de modelo, el tipo o la representación de la entrada no son válidos. | Siguiente pasoRevisa los detalles de validación devueltos antes de preparar una solicitud independiente. |
Respuesta | CondiciónLa solicitud original o su resultado son desconocidos o requieren una comprobación. | Siguiente pasoConserva los identificadores y las cabeceras originales; consulta únicamente los registros de estado o de la biblioteca admitidos. No vuelvas a enviar la solicitud de creación. |
Alias
Alias del modelo
Ailoot Ultra recraft/recraft-v4-vector
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · Recraft: Recraft V4 Vector
- ¿Qué entradas y resultados están disponibles?
POST /v1/images/generations·recraft/recraft-v4-vector:text,image→image- ¿Qué campos utiliza la solicitud?
POST /v1/images/generations·recraft/recraft-v4-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- ¿Qué límites se aplican?
POST /v1/images/generations·recraft/recraft-v4-vector:n.minimum:1;n.maximum:6