Recraft: Recraft V4.1 Flash
Recraft V4.1 Flash genera imágenes ráster 1K a partir de texto para una iteración visual rápida. Admite fotografía, retratos, escenas complejas y conceptos de logotipo, con salida PNG o WebP sin pérdidas y preferencias explícitas de color.
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 Flash es el modelo de texto a imagen de Recraft para iteración rápida y trabajo visual de gran volumen. El fabricante identifica la fotografía, los retratos, la atmósfera, las escenas complejas, las técnicas mixtas y los conceptos de logotipo como usos destacados. Un encargo escrito se convierte en una imagen ráster que puede compararse con otras direcciones creativas antes de desarrollar un recurso final. Flash es un miembro específico de la familia V4.1, con su propio tamaño de salida y controles admitidos.
La salida nativa pertenece a la clase de imágenes ráster 1K de Recraft. Elige el lienzo según la ubicación prevista: una ilustración horizontal para una cabecera de página, un retrato vertical o una imagen cuadrada para una tarjeta compacta. Los formatos de salida son WebP sin pérdidas y PNG.
Empieza el encargo con el sujeto principal y la finalidad visual y describe después el encuadre, el entorno, la iluminación y la técnica. Para un concepto de producto, una instrucción útil es: «Una radio compacta de color crema sobre un escritorio de nogal, vista frontal de tres cuartos, luz suave de ventana, fotografía editorial tranquila, abundante espacio vacío a la izquierda». Para una ilustración, identifica el lenguaje de formas, la paleta y la relación entre los elementos. Explicita los detalles que definen la idea en lugar de añadir adjetivos inconexos. El límite documentado de prompts de Flash es de hasta 10 000 caracteres, por lo que puede describirse una escena detallada cuando la tarea lo requiera.
Los controles del fabricante incluyen colores preferidos y un color de fondo deseado. Puede proporcionarse una semilla para resultados reproducibles, y su interfaz de generación documenta de una a seis imágenes en una solicitud. Estos controles permiten una comparación útil: mantén estables el sujeto y la composición, varía una dirección visual y revisa las imágenes resultantes para la distribución prevista. Las preferencias de color describen el resultado solicitado; compara los colores importantes de marca con el recurso terminado antes de combinarlo con un sistema de diseño existente.
Flash produce gráficos ráster. Un concepto de logotipo puede ayudar a elegir una silueta, un ambiente o una disposición, mientras que los trazados editables pertenecen a los modelos denominados Vector por separado. Flash tampoco tiene una variante Pro. La línea V4.1 completa ofrece esas opciones separadas cuando la edición vectorial o el detalle de mayor resolución son centrales para la entrega. El fabricante describe un paso posterior de refinamiento para llevar un borrador elegido hacia una imagen más detallada; ese paso es una operación distinta, no otro tamaño de salida nativa de Flash.
Esta edición no admite entrada de imagen a imagen, estilos personalizados, identificadores de estilo, coincidencia de estilo ni imágenes de referencia de estilo. Su interfaz documentada también excluye prompts negativos y controles explícitos de distribución del texto. Incorpora el aspecto y la composición solicitados al encargo positivo. Cuando las letras formen parte de un concepto, cita el texto previsto e inspecciona las letras representadas; utiliza una etapa separada de maquetación cuando la tipografía y la colocación exactas sean esenciales.
Un resultado práctico de Flash es una dirección visual seleccionada con un encargo claro, una relación de aspecto apropiada y un archivo ráster utilizable. Compara el sujeto, el encuadre, el fondo y los detalles importantes al tamaño al que aparecerá la imagen. Conserva juntos el prompt que funcionó y el archivo elegido para que el siguiente paso creativo siga la dirección seleccionada. La iteración rápida ayuda a explorar el diseño; la salida vectorial nativa, la coincidencia de estilo por referencias y la resolución de otra edición V4.1 siguen siendo elecciones de modelo separadas.
Ailoot Ultra · Imágenes POST /v1/images/generations recraft/recraft-v4.1-flash
recraft/recraft-v4.1-flashPrimeros pasos
Recraft V4.1 Flash genera imágenes ráster 1K a partir de texto para una iteración visual rápida. Admite fotografía, retratos, escenas complejas y conceptos de logotipo, con salida PNG o WebP sin pérdidas y preferencias explícitas de color.
- Entradas aceptadas
- Texto
- Resultados
- Imágenes
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Imágenes POST /v1/images/generations
- Tipos de entrada
text- Tipos de salida
image- Formato de salida
- Archivo de imagen
- Número de salidas
- 1 salida
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites recraft/recraft-v4.1-flash | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites Longitud mínima: 1 Condiciones: Instrucción de texto UTF8 no vacía. No se inventa ningún límite de caracteres general del fabricante. | Predeterminado— |
Campon | Tipointeger | RequisitoOpcional | Valores y límites 1 | Predeterminado1 |
Camporesponse_format | Tipostring | RequisitoOpcional | Valores y límites url, b64_json | Predeterminado— |
Campostream | Tipoboolean | RequisitoOpcional | Valores y límites false | Predeterminadofalse |
Combinaciones de materiales de entrada
Texto a imagen · Obligatorio: prompt
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, prompt |
Parámetromaterial_types | Contratotext |
Parámetrooptional | Contraton, response_format, stream |
Parámetron | Contrato1 |
Parámetrostream | Contratofalse |
Parámetroresponse_format | Contratourl, b64_json |
Parámetroreference_images | Contratofalse |
Parámetroedit | Contratofalse |
Parámetrooutput_format_optional | Contrato |
Parámetroresolution_control | Contratonull |
Parámetroaspect_ratio_control | Contratonull |
Parámetroother_fields | Contratorechazado salvo para el enrutamiento interno exacto y fijado del proveedor |
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}
Genera una imagen a partir de una instrucción de texto.
Guarda todos los elementos de data; url/b64_json son codificaciones del resultado.
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ó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ónUltra | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor imagen de salida | Cargo Salida · salida de imagen · Estimación solo para comparar $0.014 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.014 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 →
Detalles de la tarifa de referencia
Las tablas de referencia del modelo no cambian la selección del método, las estimaciones de coste ni los cargos. Los cargos aplicados usan las tarifas del método Ailoot seleccionado.
Configuraciones de precios de imagen
Precios por configuración
| Configuración | Condiciones de facturación | Cargo |
|---|---|---|
| ConfiguraciónImagen de salida | Condiciones de facturaciónNo se declara ninguna variante de precio. | Cargo Salida · Imagen de salida $0.014 por imagen Los listados equivalentes describen el mismo cargo; no añaden una segunda comisión. |
Solicitudes de ejemplo
Ailoot Ultra · Imágenes
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=json.loads('{"model": "recraft/recraft-v4.1-flash", "prompt": "A lighthouse on a cliff, watercolor", "n": 1, "response_format": "b64_json"}')
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
from openai import OpenAI
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")
request={'model': 'recraft/recraft-v4.1-flash', 'prompt': 'A lighthouse on a cliff, watercolor', 'n': 1, 'response_format': 'b64_json'}
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.images.generate(**request)
Path("sdk-result.txt").write_text(str(result),encoding="utf-8")
save_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])
import OpenAI from "openai";
import { readFileSync, writeFileSync } from "node:fs";
const key=process.env.AILOOT_API_KEY;
if(!key) throw new Error("Set your actual Ailoot API key");
const client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});
const request={"model": "recraft/recraft-v4.1-flash", "prompt": "A lighthouse on a cliff, watercolor", "n": 1, "response_format": "b64_json"};
const result=await client.images.generate(request);
writeFileSync("sdk-result.json",JSON.stringify(result,null,2));
if(!result.data?.length) throw new Error("No completed images");
for(let index=0;index<result.data.length;index++) {
const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;
if(!encoded && uri.startsWith("data:image/")) {
const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");
encoded=uri.slice(comma+1);
}
if(encoded) {
if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");
raw=Buffer.from(encoded,"base64");
} else if(uri) {
const u=new URL(uri,"https://api.ailoot.ai");
if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");
const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");
const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});
if(!response.ok) throw new Error("Image content download failed: "+response.status);
raw=Buffer.from(await response.arrayBuffer());
} else throw new Error("Image has neither bytes nor URL");
if(!raw.length) throw new Error("Empty image result");
const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";
writeFileSync(`image-${index}.${ext}`,raw);
}
console.log("Every returned image saved; sdk-result.json retains complete metadata");
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}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Conserva todos los resultados completados
Guarda todas las imágenes completadas; descarga cada URL recibida o decodifica su contenido Base64.
Guarda todos los elementos de datos. Decodifica cada b64_json o descarga el recurso de cada URL firmada devuelta. Elige la extensión del archivo a partir del tipo MIME o de los bytes reales.
Si es necesario revisar la respuesta original
Si el resultado de una generación o edición de imágenes requiere una comprobación, conserva el operation_id/X-Client-Request-ID original y la información del resultado devuelta. Recupera los resultados propios existentes a través de la biblioteca multimedia usando valores task_id o asset_id reales. No vuelvas a enviar la solicitud de generación o edición ni construyas una URL de consulta periódica a partir de operation_id.
Campos de respuesta
| Campo | Tipo |
|---|---|
Campocreated | Tipointeger |
Campodata[].url | Tipostring |
Campodata[].b64_json | Tipobase64 string |
Campousage | Tipoobject |
Errores y siguientes pasos
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta400 · invalid_request_error | CondiciónCampos obligatorios, representación del material o valor del parámetro no válidos | Siguiente pasoCorrige los campos indicados antes de una nueva solicitud de creación. |
Respuestaserver_error | CondiciónLa respuesta devuelta indica que la operación o el resultado requiere una comprobación | Siguiente pasoConserva el ID original de operación o tarea devuelto, las cabeceras de la solicitud y la respuesta; continúa con las lecturas admitidas de esa operación original. No vuelvas a enviar la solicitud de creación. |
Alias
Alias del modelo
Ailoot Ultra recraft/recraft-v4.1-flash
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · Recraft: Recraft V4.1 Flash
- ¿Qué entradas y resultados están disponibles?
POST /v1/images/generations·recraft/recraft-v4.1-flash:text→image- ¿Qué campos utiliza la solicitud?
POST /v1/images/generations·recraft/recraft-v4.1-flash:model,prompt,n,response_format,stream