modeller

Recraft: Recraft V4

Markdown · JSON

Recraft: Recraft V4

Recraft V4 genererar rasterbilder i 1K med fokus på komposition, färgrelationer och detaljerad kreativ styrning. Den täcker illustration, fotorealistiska scener och grafiska designkoncept, med 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 är standardmodellen för rasterbilder i Recrafts V4-generation. Tillverkaren betonar designomdöme: balanserad komposition, sammanhängande färgrelationer och detaljer som stöder den visuella avsikten. Den kan arbeta med stiliserad illustration, fotografiska scener och grafiska designkoncept. Använd den när instruktionen kräver en bild som kombinerar estetiska val med promptprecision, oavsett om en stämning utforskas från en kort instruktion eller en medveten layout specificeras i detalj.

Den specifika modellkoden är recraftv4. Tillverkarens referens listar rasterutdata i 1K som förlustfri WebP eller PNG. En kvadratisk bild är 1024 × 1024 pixlar, 16:9 är 1344 × 768 och 2:3 är 832 × 1280; andra stödda förhållanden använder egna dimensioner. V4 Pro är den separata rasterutgåvan i 2K, medan V4 Vector och Pro Vector returnerar redigerbar SVG. Välj exakt V4-variant efter avsedd leverans i stället för att kombinera de olika utdataegenskaperna.

Tillverkarguiden skiljer korta tolkande prompter från strukturerad kreativ styrning. En kort fras kan lämna utrymme att utforska form, stämning och utsnitt. En strukturerad instruktion kan ange motiv, miljö, pose, material, sekundära element, ljus och visuell hierarki. För en berättande illustration beskriver du en cyklist som korsar en liten bro, starka förenklade former, varma dämpade färger och tydlig rörelse från vänster till höger. Dessa beslut om innehåll och komposition är mer handlingsbara än en lång lista med orelaterade stiladjektiv.

V4:s register omfattar illustration, bilder med rumsligt djup och fotorealistiska bilder. Guiden rekommenderar att beskriva teckningslogik för illustration och material, ljus, kamera och djup för en bild med 3D-utseende. Den senare förblir en rasterbild snarare än ett redigerbart mesh. För en affisch eller ett förpackningskoncept anger du vilka ord som är primära, var de hör hemma och hur bild och typografi samverkar. Tillverkaren framhäver läsbar kort och medellång text; granska faktisk ordalydelse och arrangemang i den returnerade bilden före användning.

Generering stöder prompter på upp till 10 000 tecken, ett slumpseed, en till sex utdata, önskade färger och önskad bakgrundsfärg. Valfria kompatibla egna stilar och referensbilder kan styra den visuella behandlingen genom flexibel eller precis matchning. Välj en tydlig referens eller en uppsättning som hör till samma visuella värld och låt sedan prompten beskriva det nya motivet och scenen. Färgmatchning mellan referens och utdata garanteras inte, så håll nödvändig palett uttrycklig och jämför resultatet med den. 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.

Den dokumenterade bild-till-bild-operationen kombinerar en befintlig bild och en prompt, med styrka från 0 till 1 som avgör hur långt nya utdata rör sig från källan. Den tar inte emot V4-stilkontroller i operationen. Den nuvarande genereringsreferensen utesluter också kurerade stilnamn, negative_prompt, text_layout, artistic_level och no_text. Förbered en positiv beskrivning av önskat resultat och bedöm materialet inom målkompositionen. Vanliga V4 ger en fokuserad rasterbaserad designtolkning med en specifik utgåva, format och utdatastorlek. 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

recraft/recraft-v4

Recraft /recraft/recraft-v4

Start

Recraft V4 genererar rasterbilder i 1K med fokus på komposition, färgrelationer och detaljerad kreativ styrning. Den täcker illustration, fotorealistiska scener och grafiska designkoncept, med 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ältTypKravVärden & gränserStandard
FältmodelTypstringKravObligatorisktVärden & gränser
recraft/recraft-v4
Standard—
FältpromptTypstringKravObligatorisktVärden & gränser
Minsta längd: 1
Standard—
FältnTypintegerKravValfrittVärden & gränser
Minimum: 1
Maximum: 6
Standard—
Fältaspect_ratioTypstringKravValfrittVärden & gränser
1:1, 4:3, 3:4, 16:9, 9:16, auto
Standard—
Fältinput_referencesTyparrayKravValfrittVärden & gränser
Minsta antal objekt: 0
Maximalt antal objekt: 1
Standard—
Kombinationer av indatamaterial

