Recraft: Recraft V4.1 Flash
Recraft V4.1 Flash genererar rasterbilder i 1K från text för snabb visuell iteration. Den stöder fotografi, porträtt, komplexa scener och logotypkoncept, med PNG eller förlustfri WebP som utdata och uttryckliga färgönskemål.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
Recraft V4.1 Flash är Recrafts text-till-bild-modell för snabb iteration och visuellt arbete i stor volym. Tillverkaren identifierar fotografi, porträtt, atmosfär, komplexa scener, blandteknik och logotypkoncept som starka användningar. En skriven instruktion blir en rasterbild som kan jämföras med andra kreativa inriktningar innan slutmaterial utvecklas. Flash är en specifik medlem i V4.1-familjen med egen utdatastorlek och stödda kontroller.
Ursprungliga utdata hör till Recrafts rasterbildsklass 1K. Välj arbetsyta efter avsedd placering: en liggande illustration för ett sidhuvud, ett stående porträtt eller en kvadratisk bild för ett kompakt kort. Utdataformat är förlustfri WebP och PNG.
Börja instruktionen med huvudmotivet och det visuella syftet och beskriv sedan utsnitt, miljö, belysning och medium. För ett produktkoncept är en användbar instruktion: ”En kompakt gräddfärgad radio på ett valnötsskrivbord, trekvartsvy framifrån, mjukt fönsterljus, lugnt redaktionellt fotografi, generöst tomrum till vänster.” För en illustration anger du formspråk, palett och relation mellan elementen. Håll detaljerna som definierar idén uttryckliga i stället för att lägga till orelaterade adjektiv. Flashs dokumenterade promptutrymme är upp till 10 000 tecken, så en detaljerad scen kan beskrivas när uppgiften behöver det.
Tillverkarens kontroller omfattar önskade färger och önskad bakgrundsfärg. Ett seed kan anges för reproducerbara resultat och genereringsgränssnittet dokumenterar en till sex bilder i en förfrågan. Kontrollerna stöder en användbar jämförelseuppgift: håll motiv och komposition stabila, variera en visuell inriktning och granska resultatbilderna för avsedd layout. Färgönskemål beskriver det begärda resultatet; jämför viktiga varumärkesfärger med det färdiga materialet innan det kombineras med ett befintligt designsystem.
Flash producerar rastergrafik. Ett logotypkoncept kan hjälpa till att välja silhuett, stämning eller arrangemang, medan redigerbara banor hör till de separat namngivna Vector-modellerna. Flash har heller ingen Pro-variant. Den fullständiga V4.1-serien erbjuder dessa separata val när vektorredigering eller detaljer i högre upplösning är centrala för leveransen. Tillverkaren beskriver ett senare förfiningssteg för att föra ett valt utkast mot en mer detaljerad bild; steget är en separat operation, inte en annan ursprunglig utdatastorlek för Flash.
Denna utgåva stöder inte bild-till-bild-indata, egna stilar, stilidentifierare, stilmatchning eller stilreferensbilder. Det dokumenterade gränssnittet utesluter även negativa prompter och uttryckliga textlayoutkontroller. Skriv begärt utseende och komposition i den positiva instruktionen. När bokstäver ingår i ett koncept citerar du önskad ordalydelse och granskar de renderade bokstäverna; använd ett separat layoutsteg när exakt typografi och placering är avgörande.
Ett praktiskt resultat från Flash är en vald visuell inriktning med tydlig instruktion, lämpligt bildförhållande och användbar rasterfil. Jämför motiv, utsnitt, bakgrund och viktiga detaljer i den storlek där bilden ska visas. Behåll lyckad prompt och vald fil tillsammans så att nästa kreativa steg följer den valda inriktningen. Snabb iteration hjälper till att utforska designen; ursprungliga vektorutdata, referensstilsmatchning och upplösningen hos en annan V4.1-utgåva förblir separata modellval.
Ailoot Ultra · Bilder POST /v1/images/generations recraft/recraft-v4.1-flash
recraft/recraft-v4.1-flashStart
Recraft V4.1 Flash genererar rasterbilder i 1K från text för snabb visuell iteration. Den stöder fotografi, porträtt, komplexa scener och logotypkoncept, med PNG eller förlustfri WebP som utdata och uttryckliga färgönskemål.
- Godkända indata
- Text
- Resultat
- Bilder
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Bilder POST /v1/images/generations
- Indatatyper
text- Utdatatyper
image- Utdataformat
- Bildfil
- Antal utdata
- 1 utdata
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser recraft/recraft-v4.1-flash | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser Minsta längd: 1 Villkor: Icke-tom UTF8-prompt. Ingen generell teckengräns för tillverkaren hittas på. | Standard— |
Fältn | Typinteger | KravValfritt | Värden & gränser 1 | Standard1 |
Fältresponse_format | Typstring | KravValfritt | Värden & gränser url, b64_json | Standard— |
Fältstream | Typboolean | KravValfritt | Värden & gränser false | Standardfalse |
Kombinationer av indatamaterial
Text till bild · Krävs: prompt
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, prompt |
Parametermaterial_types | Avtaltext |
Parameteroptional | Avtaln, response_format, stream |
Parametern | Avtal1 |
Parameterstream | Avtalfalse |
Parameterresponse_format | Avtalurl, b64_json |
Parameterreference_images | Avtalfalse |
Parameteredit | Avtalfalse |
Parameteroutput_format_optional | Avtal |
Parameterresolution_control | Avtalnull |
Parameteraspect_ratio_control | Avtalnull |
Parameterother_fields | Avtalavvisas utom vid exakt låst intern leverantörsroutning |
Livscykel: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Det task_id som faktiskt returnerades eller en post i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Generera en bild från en prompt.
Spara varje datapost; url/b64_json är resultatkodningar.
Priser
Så beräknas slutavgiften
De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Uppskattade priser för jämförelse
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Prognostiserad mängd | Debiteringsenhet | Avgift |
|---|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad mängd— | Debiteringsenhet— | Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token |
| KonfigurationUltra | Prislista— | Prognostiserad mängd— | Debiteringsenhetper utdatabild | Avgift Utdata · bildutdata · Uppskattning endast för jämförelse $0.014 per utdatabild |
| KonfigurationUppskattad genereringskostnad | Prislista— | Prognostiserad mängduppskattning för en generering | Debiteringsenhet— | Avgift Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.014 uppskattning före generering Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen. |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Detaljer om referenstariffen
Referensprislistor på modellnivå ändrar inte metodval, prisuppgifter eller avgifter. Aktiva avgifter använder priserna för den valda Ailoot-metoden.
Priskonfigurationer för bilder
Priser efter konfiguration
| Konfiguration | Debiteringsvillkor | Avgift |
|---|---|---|
| KonfigurationUtdatabild | DebiteringsvillkorIngen prisvariant har deklarerats. | Avgift Utdata · Utdatabild $0.014 per bild Likvärdiga prisposter beskriver samma debitering; de lägger inte till en andra avgift. |
Exempelbegäranden
Ailoot Ultra · Bilder
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");
Ta emot och spara resultat
Ailoot Ultra · Bilder
Ladda ned varje returnerad bild eller spara dess Base64-innehåll
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Behåll alla färdiga resultat
Spara varje färdig bild; hämta varje returnerad URL eller avkoda dess Base64-innehåll.
Spara varje dataobjekt. Avkoda varje b64_json-värde eller hämta innehållet via varje returnerad signerad URL. Välj filändelse utifrån den faktiska MIME-typen och filens byteinnehåll.
Om det ursprungliga svaret behöver kontrolleras
Om resultatet av en bildgenerering eller bildredigering behöver kontrolleras ska du behålla de ursprungliga värdena för operation_id/X-Client-Request-ID och den returnerade resultatinformationen. Hämta befintliga resultat som tillhör dig genom mediebiblioteket med de faktiska task_id- eller asset_id-värdena. Skicka inte genererings- eller redigeringsförfrågan igen och bygg inte en URL för statusavläsning från operation_id.
Svarsfält
| Fält | Typ |
|---|---|
Fältcreated | Typinteger |
Fältdata[].url | Typstring |
Fältdata[].b64_json | Typbase64 string |
Fältusage | Typobject |
Fel och nästa steg
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar400 · invalid_request_error | VillkorOgiltiga obligatoriska fält, ogiltig representation av underlaget eller ogiltigt parametervärde | Nästa stegKorrigera de angivna fälten före en ny begäran om att skapa. |
Svarserver_error | VillkorDet returnerade svaret anger att operationen eller resultatet behöver kontrolleras | Nästa stegSpara det ursprungliga operations- eller uppgifts-ID som returnerades, förfrågans headers och svaret. Fortsätt att läsa den ursprungliga operationen med de läsmetoder som stöds. Skicka inte skapandeförfrågan igen. |
Alias
Modellalias
Ailoot Ultra recraft/recraft-v4.1-flash
Alias för metodsökvägar
Använd metodsökvägarna som visas ovan.
Relaterade anropar-ID:n
FAQ · Recraft: Recraft V4.1 Flash
- Vilka indata och resultat finns?
POST /v1/images/generations·recraft/recraft-v4.1-flash:text→image- Vilka fält använder begäran?
POST /v1/images/generations·recraft/recraft-v4.1-flash:model,prompt,n,response_format,stream