Recraft: Recraft V4.1 Utility Pro

Recraft V4.1 Utility Pro genererar rasterbilder i 2K med fokus på enkla, förutsägbara scener, jämn ljussättning och komposition rakt framifrån. Den passar detaljerade produktbilder och mockuper som behöver en tydlig presentation snarare än en uttrycksfull konstnärlig riktning.

Ailoot Ultra · Bilder POST /v1/images/generations recraft/recraft-v4.1-utility-pro

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 Utility Pro är rastervarianten med högre upplösning i Utility-grenen av Recraft V4.1. Tillverkaren skiljer Utilitys okomplicerade presentation från huvudmodellen V4.1:s mer uttrycksfulla val av vinkel, ljussättning och komposition. Utility föredrar enkla scener, jämn ljussättning och motiv rakt framifrån. Den passar därför produktlistningsbilder, mockuper och annat arbete där objektet ska vara lätt att avläsa och en lugn komposition tjänar uppgiften.

Den exakta modellkoden är recraftv4_1_utility_pro. Producentens referens anger rasterutdata i 2K med finare detaljer, i förlustfritt WebP eller PNG. Storlekstabellen anger 2048 × 2048 pixlar för kvadratiska bilder och 2432 × 1792 för 4:3, medan andra stödda bildförhållanden har sina egna mått. Detta skiljer Utility Pro från vanliga Utilitys utdata i 1K. Det gör inte bilden till en redigerbar vektorfil; en Vector-utgåva tillhandahåller SVG för det ändamålet.

Börja med en brief som anger objekt, material, betraktningsvinkel, bakgrund och de få detaljer som måste synas. För en produktlistning begär du en förvaringsburk i keramik sedd rakt framifrån på en ljus neutral yta, jämn belysning, stängt lock och tydligt utrymme runt silhuetten. Om scenen ska förbli okomplicerad säger du det uttryckligen i stället för att förlita dig på att Utility-namnet kodar alla presentationsval. För en serie listningsbilder håller du krav på inramning och bakgrund konsekventa medan produktbeskrivningen ändras.

Genereringsreferensen för V4.1 stöder prompter på upp till 10 000 tecken, kontroller för önskade färger och bakgrundsfärg, ett slumpfrö och ett till sex resultat. En kompatibel sparad stil eller valfria referensbilder kan vägleda utseendet; den särskilda familjen V4 Styles är den separata linje där en stil alltid är obligatorisk. För valfria referenser använder du tydliga tillgångar vars visuella riktningar stämmer överens. Exakt färgåtergivning från en referens garanteras inte, så ett krav på varumärkesfärg behöver fortfarande en uttrycklig brief och en kontroll av resultatet. För generering med referensstil använder du en till tio PNG-, JPG- eller WebP-bilder, sammanlagt högst 64 MB och under 20 MB vardera. Varje referens behöver en kortaste sida på minst 256 pixlar, en längsta sida på högst 4 096 pixlar och en upplösning på högst 16 megapixlar. Använd antingen dessa referenser eller en kompatibel sparad stil, inte båda. Vid generering med referensstil tillåter flexibel matchning en friare tolkning, medan exakt matchning följer rendering, palett, komposition och ljussättning närmare.

Recraft dokumenterar också bild-till-bild för V4.1-linjen, där en befintlig bild kombineras med en prompt och en styrka från 0 till 1. Lägre styrka håller sig närmare källan och ett högre värde tillåter en större förändring. Detta är användbart när utgångskompositionen eller motivet ska påverka en ny version. Den tar inte emot egna stilkontroller för V4.1 i samma omvandlingsoperation. Producentens gränser för bildindata är under 20 MB, upp till 16 MP och sidor mellan 256 och 4096 pixlar.

Utility Pro delar V4.1:s begränsningar för kontrollerna negative_prompt, kuraterade stilnamn, text_layout, artistic_level och no_text. Ge en positiv beskrivning av den avsedda scenen och lämna exakt text- eller layoutarbete till ett lämpligt slutbearbetningssteg när det behövs. Granska en produktbild avseende angivet material, form och nödvändiga detaljer innan du behandlar den som ett troget listningsmaterial. Det användbara resultatet är en större rasterkomposition förberedd för en tydlig produkt- eller mockupbrief, medan de exakta produktfakta förblir de som har tillhandahållits i uppgiften.

Ailoot Ultra · Bilder POST /v1/images/generations recraft/recraft-v4.1-utility-pro

recraft/recraft-v4.1-utility-pro

Recraft /recraft/recraft-v4.1-utility-pro

Start

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

Fält	Typ	Krav	Värden & gränser	Standard
Fält`model`	Typ`string`	KravObligatoriskt	Värden & gränser recraft/recraft-v4.1-utility-pro	Standard—
Fält`prompt`	Typ`string`	KravObligatoriskt	Värden & gränser Minsta längd: 1	Standard—
Fält`aspect_ratio`	Typ`string`	KravValfritt	Värden & gränser 1:1, 4:3, 3:4, 16:9, 9:16, auto	Standard—
Fält`n`	Typ`integer`	KravValfritt	Värden & gränser Minimum: 1 Maximum: 6	Standard—
Fält`input_references`	Typ`array`	KravValfritt	Värden & gränser Minsta antal objekt: 0 Maximalt antal objekt: 1	Standard—
Fält`provider`	Typ`object`	KravValfritt	Värden & gränser	Standard—

Metodparametrar och livscykel

Parameter	Avtal
Parameter`content_type`	Avtalapplication/json
Parameter`required`	Avtalmodel, prompt
Parameter`material_types`	Avtaltext, image

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}

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
Konfigurationutdatabild	Prislista—	Prognostiserad mängd—	Debiteringsenhetper utdatabild	Avgift Utdata · utdatabild · Uppskattning endast för jämförelse $0.42 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.42 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 →

Exempelbegäranden

Ailoot Ultra · Bilder

curl

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.1-utility-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

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}

Andra innehållsläsningar

Läs befintliga resurser som tillhör dig

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

Behåll alla färdiga resultat

Spara varje färdig bild; hämta varje returnerad URL eller avkoda dess Base64-innehåll.

Spara hela svaret med headers, samtliga faktiska resultat, de ursprungliga returnerade identifierarna och alla användningsfält. Hämta den ursprungliga operationen utan att skicka skapandeförfrågan igen.

Om det ursprungliga svaret behöver kontrolleras

Behåll det returnerade värdet för X-Client-Request-ID för avstämning. Läs endast av resultat via de task_id/asset_id-värden som faktiskt returnerades eller via det mediebibliotek som tillhör dig. Bygg aldrig en uppgifts-URL från operations-ID:t och skicka aldrig skapandeförfrågan igen.

Svarsfält

Fält	Typ
Fält`created`	Typ
Fält`data[].url`	Typ
Fält`data[].b64_json`	Typ
Fält`usage`	Typ

Alias

Modellalias

Ailoot Ultra recraft/recraft-v4.1-utility-pro

Alias för metodsökvägar

/v1/images

Relaterade anropar-ID:n

recraft/recraft-v4.1-utility-pro

FAQ · Recraft: Recraft V4.1 Utility Pro

Vilka indata och resultat finns?: POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: text, image → image
Vilka fält använder begäran?: POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: model, prompt, aspect_ratio, n, input_references, provider
Vilka gränser gäller?: POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4.1 Utility Pro