Text till bild · Krävs: prompt

reference_guided_image · Krävs: prompt, actual image reference

Metodparametrar och livscykel
ParameterAvtal
Parametercontent_typeAvtalapplication/json
ParameterrequiredAvtalmodel, prompt
Parametermaterial_typesAvtaltext, image
Parameteroptional_controlsAvtaln, aspect_ratio, input_references
ParameternAvtal{"minimum":1,"maximum":6}
Parameterreference_imagesAvtal{"minimum":0,"maximum":1,"source":"faktiskt material från kunden"}
Parameterprovider_specific_optionsAvtalEndast den sparade exakta tillåtelselistan för ändpunkten med style/controls/text_layout; inga gissade strukturer.

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}

Exemplet med enbart prompt bevarar den officiella strukturen ImageGenerationRequest.

Behåll varje returnerad bild och hela svaret; antalet resultat är det faktiska och inte det begärda 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.

KonfigurationPrislistaPrognostiserad mängdDebiteringsenhetAvgift
KonfigurationGrundpriser för tokenPrislistaGrundprisPrognostiserad 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
KonfigurationUltraPrislista—Prognostiserad mängd—Debiteringsenhetper utdatabildAvgift
Utdata · utdatabild · Uppskattning endast för jämförelse $0.08 per utdatabild
KonfigurationUppskattad genereringskostnadPrislista—Prognostiserad mängduppskattning för en genereringDebiteringsenhet—Avgift
Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.08 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

KonfigurationDebiteringsvillkorAvgift
KonfigurationUtdatabildDebiteringsvillkorIngen prisvariant har deklarerats.Avgift
Utdata · Utdatabild $0.08 per bild

Likvärdiga prisposter beskriver samma debitering; de lägger inte till en andra avgift.

Exempelbegäranden

Ailoot Ultra · Bilder

curlPython SDKNode.js SDK
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', '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', '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", "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}/content
  • GET /v1/media/assets
  • GET /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ältTyp
FältcreatedTypinteger
Fältdata[].urlTypstring
Fältdata[].b64_jsonTypbase64 string
FältusageTypobject
Fel och nästa steg
SvarVillkorNästa steg
Svar400 · invalid_request_errorVillkorOgiltiga obligatoriska fält, ogiltig representation av underlaget eller ogiltigt parametervärdeNästa stegKorrigera de angivna fälten före en ny begäran om att skapa.
Svarserver_errorVillkorDet returnerade svaret anger att operationen eller resultatet behöver kontrollerasNä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

Alias för metodsökvägar

/v1/images

Relaterade anropar-ID:n

recraft/recraft-v4

FAQ · Recraft: Recraft V4
Vilka indata och resultat finns?

POST /v1/images/generations · recraft/recraft-v4: text, image → image

Vilka fält använder begäran?

POST /v1/images/generations · recraft/recraft-v4: model, prompt, n, aspect_ratio, input_references

Vilka gränser gäller?

POST /v1/images/generations · recraft/recraft-v4: n.minimum: 1; n.maximum: 6

Fler detaljer

Anslut Ailoot till Claude Code, OpenCode, Hermes eller din app.

Företaget och dess projektportfölj

Företaget och dess projektportfölj: miljontals kunder; månatlig försäljning för miljarder.

Köp token med rabatt.

Prenumerationsrabatt för återkommande arbete. Kampanjkoder ger upp till 50% vid tokenköp.

Prenumeration
Välj en rabatterad plan för återkommande anrop.
Kampanjkod upp till 50%
Ange koden vid köpet. Priset räknas om enligt kampanjen.
Kostnader i historiken
Modell, token och belopp sparas för varje anrop.

Välj prenumeration · Se modellpriser

Anslut API till produkten som du säljer.

SaaS, appar och botar enligt Ailoots officiella villkor och licensavtal. Begär återförsäljarlicens för vidareförsäljning.

Kommersiell applikation
Bygg text-, bild-, video- och ljudgenerering i tjänstens betalda funktioner.
Återförsäljarlicens
Skicka projektbeskrivning och åtkomstupplägg. Begär skriftliga villkor för användning och vidareförsäljning.
Dokument på webbplatsen
Officiella villkor, licensavtal och databehandlingspolicy finns tillgängliga före anslutning.

Begär återförsäljarlicens · Officiella villkor och licensavtal