Recraft: Recraft V4.1 Flash
Recraft V4.1 Flash genera imágenes ráster 1K a partir de texto para iteración visual rápida. Admite fotografía, retratos, escenas complejas y conceptos de logotipo, con salida PNG o WebP sin pérdida 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 fotografía, retratos, atmósfera, escenas complejas, técnicas mixtas y conceptos de logotipo como usos destacados. Un brief escrito se convierte en una imagen ráster que puede compararse con otras direcciones creativas antes de desarrollar un recurso final. Flash es un integrante 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 un encabezado de página, un retrato vertical o una imagen cuadrada para una tarjeta compacta. Los formatos de salida son WebP sin pérdida y PNG.
Comienza el brief con el sujeto principal y el propósito visual; después describe encuadre, entorno, iluminación y técnica. Para un concepto de producto, una instrucción útil es: “Un radio compacto color crema sobre un escritorio de nogal, vista frontal de tres cuartos, luz suave de ventana, fotografía editorial tranquila, espacio vacío generoso a la izquierda”. Para una ilustración, identifica el lenguaje de formas, la paleta y la relación entre elementos. Explicita los detalles que definen la idea en lugar de añadir adjetivos sin relación. El límite documentado de prompt de Flash es de hasta 10,000 caracteres, así que puede describirse una escena detallada cuando la tarea lo necesite.
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 entre una y seis imágenes por solicitud. Estos controles permiten una comparación útil: mantén estables sujeto y composición, varía una dirección visual y revisa las imágenes resultantes para la composició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 silueta, ambiente o disposición, mientras que los trazados editables pertenecen a los modelos denominados Vector por separado. Flash tampoco tiene una variante Pro. La línea completa V4.1 ofrece esas opciones independientes cuando la edición vectorial o el detalle de mayor resolución son centrales para el entregable. El fabricante describe un paso posterior de perfeccionamiento para llevar un borrador elegido hacia una imagen más detallada; ese paso es una operación distinta, no un tamaño diferente 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 composición de texto. Incluye la apariencia y composición solicitadas en el brief positivo. Cuando las letras formen parte de un concepto, escribe el texto previsto entre comillas y revisa las letras representadas; usa una etapa independiente de composición cuando sean esenciales tipografía y ubicación exactas.
Un resultado práctico de Flash es una dirección visual seleccionada con un brief claro, una relación de aspecto apropiada y un archivo ráster utilizable. Compara sujeto, encuadre, fondo y detalles importantes al tamaño en 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 con estilo de referencia y la resolución de otra edición V4.1 siguen siendo elecciones de modelo independientes.
Ailoot Ultra · Imágenes POST /v1/images/generations recraft/recraft-v4.1-flash
recraft/recraft-v4.1-flashInicio
Recraft V4.1 Flash genera imágenes ráster 1K a partir de texto para iteración visual rápida. Admite fotografía, retratos, escenas complejas y conceptos de logotipo, con salida PNG o WebP sin pérdida 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
- Entrada
text- 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 UTF8 no vacía. No se inventa un 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 el enrutamiento interno exacto y fijado del proveedor |
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}
Genera una imagen a partir de una instrucción.
Guarda todos los elementos de data; url/b64_json son codificaciones del resultado.
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ó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ónCosto estimado de generación | Tabla de tarifas— | Cantidad previstaestimación para una generación | Unidad de facturación— | Cargo Salida · Costo 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 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 →
Detalles de la tarifa de referencia
Las tablas de referencia del modelo no cambian la selección del método, las cotizaciones ni los cargos. Los cargos aplicados usan las tarifas del método Ailoot seleccionado.
Configuraciones de precios de imágenes
Precios por configuración
| Configuración | Condiciones de facturación | Cargo |
|---|---|---|
| ConfiguraciónImagen de salida | Condiciones de facturaciónNo se declara ninguna variante de precios. | Cargo Salida · Imagen de salida $0.014 por imagen Los listados equivalentes describen el mismo cargo; no agregan 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 cada elemento de data. Decodifica cada b64_json o descarga el contenido de cada URL firmada devuelta. Elige la extensión del archivo según el MIME y 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 revisión, conserva el operation_id/X-Client-Request-ID original y la información del resultado devuelto. Recupera los resultados existentes de tu propiedad mediante la biblioteca multimedia usando valores reales de task_id o asset_id. No vuelvas a enviar la solicitud de generación o edición ni construyas una URL de consulta de estado 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 revisión | Siguiente pasoConserva el ID original de operación o tarea devuelto, los encabezados de la solicitud y la respuesta; continúa con las consultas 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