{ "aboutHtml": "

Recraft V4.1 Pro Vector es la edición SVG Pro de la familia de generación de imágenes V4.1 de Recraft. Está diseñada para trabajos cuyo resultado deba seguir siendo un gráfico vectorial editable: un logotipo, un concepto tipográfico, un ícono o una ilustración. La presentación del fabricante de V4.1 destaca la composición deliberada y la ilustración, mientras que la referencia exacta del modelo identifica esta variante por separado de las ediciones Vector estándar, Pro ráster y Utility. Su imagen final es un SVG en vez de una exportación ráster de alta resolución.

El código de modelo del fabricante es recraftv4_1_pro_vector. La salida vectorial no tiene un tamaño fijo en píxeles; la referencia de tamaños admite catorce proporciones entre anchura y altura para modelos vectoriales y no acepta dimensiones exactas en píxeles. Por tanto, los ajustes ráster 2K de Pro no definen la resolución SVG de esta edición. Especifica la proporción prevista y cómo se utilizarán los gráficos. Para un logotipo, el entregable importante es una silueta legible y regiones de color editables que puedan ajustarse en un flujo de diseño.

El modelo admite generación text-to-image y referencias de estilo personalizado opcionales. El límite documentado del prompt es de 10,000 caracteres. Los colores preferidos, un color de fondo deseado y una semilla aleatoria pueden guiar la generación, y el flujo permite de una a seis salidas. Un estilo guardado compatible o imágenes de referencia pueden establecer un lenguaje visual; el estilo debe corresponder al modelo para el que se creó. La línea principal V4.1 no exige un estilo de referencia en cada solicitud, a diferencia de la familia específica V4 Styles. 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. Para generar con un estilo de referencia, la correspondencia flexible permite una interpretación más libre, mientras que la precisa sigue más de cerca el tratamiento visual, la paleta, la composición y la iluminación.

Una descripción vectorial útil define el tipo de gráfico, la lógica de formas, la paleta, el tratamiento de línea y la disposición antes de añadir detalles decorativos. Para un emblema de una tienda de jardinería, solicita una sola silueta de brote, geometría redondeada, dos colores planos y una composición de marca centrada. Para lettering, incluye la palabra exacta y describe su jerarquía y forma; después inspecciona el SVG devuelto para comprobar que los espacios interiores de las letras, el espaciado y la claridad a tamaño pequeño sean adecuados. Los ejemplos vectoriales del fabricante permiten tipografía expresiva e ilustración; no garantizan que cada letra o trazado generados sean ya un trabajo terminado.

Recraft documenta un flujo image-to-image independiente para modelos ráster y vectoriales V4.1. Combina una imagen existente y un prompt, con strength de 0 a 1 para controlar cuánto se aleja el nuevo resultado del original. Un strength menor se mantiene más cerca y uno mayor permite más cambios. Esa operación no admite controles de estilo personalizado V4/V4.1, por lo que la transformación de una imagen de origen y la generación con estilo de referencia deben prepararse como flujos distintos. La entrada de imagen puede ser PNG, JPG, WebP o SVG dentro de los límites documentados. 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.

V4.1 no admite nombres de estilos predefinidos ni los controles negative_prompt, text_layout, artistic_level o no_text. Especifica la disposición y las letras previstas en la descripción positiva en vez de depender de mecanismos antiguos de V3. Para un recurso de marca detallado, usa el SVG como archivo de trabajo, inspecciona la geometría y ajusta los colores o las formas según sea necesario antes de colocarlo en la disposición final. Esta edición Pro Vector conserva su propia identidad; no es intercambiable con las variantes ráster estándar o Utility solo porque compartan el nombre V4.1.

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.

", "aboutText": "Recraft V4.1 Pro Vector es la edición SVG Pro de la familia de generación de imágenes V4.1 de Recraft. Está diseñada para trabajos cuyo resultado deba seguir siendo un gráfico vectorial editable: un logotipo, un concepto tipográfico, un ícono o una ilustración. La presentación del fabricante de V4.1 destaca la composición deliberada y la ilustración, mientras que la referencia exacta del modelo identifica esta variante por separado de las ediciones Vector estándar, Pro ráster y Utility. Su imagen final es un SVG en vez de una exportación ráster de alta resolución.\n\nEl código de modelo del fabricante es recraftv4_1_pro_vector. La salida vectorial no tiene un tamaño fijo en píxeles; la referencia de tamaños admite catorce proporciones entre anchura y altura para modelos vectoriales y no acepta dimensiones exactas en píxeles. Por tanto, los ajustes ráster 2K de Pro no definen la resolución SVG de esta edición. Especifica la proporción prevista y cómo se utilizarán los gráficos. Para un logotipo, el entregable importante es una silueta legible y regiones de color editables que puedan ajustarse en un flujo de diseño.\n\nEl modelo admite generación text-to-image y referencias de estilo personalizado opcionales. El límite documentado del prompt es de 10,000 caracteres. Los colores preferidos, un color de fondo deseado y una semilla aleatoria pueden guiar la generación, y el flujo permite de una a seis salidas. Un estilo guardado compatible o imágenes de referencia pueden establecer un lenguaje visual; el estilo debe corresponder al modelo para el que se creó. La línea principal V4.1 no exige un estilo de referencia en cada solicitud, a diferencia de la familia específica V4 Styles. 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. Para generar con un estilo de referencia, la correspondencia flexible permite una interpretación más libre, mientras que la precisa sigue más de cerca el tratamiento visual, la paleta, la composición y la iluminación.\n\nUna descripción vectorial útil define el tipo de gráfico, la lógica de formas, la paleta, el tratamiento de línea y la disposición antes de añadir detalles decorativos. Para un emblema de una tienda de jardinería, solicita una sola silueta de brote, geometría redondeada, dos colores planos y una composición de marca centrada. Para lettering, incluye la palabra exacta y describe su jerarquía y forma; después inspecciona el SVG devuelto para comprobar que los espacios interiores de las letras, el espaciado y la claridad a tamaño pequeño sean adecuados. Los ejemplos vectoriales del fabricante permiten tipografía expresiva e ilustración; no garantizan que cada letra o trazado generados sean ya un trabajo terminado.\n\nRecraft documenta un flujo image-to-image independiente para modelos ráster y vectoriales V4.1. Combina una imagen existente y un prompt, con strength de 0 a 1 para controlar cuánto se aleja el nuevo resultado del original. Un strength menor se mantiene más cerca y uno mayor permite más cambios. Esa operación no admite controles de estilo personalizado V4/V4.1, por lo que la transformación de una imagen de origen y la generación con estilo de referencia deben prepararse como flujos distintos. La entrada de imagen puede ser PNG, JPG, WebP o SVG dentro de los límites documentados. 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.\n\nV4.1 no admite nombres de estilos predefinidos ni los controles negative_prompt, text_layout, artistic_level o no_text. Especifica la disposición y las letras previstas en la descripción positiva en vez de depender de mecanismos antiguos de V3. Para un recurso de marca detallado, usa el SVG como archivo de trabajo, inspecciona la geometría y ajusta los colores o las formas según sea necesario antes de colocarlo en la disposición final. Esta edición Pro Vector conserva su propia identidad; no es intercambiable con las variantes ráster estándar o Utility solo porque compartan el nombre V4.1.\n\nA 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.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "ff0e1b53dbea37c649cc6159daac40eaffacf6e1d0af7da9436fa81c91e1e2c8", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es-mx", "methods": [ { "html": "
•

Recraft: Recraft V4.1 Pro Vector

Otros /recraft/recraft-v4.1-pro-vector

Inicio

Recraft V4.1 Pro Vector crea gráficos SVG editables para logotipos, lettering e ilustraciones detalladas. Es la edición vectorial Pro de la familia V4.1, que combina prompts de texto con entradas opcionales de imagen y estilo conservando un entregable vectorial.

Entradas aceptadas
Texto · Imágenes
Resultados
Imágenes
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.1 Pro Vector es la edición SVG Pro de la familia de generación de imágenes V4.1 de Recraft. Está diseñada para trabajos cuyo resultado deba seguir siendo un gráfico vectorial editable: un logotipo, un concepto tipográfico, un ícono o una ilustración. La presentación del fabricante de V4.1 destaca la composición deliberada y la ilustración, mientras que la referencia exacta del modelo identifica esta variante por separado de las ediciones Vector estándar, Pro ráster y Utility. Su imagen final es un SVG en vez de una exportación ráster de alta resolución.

El código de modelo del fabricante es recraftv4_1_pro_vector. La salida vectorial no tiene un tamaño fijo en píxeles; la referencia de tamaños admite catorce proporciones entre anchura y altura para modelos vectoriales y no acepta dimensiones exactas en píxeles. Por tanto, los ajustes ráster 2K de Pro no definen la resolución SVG de esta edición. Especifica la proporción prevista y cómo se utilizarán los gráficos. Para un logotipo, el entregable importante es una silueta legible y regiones de color editables que puedan ajustarse en un flujo de diseño.

El modelo admite generación text-to-image y referencias de estilo personalizado opcionales. El límite documentado del prompt es de 10,000 caracteres. Los colores preferidos, un color de fondo deseado y una semilla aleatoria pueden guiar la generación, y el flujo permite de una a seis salidas. Un estilo guardado compatible o imágenes de referencia pueden establecer un lenguaje visual; el estilo debe corresponder al modelo para el que se creó. La línea principal V4.1 no exige un estilo de referencia en cada solicitud, a diferencia de la familia específica V4 Styles. 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. Para generar con un estilo de referencia, la correspondencia flexible permite una interpretación más libre, mientras que la precisa sigue más de cerca el tratamiento visual, la paleta, la composición y la iluminación.

Una descripción vectorial útil define el tipo de gráfico, la lógica de formas, la paleta, el tratamiento de línea y la disposición antes de añadir detalles decorativos. Para un emblema de una tienda de jardinería, solicita una sola silueta de brote, geometría redondeada, dos colores planos y una composición de marca centrada. Para lettering, incluye la palabra exacta y describe su jerarquía y forma; después inspecciona el SVG devuelto para comprobar que los espacios interiores de las letras, el espaciado y la claridad a tamaño pequeño sean adecuados. Los ejemplos vectoriales del fabricante permiten tipografía expresiva e ilustración; no garantizan que cada letra o trazado generados sean ya un trabajo terminado.

Recraft documenta un flujo image-to-image independiente para modelos ráster y vectoriales V4.1. Combina una imagen existente y un prompt, con strength de 0 a 1 para controlar cuánto se aleja el nuevo resultado del original. Un strength menor se mantiene más cerca y uno mayor permite más cambios. Esa operación no admite controles de estilo personalizado V4/V4.1, por lo que la transformación de una imagen de origen y la generación con estilo de referencia deben prepararse como flujos distintos. La entrada de imagen puede ser PNG, JPG, WebP o SVG dentro de los límites documentados. 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.

V4.1 no admite nombres de estilos predefinidos ni los controles negative_prompt, text_layout, artistic_level o no_text. Especifica la disposición y las letras previstas en la descripción positiva en vez de depender de mecanismos antiguos de V3. Para un recurso de marca detallado, usa el SVG como archivo de trabajo, inspecciona la geometría y ajusta los colores o las formas según sea necesario antes de colocarlo en la disposición final. Esta edición Pro Vector conserva su propia identidad; no es intercambiable con las variantes ráster estándar o Utility solo porque compartan el nombre V4.1.

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.

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
CampoTipoRequisitoValores y límitesPredeterminado
CampomodelTipostringRequisitoObligatorioValores y límites
recraft/recraft-v4.1-pro-vector
Condiciones: Usa exactamente este selector de enrutamiento de Ailoot.
Predeterminado—
CampopromptTipostringRequisitoObligatorioValores y límites
Condiciones:
Predeterminado—
CamponTipointegerRequisitoOpcionalValores y límites
Mínimo: 1
Máximo: 6
Condiciones:
Predeterminado—
Campoaspect_ratioTipostringRequisitoOpcionalValores y límites
1:1, 4:3, 3:4, 16:9, 9:16, auto
Condiciones:
Predeterminado—
Campooutput_formatTipostringRequisitoOpcionalValores y límites
svg
Condiciones:
Predeterminado—
Campoinput_referencesTipoarrayRequisitoOpcionalValores y límites
Condiciones:
Predeterminado—
CampoqualityTipostringRequisitoOpcionalValores 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ámetroContrato
Parámetrocontent_typeContratoapplication/json
ParámetrorequiredContratomodel, prompt
ParámetrooptionalContraton, aspect_ratio, output_format, input_references, quality
Parámetromaterial_typesContratotext, image
ParámetroconditionsContratoUsa 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ónTabla de tarifasCantidad previstaUnidad de facturaciónCargo
ConfiguraciónTarifas base por tokenTabla de tarifasTarifa baseCantidad 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 salidaTabla de tarifas—Cantidad prevista—Unidad de facturaciónpor imagen de salidaCargo
Salida · imagen de salida · Estimación solo para comparar $0.6 por imagen de salida
ConfiguraciónCosto estimado de generaciónTabla de tarifas—Cantidad previstaestimación para una generaciónUnidad de facturación—Cargo
Salida · Costo estimado de generación · Estimación solo para comparar $0.6 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\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "recraft/recraft-v4.1-pro-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field."}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\n

