Recraft V4.1 Utility Pro es la variante ráster de mayor resolución de la rama Utility dentro de Recraft V4.1. El fabricante distingue la presentación sencilla de Utility de las elecciones más expresivas de ángulo, iluminación y composición del modelo V4.1 principal. Utility favorece escenas simples, iluminación plana y sujetos frontales. Por ello es adecuado para imágenes de fichas de producto, mockups y otros trabajos donde el objeto debe ser fácil de interpretar y una composición tranquila sirve a la tarea.
El código exacto del modelo es recraftv4_1_utility_pro. Su referencia del productor enumera salida ráster 2K con detalle más fino, en WebP sin pérdidas o PNG. La tabla de tamaños indica 2048 × 2048 píxeles para imágenes cuadradas y 2432 × 1792 para 4:3, con otras relaciones de aspecto admitidas que utilizan sus propias dimensiones. Esto diferencia Utility Pro de la salida 1K de Utility estándar. No convierte la imagen en un archivo vectorial editable; una edición Vector proporciona SVG para esa finalidad.
Empieza con un encargo que nombre el objeto, el material, el ángulo de visión, el fondo y los pocos detalles que deben estar visibles. Para una ficha de producto, pide un tarro de almacenamiento de cerámica de frente sobre una superficie neutra clara, iluminación uniforme, una tapa cerrada y espacio libre alrededor de la silueta. Si la escena debe seguir siendo sencilla, dilo explícitamente en lugar de confiar en que el nombre Utility codifique todas las elecciones de presentación. Para una serie de imágenes de ficha, mantén coherentes los requisitos de encuadre y fondo mientras cambias la descripción del producto.
La referencia de generación V4.1 admite prompts de hasta 10 000 caracteres, controles de colores preferidos y color de fondo, una semilla aleatoria y entre una y seis salidas. Un estilo guardado compatible o imágenes de referencia opcionales pueden orientar el aspecto; la familia específica V4 Styles es la línea separada donde un estilo es siempre obligatorio. Para referencias opcionales, utiliza recursos claros cuya dirección visual concuerde. No se garantiza la reproducción exacta del color de una referencia, por lo que un requisito de color de marca aún necesita un encargo explícito y una comprobación de la salida. Para generar con un estilo de referencia, utiliza de una a diez imágenes PNG, JPG o WebP, con un máximo total de 64 MB 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. Utiliza estas referencias o un estilo guardado compatible, en lugar de ambos. Para generar con un estilo de referencia, la coincidencia flexible permite una interpretación más libre, mientras que la precisa sigue más de cerca la representación, la paleta, la composición y la iluminación.
Recraft también documenta imagen a imagen para la línea V4.1, combinando una imagen existente con un prompt e intensidad de 0 a 1. Una intensidad menor se mantiene más cerca de la fuente y un valor mayor permite un cambio mayor. Esto resulta útil cuando la composición o el sujeto iniciales deben orientar una nueva versión. No acepta controles de estilos personalizados V4.1 en la misma operación de transformación. Sus límites de entrada de imagen del productor son menos de 20 MB, hasta 16 MP y lados entre 256 y 4096 píxeles.
Utility Pro comparte las restricciones de V4.1 sobre negative_prompt, nombres de estilos seleccionados, text_layout, artistic_level y controles no_text. Da una descripción positiva de la escena prevista y reserva el trabajo de letras o distribución precisas para una etapa de acabado apropiada cuando sea necesario. Revisa una imagen de producto en cuanto al material, la forma y los detalles necesarios proporcionados antes de tratarla como un recurso fiel de ficha. El resultado útil es una composición ráster mayor preparada para un encargo claro de producto o mockup, mientras que los datos exactos de producto siguen siendo los proporcionados en la tarea.
", "aboutText": "Recraft V4.1 Utility Pro es la variante ráster de mayor resolución de la rama Utility dentro de Recraft V4.1. El fabricante distingue la presentación sencilla de Utility de las elecciones más expresivas de ángulo, iluminación y composición del modelo V4.1 principal. Utility favorece escenas simples, iluminación plana y sujetos frontales. Por ello es adecuado para imágenes de fichas de producto, mockups y otros trabajos donde el objeto debe ser fácil de interpretar y una composición tranquila sirve a la tarea.\n\nEl código exacto del modelo es recraftv4_1_utility_pro. Su referencia del productor enumera salida ráster 2K con detalle más fino, en WebP sin pérdidas o PNG. La tabla de tamaños indica 2048 × 2048 píxeles para imágenes cuadradas y 2432 × 1792 para 4:3, con otras relaciones de aspecto admitidas que utilizan sus propias dimensiones. Esto diferencia Utility Pro de la salida 1K de Utility estándar. No convierte la imagen en un archivo vectorial editable; una edición Vector proporciona SVG para esa finalidad.\n\nEmpieza con un encargo que nombre el objeto, el material, el ángulo de visión, el fondo y los pocos detalles que deben estar visibles. Para una ficha de producto, pide un tarro de almacenamiento de cerámica de frente sobre una superficie neutra clara, iluminación uniforme, una tapa cerrada y espacio libre alrededor de la silueta. Si la escena debe seguir siendo sencilla, dilo explícitamente en lugar de confiar en que el nombre Utility codifique todas las elecciones de presentación. Para una serie de imágenes de ficha, mantén coherentes los requisitos de encuadre y fondo mientras cambias la descripción del producto.\n\nLa referencia de generación V4.1 admite prompts de hasta 10 000 caracteres, controles de colores preferidos y color de fondo, una semilla aleatoria y entre una y seis salidas. Un estilo guardado compatible o imágenes de referencia opcionales pueden orientar el aspecto; la familia específica V4 Styles es la línea separada donde un estilo es siempre obligatorio. Para referencias opcionales, utiliza recursos claros cuya dirección visual concuerde. No se garantiza la reproducción exacta del color de una referencia, por lo que un requisito de color de marca aún necesita un encargo explícito y una comprobación de la salida. Para generar con un estilo de referencia, utiliza de una a diez imágenes PNG, JPG o WebP, con un máximo total de 64 MB 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. Utiliza estas referencias o un estilo guardado compatible, en lugar de ambos. Para generar con un estilo de referencia, la coincidencia flexible permite una interpretación más libre, mientras que la precisa sigue más de cerca la representación, la paleta, la composición y la iluminación.\n\nRecraft también documenta imagen a imagen para la línea V4.1, combinando una imagen existente con un prompt e intensidad de 0 a 1. Una intensidad menor se mantiene más cerca de la fuente y un valor mayor permite un cambio mayor. Esto resulta útil cuando la composición o el sujeto iniciales deben orientar una nueva versión. No acepta controles de estilos personalizados V4.1 en la misma operación de transformación. Sus límites de entrada de imagen del productor son menos de 20 MB, hasta 16 MP y lados entre 256 y 4096 píxeles.\n\nUtility Pro comparte las restricciones de V4.1 sobre negative_prompt, nombres de estilos seleccionados, text_layout, artistic_level y controles no_text. Da una descripción positiva de la escena prevista y reserva el trabajo de letras o distribución precisas para una etapa de acabado apropiada cuando sea necesario. Revisa una imagen de producto en cuanto al material, la forma y los detalles necesarios proporcionados antes de tratarla como un recurso fiel de ficha. El resultado útil es una composición ráster mayor preparada para un encargo claro de producto o mockup, mientras que los datos exactos de producto siguen siendo los proporcionados en la tarea.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "d6c8c45352b1aefe277a7bebfeb6dd53a8265cf3da24a13d8ad3a86f7053d569", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es", "methods": [ { "html": "recraft/recraft-v4.1-utility-proRecraft V4.1 Utility Pro genera imágenes ráster 2K centradas en escenas simples y predecibles, iluminación plana y composición frontal. Es adecuado para fotografías detalladas de producto y mockups que necesitan una presentación clara en lugar de una dirección artística expresiva.
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 Utility Pro es la variante ráster de mayor resolución de la rama Utility dentro de Recraft V4.1. El fabricante distingue la presentación sencilla de Utility de las elecciones más expresivas de ángulo, iluminación y composición del modelo V4.1 principal. Utility favorece escenas simples, iluminación plana y sujetos frontales. Por ello es adecuado para imágenes de fichas de producto, mockups y otros trabajos donde el objeto debe ser fácil de interpretar y una composición tranquila sirve a la tarea.
El código exacto del modelo es recraftv4_1_utility_pro. Su referencia del productor enumera salida ráster 2K con detalle más fino, en WebP sin pérdidas o PNG. La tabla de tamaños indica 2048 × 2048 píxeles para imágenes cuadradas y 2432 × 1792 para 4:3, con otras relaciones de aspecto admitidas que utilizan sus propias dimensiones. Esto diferencia Utility Pro de la salida 1K de Utility estándar. No convierte la imagen en un archivo vectorial editable; una edición Vector proporciona SVG para esa finalidad.
Empieza con un encargo que nombre el objeto, el material, el ángulo de visión, el fondo y los pocos detalles que deben estar visibles. Para una ficha de producto, pide un tarro de almacenamiento de cerámica de frente sobre una superficie neutra clara, iluminación uniforme, una tapa cerrada y espacio libre alrededor de la silueta. Si la escena debe seguir siendo sencilla, dilo explícitamente en lugar de confiar en que el nombre Utility codifique todas las elecciones de presentación. Para una serie de imágenes de ficha, mantén coherentes los requisitos de encuadre y fondo mientras cambias la descripción del producto.
La referencia de generación V4.1 admite prompts de hasta 10 000 caracteres, controles de colores preferidos y color de fondo, una semilla aleatoria y entre una y seis salidas. Un estilo guardado compatible o imágenes de referencia opcionales pueden orientar el aspecto; la familia específica V4 Styles es la línea separada donde un estilo es siempre obligatorio. Para referencias opcionales, utiliza recursos claros cuya dirección visual concuerde. No se garantiza la reproducción exacta del color de una referencia, por lo que un requisito de color de marca aún necesita un encargo explícito y una comprobación de la salida. Para generar con un estilo de referencia, utiliza de una a diez imágenes PNG, JPG o WebP, con un máximo total de 64 MB 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. Utiliza estas referencias o un estilo guardado compatible, en lugar de ambos. Para generar con un estilo de referencia, la coincidencia flexible permite una interpretación más libre, mientras que la precisa sigue más de cerca la representación, la paleta, la composición y la iluminación.
Recraft también documenta imagen a imagen para la línea V4.1, combinando una imagen existente con un prompt e intensidad de 0 a 1. Una intensidad menor se mantiene más cerca de la fuente y un valor mayor permite un cambio mayor. Esto resulta útil cuando la composición o el sujeto iniciales deben orientar una nueva versión. No acepta controles de estilos personalizados V4.1 en la misma operación de transformación. Sus límites de entrada de imagen del productor son menos de 20 MB, hasta 16 MP y lados entre 256 y 4096 píxeles.
Utility Pro comparte las restricciones de V4.1 sobre negative_prompt, nombres de estilos seleccionados, text_layout, artistic_level y controles no_text. Da una descripción positiva de la escena prevista y reserva el trabajo de letras o distribución precisas para una etapa de acabado apropiada cuando sea necesario. Revisa una imagen de producto en cuanto al material, la forma y los detalles necesarios proporcionados antes de tratarla como un recurso fiel de ficha. El resultado útil es una composición ráster mayor preparada para un encargo claro de producto o mockup, mientras que los datos exactos de producto siguen siendo los proporcionados en la tarea.
POST /v1/images/generationstext, imageimage| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites recraft/recraft-v4.1-utility-pro | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites Longitud mínima: 1 | Predeterminado— |
Campoaspect_ratio | Tipostring | RequisitoOpcional | Valores y límites 1:1, 4:3, 3:4, 16:9, 9:16, auto | Predeterminado— |
Campon | Tipointeger | RequisitoOpcional | Valores y límites Mínimo: 1 Máximo: 6 | Predeterminado— |
Campoinput_references | Tipoarray | RequisitoOpcional | Valores y límites Número mínimo de elementos: 0 Número máximo de elementos: 1 | Predeterminado— |
Campoprovider | Tipoobject | RequisitoOpcional | Valores y límites | Predeterminado— |
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, prompt |
Parámetromaterial_types | Contratotext, image |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id real devuelto o registro de la biblioteca multimedia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
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.
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.42 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.42 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 →
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={'model': 'recraft/recraft-v4.1-utility-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\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\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nDescarga cada imagen recibida o guarda su contenido Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nGuarda todas las imágenes completadas; descarga cada URL recibida o decodifica su contenido Base64.
Conserva la respuesta completa y las cabeceras, todas las salidas reales, los identificadores originales devueltos y todos los campos de uso. Recupera la operación original sin volver a enviar la solicitud de creación.
Conserva el X-Client-Request-ID devuelto para la conciliación. Consulta únicamente los valores task_id/asset_id realmente devueltos o la biblioteca multimedia propia; nunca construyas una URL de tarea a partir del ID de la operación ni vuelvas a enviar la solicitud de creación.
| Campo | Tipo |
|---|---|
Campocreated | Tipo |
Campodata[].url | Tipo |
Campodata[].b64_json | Tipo |
Campousage | Tipo |
Ailoot Ultra recraft/recraft-v4.1-utility-pro
/v1/images