Recraft: Recraft V4 Pro
Recraft V4 Pro genererar rasterbilder i 2K för detaljerade kompositioner, fotorealism, illustration och tryckinriktat kreativt arbete. Den är V4-utgåvan med högre upplösning, med textinstruktioner, valfria stilindata och ett separat bild-till-bild-flöde.
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 Pro är rastermodellen med högre upplösning i Recrafts V4-familj. V4 fokuserar på visuellt omdöme, balanserad komposition, sammanhängande färg och noggrann tolkning av kreativ inriktning. Tillverkaren positionerar Pro för finare detaljer, mer realistiska komplexa scener och omfattande produktionsbilder. Använd den för en detaljerad illustration, redaktionell bild, affischidé eller annat material som gynnas av ett större rasterresultat. Den förblir separat från den senare modellen V4.1 och från SVG-utdata i V4 Pro Vector.
Tillverkarens specifika kod är recraftv4_pro. Dokumenterade utdata är raster i 2K som förlustfri WebP eller PNG: 2048 × 2048 pixlar för en kvadrat, 2688 × 1536 för 16:9 och 1664 × 2560 för 2:3. Andra stödda förhållanden har egna dimensioner. Välj ett bildförhållande för avsedd layout eller en exakt tillåten storlek; en godtycklig pixelstorlek ingår inte i det dokumenterade genereringskontraktet. Vanliga V4 har mindre rasterutdata i 1K, medan vektormodeller inte har någon fast pixelupplösning.
V4 kan tolka en kort prompt för utforskande eller en strukturerad prompt för ett kontrollerat resultat. För en specifik visuell inriktning går tillverkarguiden från motiv och miljö till utsnitt, egenskaper, rumsliga relationer, ljus, djup och stämning. För en redaktionell produktbild begär du ett dramatiskt stående fotografi av en skulptural stol, ytor i borstad metall, sidoljus, en lugn mörk bakgrund och utrymme ovanför föremålet för en titel. Genom att namnge relationerna blir avsedd komposition tydligare än med en allmän begäran om en exklusiv bild.
Familjens kreativa räckvidd omfattar berättande illustration, fotorealistiska scener och bilder med rumsligt djup som styrs av material och ljus. Ett resultat med 3D-utseende är fortfarande en bild, inte en redigerbar 3D-scen. För en grafisk affisch anger du visuella lager och deras samspel: bakgrund, illustration eller fotografi, rubrikhierarki och stödtext. V4 positioneras för läsbara korta och medellånga fraser, men färdig stavning och hierarki bör granskas snarare än härledas från modellnamnet.
Den nuvarande genereringsreferensen tillåter prompter på upp till 10 000 tecken, en till sex utdata, ett slumpseed och kontroller för önskad färg och bakgrundsfärg. Valfria egna stilar eller kompatibla referensbilder kan styra utseende med flexibel eller precis matchning. Modellen tar inte emot de äldre V3-kontrollerna negative_prompt, kurerade stilar, text_layout, artistic_level eller no_text. Beskriv avsedd slutbild i den positiva prompten och håll motiv-, layout- och färgkrav uttryckliga. För generering med referensstil använder du en till tio PNG-, JPG- eller WebP-bilder, högst 64 MB sammanlagt och under 20 MB per bild. Varje referens behöver en kortsida på minst 256 pixlar, en långsida på högst 4 096 pixlar och upplösning på högst 16 megapixlar. Använd antingen dessa referenser eller en kompatibel sparad stil, inte båda.
Recraft dokumenterar en separat bild-till-bild-operation för V4. Den kombinerar en befintlig bild och en prompt med styrka från 0 till 1 för att kontrollera graden av ändring och tar inte emot kontroller för egna V4-stilar i operationen. Förbered källan inom tillverkarens bildindatagränser och ange egenskaperna som ska föras över till det nya resultatet. För ett större slutmaterial kontrollerar du fina detaljer, beskärning och bokstäver i avsedd storlek. Pros extra rasterdetaljer stöder granskningen, medan bilden förblir en genererad tolkning av den inskickade kreativa instruktionen. För bild-till-bild anger du PNG, JPG, WebP eller SVG under 20 MB, högst 16 megapixlar, med båda sidor mellan 256 och 4 096 pixlar.
Ailoot Ultra · Bilder POST /v1/images/generations recraft/recraft-v4-pro
recraft/recraft-v4-proStart
Recraft V4 Pro genererar rasterbilder i 2K för detaljerade kompositioner, fotorealism, illustration och tryckinriktat kreativt arbete. Den är V4-utgåvan med högre upplösning, med textinstruktioner, valfria stilindata och ett separat bild-till-bild-flöde.
- Godkända indata
- Text · Bilder
- Resultat
- Bilder
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Bilder POST /v1/images/generations
- Indatatyper
text,image- Utdatatyper
image- Utdataformat
- Bildfil
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser recraft/recraft-v4-pro | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser Minsta längd: 1 | Standard— |
Fältn | Typinteger | KravValfritt | Värden & gränser Minimum: 1 Maximum: 6 | Standard— |
Fältaspect_ratio | Typstring | KravValfritt | Värden & gränser 1:1, 4:3, 3:4, 16:9, 9:16, auto | Standard— |
Fältinput_references | Typarray | KravValfritt | Värden & gränser Minsta antal objekt: 0 Maximalt antal objekt: 1 | Standard— |
Kombinationer av indatamaterial
Text till bild · Krävs: prompt
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, prompt |
Parametermaterial_types | Avtaltext, image |
Parameteroptional_controls | Avtalaspect_ratio, n, input_references |
Parameterexact_supported_parameters | Avtal{"aspect_ratio":{"type":"enum","values":["1:1","4:3","3:4","16:9","9:16","auto"]},"n":{"type":"range","min":1,"max":6},"input_references":{"type":"range","min":0,"max":1}} |
Parameterreference_material_rule | AvtalEndast kundens faktiska bildreferenser; leverantörens villkor för ändpunkten styr dem. |
Metodalias: /v1/images
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}
Använd den exakta modellen och de dokumenterade indatafälten.
Behåll hela svaret, varje faktiskt resultat och ursprungliga returnerade ID:n.
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.5 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.5 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.5 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={'model': 'recraft/recraft-v4-pro', '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
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-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
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-pro", "prompt": "a red panda astronaut floating in space, studio lighting"};
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.
Behåll varje datapost och fullständiga förbrukningsuppgifter; säkerställ ägande och spara alla faktiskt returnerade bilder. Inga påhittade URL:er eller ID:n.
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 |
Alias
Modellalias
Ailoot Ultra recraft/recraft-v4-pro
Alias för metodsökvägar
/v1/images
Relaterade anropar-ID:n
FAQ · Recraft: Recraft V4 Pro
- Vilka indata och resultat finns?
POST /v1/images/generations·recraft/recraft-v4-pro:text,image→image- Vilka fält använder begäran?
POST /v1/images/generations·recraft/recraft-v4-pro:model,prompt,n,aspect_ratio,input_references- Vilka gränser gäller?
POST /v1/images/generations·recraft/recraft-v4-pro:n.minimum:1;n.maximum:6