models

Recraft: Recraft V4 Styles

Markdown · JSON

Recraft: Recraft V4 Styles

Recraft V4 Styles genera imágenes ráster 1K en un estilo visual definido por referencias. Está diseñado para trabajo cotidiano de marca y campañas donde cada sujeto nuevo debe conservar la misma representación, textura y apariencia general.

Sobre el modelo

Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.

Recraft V4 Styles es la edición ráster estándar de la familia dedicada de Recraft para generación con estilo consistente. Crea una imagen nueva a partir de un prompt de texto mientras sigue un estilo establecido por referencias. El modelo resulta útil para una serie de ilustraciones, banners o escenas de producto que deban compartir un tratamiento visual reconocible. La referencia aporta la lógica de representación, textura y color; el prompt introduce el sujeto y la escena de cada recurso nuevo.

El fabricante incluye salida ráster 1K en WebP sin pérdida o PNG. El tamaño cuadrado tiene 1024 × 1024 píxeles y el tamaño documentado 16:9 tiene 1344 × 768; las proporciones verticales y otras admitidas utilizan sus propios tamaños. Esta edición es distinta de la salida ráster 2K de Styles Pro y de los modelos Vector que producen SVG. Elige la relación de aspecto para la composición final en lugar de asumir que la etiqueta 1K significa que todas las imágenes tienen el mismo ancho y alto.

Un estilo es obligatorio. Usa entre una y diez referencias PNG, JPG o WebP o un estilo compatible guardado de una creación de estilo anterior. El flujo documentado no admite juntos un identificador de estilo guardado y referencias nuevas. Las referencias pueden ser recursos existentes de marca o campaña en lugar de imágenes generadas originalmente por Recraft. Deben tener menos de 20 MB por archivo y no más de 64 MB en conjunto. No hay una tarea independiente de entrenamiento ejecutada por el usuario antes de poder utilizar el estilo. Cada referencia debe tener un lado corto de al menos 256 píxeles, un lado largo de no más de 4,096 píxeles y una resolución total de no más de 16 megapíxeles.

Comienza con una referencia sólida o varias referencias que ya coincidan en lenguaje visual. Las referencias consistentes ayudan a aplicar el estilo más allá de un solo objeto o pose; un moodboard sin relación puede introducir motivos que compiten. La coincidencia flexible es la predeterminada y deja más margen interpretativo; la coincidencia precisa sigue más de cerca la representación, paleta, composición e iluminación de la referencia. Aun así, no se garantiza una reproducción exacta del color.

Para una serie de banners, describe a un repartidor colocando un paquete en la entrada de una casa, una composición horizontal tranquila y espacio abierto a un lado para texto posterior. Los briefs siguientes pueden cambiar el evento o ángulo de cámara conservando el mismo estilo. El fabricante permite prompts de hasta 10,000 caracteres, colores preferidos, un color de fondo deseado, una semilla aleatoria y entre una y seis imágenes. No admite negative_prompt, nombres de estilos seleccionados ni text_layout, así que describe directamente sujeto y composición previstos en el brief.

La línea Styles no ofrece imagen a imagen ni relleno de zonas. Una referencia de estilo guía una imagen nueva generada en lugar de garantizar la conservación de los objetos o píxeles de la referencia. Si el conjunto parece repetitivo, modifica pose, acción, encuadre o detalle de escena en lugar de añadir una referencia contradictoria. Evalúa cada resultado en su composición prevista en cuanto a claridad del sujeto, espacio útil y representación coherente, y conserva después el mismo estilo compatible para el siguiente recurso. Esto hace práctico al modelo para un lenguaje visual repetible con contenido cambiante.

Ailoot Ultra · Imágenes POST /v1/images/generations recraft/recraft-v4-styles

recraft/recraft-v4-styles

Recraft /recraft/recraft-v4-styles

Inicio

Recraft V4 Styles genera imágenes ráster 1K en un estilo visual definido por referencias. Está diseñado para trabajo cotidiano de marca y campañas donde cada sujeto nuevo debe conservar la misma representación, textura y apariencia general.

Entradas aceptadas
Texto · Imágenes
Resultados
Imágenes

Disponible en Ailoot · entradas y métodos

Ailoot Ultra · Imágenes POST /v1/images/generations
Entrada
text, image
Salida
image
CampoTipoRequisitoValores y límitesPredeterminado
CampomodelTipostringRequisitoObligatorioValores y límites
recraft/recraft-v4-styles
Predeterminado—
CampopromptTipostringRequisitoObligatorioValores y límites
Longitud mínima: 1
Predeterminado—
Campoaspect_ratioTipostringRequisitoOpcionalValores y límites
1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto
Predeterminado—
CamponTipointegerRequisitoOpcionalValores y límites
Mínimo: 1
Máximo: 6
Predeterminado—
Campoinput_referencesTipoarrayRequisitoOpcionalValores y límites
Número mínimo de elementos: 1
Número máximo de elementos: 10
Predeterminado—
CampoproviderTipoobjectRequisitoOpcionalValores y límitesPredeterminado—
Parámetros del método y ciclo de vida
ParámetroContrato
Parámetrocontent_typeContratoapplication/json
ParámetrorequiredContratomodel, prompt
Parámetromaterial_typesContratotext, image

