modelos

Recraft: Recraft V4 Styles

Markdown · JSON

Recraft: Recraft V4 Styles

Recraft V4 Styles genera imágenes ráster 1K con un estilo visual definido por referencias. Está diseñado para el trabajo cotidiano de marca y campañas donde cada sujeto nuevo debe conservar la misma representación, textura y aspecto 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 específica de generación con estilo coherente de Recraft. Crea una imagen nueva a partir de un prompt textual mientras sigue un estilo establecido por recursos de referencia. El modelo es útil para series de ilustraciones, banners o escenas de producto que deben compartir un tratamiento visual reconocible. La referencia aporta la representación, la textura y la lógica de color; el prompt introduce el sujeto y la escena de cada recurso nuevo.

El productor enumera salida ráster 1K en WebP sin pérdidas o PNG. El tamaño cuadrado es de 1024 × 1024 píxeles y el tamaño 16:9 documentado es de 1344 × 768; las relaciones verticales y las demás 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 suponer que la etiqueta 1K significa que todas las imágenes tienen la misma anchura y altura.

El estilo es obligatorio. Utiliza de una a diez referencias PNG, JPG o WebP o un estilo compatible guardado tras una creación de estilo anterior. El flujo documentado no acepta juntos un identificador de estilo guardado y referencias nuevas. Las referencias pueden ser recursos existentes de marca o campaña, sin necesidad de ser imágenes generadas originalmente por Recraft. Deben tener menos de 20 MB por archivo y no más de 64 MB en total. No existe una tarea de entrenamiento independiente ejecutada por el usuario antes de poder utilizar el estilo. Cada referencia debe tener un lado menor de al menos 256 píxeles, un lado mayor de no más de 4096 píxeles y una resolución total de no más de 16 megapíxeles.

Empieza con una referencia sólida o varias que ya coincidan en lenguaje visual. Las referencias coherentes ayudan a aplicar el estilo más allá de un solo objeto o pose; un moodboard ajeno puede introducir motivos contrapuestos. La coincidencia flexible es la predeterminada y deja más espacio interpretativo; la 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 puerta de una casa, una composición horizontal tranquila y espacio libre en un lado para texto posterior. Los encargos siguientes pueden cambiar el evento o el ángulo de cámara y conservar el mismo estilo. El productor 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, por lo que debes describir directamente el sujeto y la distribución previstos en el encargo.

La línea Styles no ofrece imagen a imagen ni inpainting. Una referencia de estilo guía una imagen nueva generada en lugar de garantizar que se conserven los objetos o píxeles de la referencia. Si el conjunto parece repetitivo, revisa la pose, la acción, el encuadre o el 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 el 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

Primeros pasos

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

Entradas aceptadas
Texto · Imágenes
Resultados
Imágenes

Disponible en Ailoot · entradas y métodos

Ailoot Ultra · Imágenes POST /v1/images/generations
Tipos de entrada
text, image
Tipos de 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} · 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}

Planes

Cómo se calcula el cargo definitivo

Las tarifas mostradas estiman el coste antes de la generación. El cargo final se calcula a partir del coste registrado para la generación original. La duración medida del resultado y las cantidades previstas no constituyen la cantidad facturable final.

Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.

Modo rápido
Sin especificar Cuando se selecciona el modo rápido
Modo flex
Sin especificar Cuando se selecciona el modo flex
Esfuerzo máximo de razonamiento
Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (default)

Tarifas estimadas para comparar

Precios por configuración

Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.

Configuració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 la imagen 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ónCoste estimado de generaciónTabla de tarifas—Cantidad previstaestimación para una generaciónUnidad de facturación—Condiciones de facturación—Cargo
Salida · Coste 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 para la generación completada.

Ailoot reserva un importe estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →

Solicitudes de ejemplo

Ailoot Ultra · 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 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.

Si es necesario revisar la respuesta original

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.

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