Recraft: Recraft V4 Styles Vector
Recraft V4 Styles Vector crea gráficos SVG editables a partir de una descripción textual y un estilo visual obligatorio. Es adecuado para íconos, logotipos e ilustraciones coordinados cuyo tratamiento de línea, paleta y acabado visual deban seguir la misma referencia.
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 Styles Vector es el modelo que produce SVG en la línea específica de generación con estilo coherente de Recraft. Convierte una descripción textual en nuevos gráficos vectoriales usando un estilo de referencia proporcionado para guiar el tratamiento visual, la lógica de color y la apariencia general. Resulta útil para conjuntos de íconos coordinados, ilustraciones de marca y sistemas gráficos en los que los sujetos cambian pero el tratamiento visual debe seguir siendo reconocible. La edición Vector devuelve un gráfico editable en vez de una fotografía ráster.
El fabricante identifica esta edición como recraftv4_styles_vector. Su salida siempre es SVG; los ajustes ráster de image_format no la convierten en WebP ni PNG. Cada variante vectorial admite las catorce relaciones de aspecto documentadas como proporciones entre anchura y altura, en vez de tamaños exactos en píxeles. SVG no tiene una resolución fija en píxeles, por lo que la salida 1K del modelo ráster estándar no es un tamaño de arquitectura para esta edición. Elige la forma deseada del recurso y su uso previsto a tamaño pequeño o grande al preparar la descripción.
Cada generación necesita un estilo. Utiliza entre una y diez referencias PNG, JPG o WebP, o un estilo guardado compatible en lugar de referencias nuevas. El fabricante rechaza una solicitud que combine un identificador de estilo guardado con imágenes de referencia de estilo. El límite de referencias documentado es de 64 MB en total y menos de 20 MB por archivo. Un solo ícono claro o una sola ilustración clara puede establecer el tratamiento; varias referencias son útiles cuando su grosor de línea, sus esquinas, su lógica de relleno y su paleta ya pertenecen al mismo sistema visual. Cada referencia debe tener un lado menor de al menos 256 píxeles, un lado mayor de no más de 4096 píxeles y una resolución total de no más de 16 megapíxeles.
La correspondencia flexible es la predeterminada y permite una interpretación más libre de la referencia, mientras que la precisa sigue más de cerca su tratamiento visual, color, composición e iluminación. Para un sistema vectorial, utiliza el prompt para definir el tipo de gráfico, la silueta, el número de objetos y la disposición. Para un conjunto de íconos de navegación, usa contornos gruesos y redondeados, un objeto centrado por imagen y una paleta de dos colores. Conserva el mismo estilo de referencia y cambia el objeto indicado en cada descripción, en vez de mezclar referencias sin relación para obtener variedad.
La referencia de generación permite prompts de hasta 10,000 caracteres, de una a seis salidas, una semilla aleatoria, colores preferidos y un color de fondo deseado. No se admiten prompts negativos, nombres de estilos predefinidos ni el control antiguo text_layout. Esta edición Styles tampoco proporciona image-to-image ni inpainting: una imagen de referencia aporta un lenguaje visual en vez de una región que borrar o un gráfico existente que conservar sin cambios. Las instrucciones estructurales de la descripción positiva deben definir el recurso terminado previsto.
Inspecciona el SVG al tamaño al que se utilizará, especialmente cuando el diseño contenga letras, huecos estrechos o detalles pequeños. No se garantiza la correspondencia de color con una referencia, y las referencias sin relación pueden competir entre sí. Para un conjunto de íconos que se vuelva repetitivo, cambia el objeto, la pose o la disposición en el prompt y conserva el estilo coherente. El entregable útil es un recurso vectorial consistente que pueda modificarse en forma y color en un flujo de diseño, cuya geometría y legibilidad se evalúen con respecto a la descripción.
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-styles-vector
recraft/recraft-v4-styles-vector
recraft/recraft-v4-styles-vectorInicio
Recraft V4 Styles Vector crea gráficos SVG editables a partir de una descripción textual y un estilo visual obligatorio. Es adecuado para íconos, logotipos e ilustraciones coordinados cuyo tratamiento de línea, paleta y acabado visual deban seguir la misma referencia.
- Entradas aceptadas
- Texto · Imágenes
- Resultados
- Imágenes
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Images POST /v1/images/generations
- Entrada
text,image- 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-styles-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, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto Condiciones: | Predeterminado— |
Campooutput_format | Tipostring | RequisitoOpcional | Valores y límites svg Condiciones: | Predeterminado— |
Campoinput_references | Tipoarray | RequisitoObligatorio | 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
reference_guided_image
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, prompt, input_references |
Parámetrooptional | Contraton, aspect_ratio, output_format, 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}
Tarifas
Cómo se calcula el cargo definitivo
Las tarifas mostradas permiten estimar el costo antes de la generación. El cargo final se calcula a partir del costo registrado para la generación original. La duración medida de la salida y las cantidades estimadas no son 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 fast
- Sin especificar Cuando se selecciona el modo fast
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento usa el ajuste 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 | Condiciones de facturación | Cargo |
|---|---|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cantidad prevista— | Unidad de facturación— | Condiciones 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ónReferencia de entrada | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor solicitud | Condiciones de facturaciónCreación de estilo al generar con referencias de estilo; una vez por solicitud, además del precio de las imágenes de salida. | Cargo Entrada · Referencia de entrada · Estimación solo para comparar $0.01 por solicitud Estimación solo como referencia; el cargo final se calcula según la factura original registrada. |
| Configuraciónimagen de salida | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor imagen de salida | Condiciones de facturación— | Cargo Salida · imagen de salida · Estimación solo para comparar $0.1 por imagen de salida |
| ConfiguraciónCosto estimado de generación | Tabla de tarifas— | Cantidad previstaestimación para una generación | Unidad de facturación— | Condiciones de facturación— | Cargo Salida · Costo estimado de generación · Estimación solo para comparar $0.1 estimación previa a la generación Esta estimación no es un cargo adicional ni una tarifa fija por la generación completada. |
Ailoot reserva un monto 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
: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "recraft/recraft-v4-styles-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field.", "input_references": [{"type": "image_url", "image_url": {"url": "YOUR_ACCESSIBLE_IMAGE_URL"}}]}')
p['input_references'][0]['image_url']['url']=os.environ['AILOOT_IMAGE_URL']
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 y los encabezados completos, los identificadores originales, todas las salidas reales y todos los campos de uso y contabilidad. Guarda cada recurso único que te pertenezca y conserva cada función que apunte a él.
Si es necesario revisar la respuesta original
Conserva el X-Client-Request-ID original, la respuesta y los encabezados. 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 que se devuelvan 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 los encabezados originales; consulta únicamente los registros de estado o de la biblioteca que se admitan. No vuelvas a enviar la solicitud de creación. |
Alias
Alias del modelo
Ailoot Ultra recraft/recraft-v4-styles-vector
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · Recraft: Recraft V4 Styles Vector
- ¿Qué entradas y resultados están disponibles?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:text,image→image- ¿Qué campos utiliza la solicitud?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- ¿Qué límites se aplican?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:n.minimum:1;n.maximum:6