Recibir y guardar resultados

Ailoot Ultra · Images

Descarga cada imagen recibida o guarda su contenido Base64

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
CampoTipo
Campodata[].urlTipostring
Campodata[].b64_jsonTipostring
CampousageTipoobject
Errores y siguientes pasos
RespuestaCondiciónSiguiente paso
Respuesta400 · invalid_request_errorCondició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.
RespuestaCondició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.1-pro-vector

Alias de rutas de métodos

Usa las rutas de método indicadas arriba.

ID de modelo relacionados

recraft/recraft-v4.1-pro-vector

", "method_identity": { "effective_request_model_id": "recraft/recraft-v4.1-pro-vector", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "recraft/recraft-v4.1-pro-vector", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|recraft%2Frecraft-v4.1-pro-vector", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response and headers, original identifiers, every actual output and all usage/accounting fields. Save each unique owned asset and retain every role pointing to it.", "authentication": { "header": "Authorization", "scheme": "Bearer", "value": "$AILOOT_API_KEY" }, "control_semantics": { "other_documented_controls": "Source generic image parsing preserves request JSON. Additional documented controls stay subject to the exact model; missing DTO fields do not create Source refusals.", "quality": "The saved common image schema documents this control and says providers without a quality knob ignore it.", "style": "Selected generic Source passes JSON fields through but the saved dedicated image request schema does not declare a style field. Its omission here is not a Source ban or a supported per-model promise." }, "errors": [ { "condition": "Un campo obligatorio, el selector de modelo, el tipo o la representación de la entrada no son válidos.", "http_status": 400, "recovery": "Revisa los detalles de validación que se devuelvan antes de preparar una solicitud independiente.", "type": "invalid_request_error" }, { "condition": "La solicitud original o su resultado son desconocidos o requieren una comprobación.", "http_status": null, "recovery": "Conserva 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.", "type": null } ], "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned signed URL; never construct a token." }, "status": [ { "http": "GET", "id_source": "actual returned task_id or selected library record; operation_id is a separate identifier", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "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.", "unknown_no_replay": true }, "material_combinations": [ { "materials": [ "text", "image" ], "metadata_authority": "saved_model_discovery_union", "mode": "text_to_image", "reference_maximum": 1, "reference_minimum": 0 } ], "model_parameter_metadata": { "authority": "saved_model_discovery_union", "defaults_not_inferred": { "aspect_ratio": null, "exact_pixels": null, "explanation": "No universal/model default inferred. Omitted output_format uses provider default; dimensions are provider-derived, observed Ming2048 is not a universal default.", "n": null, "output_format": null, "quality": null, "resolution": null }, "known_parameter_choices": { "aspect_ratio": { "type": "enum", "values": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ] }, "input_references": { "max": 1, "min": 0, "type": "range" }, "n": { "max": 6, "min": 1, "type": "range" }, "output_format": { "type": "enum", "values": [ "svg" ] } }, "pointer": "/profiles/36", "scope": "Exact saved model metadata. Discovery unions are identified explicitly and are not represented as definitive selected-provider bounds." }, "outputs": { "all_results": "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.", "documented_formats": [ "svg" ], "every_actual_output": true, "family": "image", "fields": [ { "name": "data[].url", "type": "string" }, { "name": "data[].b64_json", "type": "string" }, { "name": "usage", "type": "object" } ], "format": "The exact saved model metadata lists SVG. Preserve the actual returned MIME and unchanged vector bytes; keep every actual output and owned signed image link." }, "parameters": [ { "conditions": "Usa exactamente este selector de enrutamiento de Ailoot.", "default_known": false, "enum": [ "recraft/recraft-v4.1-pro-vector" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "name": "prompt", "required": true, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "maximum": 6, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "conditions": "", "default_known": false, "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "conditions": "", "default_known": false, "enum": [ "svg" ], "enum_known": true, "name": "output_format", "required": false, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "minItems": 0, "name": "input_references", "required": false, "type": "array" }, { "conditions": "", "default_known": false, "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "enum_known": true, "name": "quality", "required": false, "type": "string" } ], "request_schema": { "additionalProperties": true, "properties": { "aspect_ratio": { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "minItems": 0, "type": "array" }, "model": { "enum": [ "recraft/recraft-v4.1-pro-vector" ], "type": "string" }, "n": { "maximum": 6, "minimum": 1, "type": "integer" }, "output_format": { "enum": [ "svg" ], "type": "string" }, "prompt": { "type": "string" }, "quality": { "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "recraft/recraft-v4.1-pro-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field." }, "content_type": "application/json", "example_is_offline_content": true }, "usage": { "meter": "Use the accepted method price and actual recorded usage; the request reserve is an estimate. A billing unit does not add an input capability.", "preserve": "Keep all returned usage, accounting and request identifiers with every actual output.", "settlement": "Retain the original operation; reconcile its result and accounting once." } }, "input": { "conditions": [ "Usa 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." ], "content_type": "application/json", "material_types": [ "text", "image" ], "optional": [ "n", "aspect_ratio", "output_format", "input_references", "quality" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned signed URL; never construct a token." }, "status": [ { "http": "GET", "id_source": "El task_id realmente devuelto o el registro seleccionado de la biblioteca; operation_id es un identificador independiente.", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the original X-Client-Request-ID, response and headers. An unknown or result_pending_check outcome does not authorize a second creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "output": { "all_results": "Retain the complete response and headers, original identifiers, every actual output and all usage/accounting fields. Save each unique owned asset and retain every role pointing to it.", "documented_formats": [ "svg" ], "every_actual_output": true, "family": "image", "fields": [ { "name": "data[].url", "type": "string" }, { "name": "data[].b64_json", "type": "string" }, { "name": "usage", "type": "object" } ], "format": "The saved exact model metadata lists SVG. Preserve actual MIME and bytes; storage MIME support alone does not prove completion of the full selected generic output path." } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per output image" }, "label": "output image", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "Esta estimación no es un cargo adicional ni una tarifa fija por la generación completada.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Costo estimado de generación", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{\"model\": \"recraft/recraft-v4.1-pro-vector\", \"prompt\": \"A portrait of an Asian woman with neon green lights in the background, shallow depth of field.\"}')\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "images", "http": "POST", "in": null, "input": [ "text", "image" ], "input_conditions": { "image": "Use the exact model reference-input range in the saved model metadata; a reference becomes required only for the models whose listed minimum is positive." }, "label": "Images", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "image" ], "path": "/v1/images/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per output image" }, "label": "output image", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "recraft/recraft-v4.1-pro-vector", "route_label": "Ultra", "status_reads": [ "GET /v1/media/tasks/{task_id}" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" }, { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "recraft/recraft-v4.1-pro-vector", "nativeProvenance": { "input_facts_canonical_sha256": "073ae94921707fff26f6f09094838e49d8de118f38d14d95921c6ef9ad59924c", "input_html_sha256": "2eb8b1e3be5e1861afcef72c208fc1317253b8f32e31c09325525c3e97d8cc39", "private_audit_sha256": "0bdc790467da07c7a075fa8f3ec6fc19db0f3344571d4f9642a5c8590b04d8ec", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/es-mx/recraft-recraft-v4-1-pro-vector/", "description": "Recraft V4.1 Pro Vector crea gráficos SVG editables para logotipos, lettering e ilustraciones detalladas. Es la edición vectorial Pro de la familia V4.1, que combina prompts de texto con entradas opcionales de imagen y estilo conservando un entregable vectorial.", "locale": "es-mx", "md_url": "https://ailoot.ai/models/es-mx/recraft-recraft-v4-1-pro-vector/index.md", "title": "Recraft: Recraft V4.1 Pro Vector — Ailoot", "url": "https://ailoot.ai/models/es-mx/recraft-recraft-v4-1-pro-vector/" }, "rawModel": { "about": "Recraft V4.1 Pro Vector es la edición SVG Pro de la familia de generación de imágenes V4.1 de Recraft. Está diseñada para trabajos cuyo resultado deba seguir siendo un gráfico vectorial editable: un logotipo, un concepto tipográfico, un ícono o una ilustración. La presentación del fabricante de V4.1 destaca la composición deliberada y la ilustración, mientras que la referencia exacta del modelo identifica esta variante por separado de las ediciones Vector estándar, Pro ráster y Utility. Su imagen final es un SVG en vez de una exportación ráster de alta resolución.\n\nEl código de modelo del fabricante es recraftv4_1_pro_vector. La salida vectorial no tiene un tamaño fijo en píxeles; la referencia de tamaños admite catorce proporciones entre anchura y altura para modelos vectoriales y no acepta dimensiones exactas en píxeles. Por tanto, los ajustes ráster 2K de Pro no definen la resolución SVG de esta edición. Especifica la proporción prevista y cómo se utilizarán los gráficos. Para un logotipo, el entregable importante es una silueta legible y regiones de color editables que puedan ajustarse en un flujo de diseño.\n\nEl modelo admite generación text-to-image y referencias de estilo personalizado opcionales. El límite documentado del prompt es de 10,000 caracteres. Los colores preferidos, un color de fondo deseado y una semilla aleatoria pueden guiar la generación, y el flujo permite de una a seis salidas. Un estilo guardado compatible o imágenes de referencia pueden establecer un lenguaje visual; el estilo debe corresponder al modelo para el que se creó. La línea principal V4.1 no exige un estilo de referencia en cada solicitud, a diferencia de la familia específica V4 Styles. 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. Para generar con un estilo de referencia, la correspondencia flexible permite una interpretación más libre, mientras que la precisa sigue más de cerca el tratamiento visual, la paleta, la composición y la iluminación.\n\nUna descripción vectorial útil define el tipo de gráfico, la lógica de formas, la paleta, el tratamiento de línea y la disposición antes de añadir detalles decorativos. Para un emblema de una tienda de jardinería, solicita una sola silueta de brote, geometría redondeada, dos colores planos y una composición de marca centrada. Para lettering, incluye la palabra exacta y describe su jerarquía y forma; después inspecciona el SVG devuelto para comprobar que los espacios interiores de las letras, el espaciado y la claridad a tamaño pequeño sean adecuados. Los ejemplos vectoriales del fabricante permiten tipografía expresiva e ilustración; no garantizan que cada letra o trazado generados sean ya un trabajo terminado.\n\nRecraft documenta un flujo image-to-image independiente para modelos ráster y vectoriales V4.1. Combina una imagen existente y un prompt, con strength de 0 a 1 para controlar cuánto se aleja el nuevo resultado del original. Un strength menor se mantiene más cerca y uno mayor permite más cambios. Esa operación no admite controles de estilo personalizado V4/V4.1, por lo que la transformación de una imagen de origen y la generación con estilo de referencia deben prepararse como flujos distintos. La entrada de imagen puede ser PNG, JPG, WebP o SVG dentro de los límites documentados. 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.\n\nV4.1 no admite nombres de estilos predefinidos ni los controles negative_prompt, text_layout, artistic_level o no_text. Especifica la disposición y las letras previstas en la descripción positiva en vez de depender de mecanismos antiguos de V3. Para un recurso de marca detallado, usa el SVG como archivo de trabajo, inspecciona la geometría y ajusta los colores o las formas según sea necesario antes de colocarlo en la disposición final. Esta edición Pro Vector conserva su propia identidad; no es intercambiable con las variantes ráster estándar o Utility solo porque compartan el nombre V4.1.\n\nA 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.", "alias_of": null, "aliases": [], "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Consulta los precios completos de la configuración en los detalles." } ], "ctx": null, "formats": [ "images" ], "id": "recraft/recraft-v4.1-pro-vector", "input": [ "text", "image" ], "kind": "image", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response and headers, original identifiers, every actual output and all usage/accounting fields. Save each unique owned asset and retain every role pointing to it.", "authentication": { "header": "Authorization", "scheme": "Bearer", "value": "$AILOOT_API_KEY" }, "control_semantics": { "other_documented_controls": "Source generic image parsing preserves request JSON. Additional documented controls stay subject to the exact model; missing DTO fields do not create Source refusals.", "quality": "The saved common image schema documents this control and says providers without a quality knob ignore it.", "style": "Selected generic Source passes JSON fields through but the saved dedicated image request schema does not declare a style field. Its omission here is not a Source ban or a supported per-model promise." }, "errors": [ { "condition": "Un campo obligatorio, el selector de modelo, el tipo o la representación de la entrada no son válidos.", "http_status": 400, "recovery": "Revisa los detalles de validación que se devuelvan antes de preparar una solicitud independiente.", "type": "invalid_request_error" }, { "condition": "La solicitud original o su resultado son desconocidos o requieren una comprobación.", "http_status": null, "recovery": "Conserva 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.", "type": null } ], "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned signed URL; never construct a token." }, "status": [ { "http": "GET", "id_source": "actual returned task_id or selected library record; operation_id is a separate identifier", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "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.", "unknown_no_replay": true }, "material_combinations": [ { "materials": [ "text", "image" ], "metadata_authority": "saved_model_discovery_union", "mode": "text_to_image", "reference_maximum": 1, "reference_minimum": 0 } ], "model_parameter_metadata": { "authority": "saved_model_discovery_union", "defaults_not_inferred": { "aspect_ratio": null, "exact_pixels": null, "explanation": "No universal/model default inferred. Omitted output_format uses provider default; dimensions are provider-derived, observed Ming2048 is not a universal default.", "n": null, "output_format": null, "quality": null, "resolution": null }, "known_parameter_choices": { "aspect_ratio": { "type": "enum", "values": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ] }, "input_references": { "max": 1, "min": 0, "type": "range" }, "n": { "max": 6, "min": 1, "type": "range" }, "output_format": { "type": "enum", "values": [ "svg" ] } }, "pointer": "/profiles/36", "scope": "Exact saved model metadata. Discovery unions are identified explicitly and are not represented as definitive selected-provider bounds." }, "outputs": { "all_results": "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.", "documented_formats": [ "svg" ], "every_actual_output": true, "family": "image", "fields": [ { "name": "data[].url", "type": "string" }, { "name": "data[].b64_json", "type": "string" }, { "name": "usage", "type": "object" } ], "format": "The exact saved model metadata lists SVG. Preserve the actual returned MIME and unchanged vector bytes; keep every actual output and owned signed image link." }, "parameters": [ { "conditions": "Usa exactamente este selector de enrutamiento de Ailoot.", "default_known": false, "enum": [ "recraft/recraft-v4.1-pro-vector" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "name": "prompt", "required": true, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "maximum": 6, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "conditions": "", "default_known": false, "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "conditions": "", "default_known": false, "enum": [ "svg" ], "enum_known": true, "name": "output_format", "required": false, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "minItems": 0, "name": "input_references", "required": false, "type": "array" }, { "conditions": "", "default_known": false, "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "enum_known": true, "name": "quality", "required": false, "type": "string" } ], "request_schema": { "additionalProperties": true, "properties": { "aspect_ratio": { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "minItems": 0, "type": "array" }, "model": { "enum": [ "recraft/recraft-v4.1-pro-vector" ], "type": "string" }, "n": { "maximum": 6, "minimum": 1, "type": "integer" }, "output_format": { "enum": [ "svg" ], "type": "string" }, "prompt": { "type": "string" }, "quality": { "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "recraft/recraft-v4.1-pro-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field." }, "content_type": "application/json", "example_is_offline_content": true }, "usage": { "meter": "Use the accepted method price and actual recorded usage; the request reserve is an estimate. A billing unit does not add an input capability.", "preserve": "Keep all returned usage, accounting and request identifiers with every actual output.", "settlement": "Retain the original operation; reconcile its result and accounting once." } }, "input": { "conditions": [ "Usa 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." ], "content_type": "application/json", "material_types": [ "text", "image" ], "optional": [ "n", "aspect_ratio", "output_format", "input_references", "quality" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned signed URL; never construct a token." }, "status": [ { "http": "GET", "id_source": "El task_id realmente devuelto o el registro seleccionado de la biblioteca; operation_id es un identificador independiente.", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the original X-Client-Request-ID, response and headers. An unknown or result_pending_check outcome does not authorize a second creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "output": { "all_results": "Retain the complete response and headers, original identifiers, every actual output and all usage/accounting fields. Save each unique owned asset and retain every role pointing to it.", "documented_formats": [ "svg" ], "every_actual_output": true, "family": "image", "fields": [ { "name": "data[].url", "type": "string" }, { "name": "data[].b64_json", "type": "string" }, { "name": "usage", "type": "object" } ], "format": "The saved exact model metadata lists SVG. Preserve actual MIME and bytes; storage MIME support alone does not prove completion of the full selected generic output path." } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per output image" }, "label": "output image", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "Esta estimación no es un cargo adicional ni una tarifa fija por la generación completada.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Costo estimado de generación", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{\"model\": \"recraft/recraft-v4.1-pro-vector\", \"prompt\": \"A portrait of an Asian woman with neon green lights in the background, shallow depth of field.\"}')\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "images", "http": "POST", "in": null, "input": [ "text", "image" ], "input_conditions": { "image": "Use the exact model reference-input range in the saved model metadata; a reference becomes required only for the models whose listed minimum is positive." }, "label": "Images", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "image" ], "path": "/v1/images/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per output image" }, "label": "output image", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "recraft/recraft-v4.1-pro-vector", "route_label": "Ultra", "status_reads": [ "GET /v1/media/tasks/{task_id}" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" }, { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "recraft/recraft-v4.1-pro-vector", "request_model_id": "recraft/recraft-v4.1-pro-vector", "route_label": "Ultra" } ], "name": "Recraft: Recraft V4.1 Pro Vector", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.6, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.6, "varies": false }, "short": "Recraft V4.1 Pro Vector crea gráficos SVG editables para logotipos, lettering e ilustraciones detalladas. Es la edición vectorial Pro de la familia V4.1, que combina prompts de texto con entradas opcionales de imagen y estilo conservando un entregable vectorial.", "title": "Recraft: Recraft V4.1 Pro Vector" }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "Recraft V4.1 Pro Vector crea gráficos SVG editables para logotipos, lettering e ilustraciones detalladas. Es la edición vectorial Pro de la familia V4.1, que combina prompts de texto con entradas opcionales de imagen y estilo conservando un entregable vectorial.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "e352e91e174c138a38c4463d4bb1681de434c281008b5f8745897d3a66c958ad", "renderer_sha256": "50c5984577eac7205687c05e1c36de5d3ba7a0afdff02194efad3a88143581e8" }, "sourceRevision": "5ef2df52f59bd26365f87bf3f64ae98d61da5a2b36ff0030d5fb77c51b532961" }