Ciclo de vida: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · El task_id real devuelto o el registro de la biblioteca multimedia

GET /v1/media/assets/{asset_id}/content

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ónCondiciones de facturaciónCargo
ConfiguraciónTarifas base por tokenTabla de tarifasTarifa baseCantidad prevista—Unidad de facturación—Condiciones de facturación—Cargo
Entrada · Tokens de entrada · Estimación solo para comparar — / 1K tokens
Salida · Tokens de salida · Estimación solo para comparar — / 1K tokens
Entrada · Lectura de caché · Estimación solo para comparar — / 1K tokens
Entrada · Escritura en caché · Estimación solo para comparar — / 1K tokens
Entrada · Escritura en caché, 1 hora · Estimación solo para comparar — / 1K tokens
ConfiguraciónReferencia de entradaTabla de tarifas—Cantidad prevista—Unidad de facturaciónpor solicitudCondiciones de facturaciónCreación de estilo al generar con referencias de estilo; una vez por solicitud, además del precio de las imágenes de salida.Cargo
Entrada · Referencia de entrada · Estimación solo para comparar $0.01 por solicitud
Configuraciónimagen de salidaTabla de tarifas—Cantidad prevista—Unidad de facturaciónpor imagen de salidaCondiciones de facturación—Cargo
Salida · imagen de salida · Estimación solo para comparar $0.07 por imagen de salida
ConfiguraciónCosto estimado de generaciónTabla de tarifas—Cantidad previstaestimación para una generaciónUnidad de facturación—Condiciones de facturación—Cargo
Salida · Costo estimado de generación · Estimación solo para comparar $0.07 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 · Imágenes

curl
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'recraft/recraft-v4-styles', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        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"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Recibir y guardar resultados

Ailoot Ultra · Imágenes

Descarga cada imagen recibida o guarda su contenido Base64

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Otras consultas de contenido
Consultar los archivos existentes que te pertenecen
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Conserva todos los resultados completados

Guarda todas las imágenes completadas; descarga cada URL recibida o decodifica su contenido Base64.

Conserva la respuesta completa y los encabezados, 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.

Si es necesario revisar la respuesta original

Conserva el X-Client-Request-ID devuelto para la conciliación. Consulta únicamente los valores reales de task_id/asset_id devueltos o la biblioteca multimedia de tu propiedad; nunca construyas una URL de tarea a partir del ID de la operación ni vuelvas a enviar la solicitud de creación.

Campos de respuesta
CampoTipo
CampocreatedTipo
Campodata[].urlTipo
Campodata[].b64_jsonTipo
CampousageTipo

Alias

Alias del modelo

Ailoot Ultra recraft/recraft-v4-styles

Alias de rutas de métodos

/v1/images

ID de modelo relacionados

recraft/recraft-v4-styles

FAQ · Recraft: Recraft V4 Styles
¿Qué entradas y resultados están disponibles?

POST /v1/images/generations · recraft/recraft-v4-styles: text, image → image

¿Qué campos utiliza la solicitud?

POST /v1/images/generations · recraft/recraft-v4-styles: model, prompt, aspect_ratio, n, input_references, provider

¿Qué límites se aplican?

POST /v1/images/generations · recraft/recraft-v4-styles: n.minimum: 1; n.maximum: 6

Más detalles

Conecta Ailoot a Claude Code, OpenCode, Hermes o tu aplicación.

La empresa y su cartera de proyectos

La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes.

Compra tokens con descuento.

Ahorro por suscripción para trabajo habitual. Códigos promocionales: hasta el 50% al comprar tokens.

Suscripción
Elige un plan con descuento para tus peticiones habituales.
Código de hasta el 50%
Introduce el código al comprar. El precio se recalcula según la promoción vigente.
Gasto en el historial
Modelo, tokens e importe quedan guardados por cada petición.

Elegir suscripción · Consultar precios de modelos

Conecta la API al producto que vendes.

SaaS, aplicaciones y bots bajo la oferta y el acuerdo de licencia Ailoot. Solicita una licencia de reventa para redistribuir el acceso.

Aplicación comercial
Integra generación de texto, imágenes, vídeo y sonido en funciones de pago de tu servicio.
Licencia para revendedores
Envía descripción del proyecto y esquema de acceso. Solicita condiciones escritas de uso y reventa.
Documentos en la web
La oferta, el acuerdo de licencia y la política de datos están disponibles antes de conectar.

Solicitar licencia de reventa · Oferta y acuerdo de licencia