Recraft: Recraft V4.1 Utility Pro

A Recraft V4.1 Utility Pro 2K raszterképeket generál, egyszerű, kiszámítható jelenetekre, egyenletes világításra és szemből ábrázoló kompozícióra összpontosítva. Részletes termékfotókhoz és látványtervekhez illik, amikor kifejező művészi irány helyett világos bemutatásra van szükség.

Ailoot Ultra · Képek POST /v1/images/generations recraft/recraft-v4.1-utility-pro

A modellről

Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.

A Recraft V4.1 Utility Pro a Recraft V4.1 Utility ágának nagyobb felbontású raszteres változata. A gyártó a Utility egyszerű bemutatását megkülönbözteti a fő V4.1 modell kifejezőbb nézőpont-, világítás- és kompozícióválasztásaitól. A Utility az egyszerű jeleneteket, az egyenletes világítást és a szemből látható témákat részesíti előnyben. Ezért terméklisták vizuáljaihoz, látványtervekhez és más olyan munkákhoz illik, ahol a tárgynak könnyen értelmezhetőnek kell lennie, és a nyugodt kompozíció szolgálja a feladatot.

A pontos modellkód recraftv4_1_utility_pro. A gyártó referenciája részletgazdagabb, 2K raszteres kimenetet sorol fel, veszteségmentes WebP- vagy PNG-formátumban. A mérettáblázat négyzetes képnél 2048 × 2048 képpontot, 4:3 aránynál 2432 × 1792 képpontot ad meg; a többi támogatott képarány saját méretekkel rendelkezik. Ez különbözteti meg a Utility Prót a normál Utility 1K kimenetétől. A képet nem alakítja szerkeszthető vektorfájllá; erre a célra a Vector kiadás biztosít SVG-t.

Olyan leírással kezdjen, amely megnevezi a tárgyat, az anyagot, a nézőpontot, a hátteret és azt a néhány részletet, amelynek láthatónak kell lennie. Terméklistához kérjen szemből látható kerámia tárolóedényt világos, semleges felületen, egyenletes megvilágítással, zárt fedéllel és a körvonala körül hagyott üres térrel. Ha a jelenetnek egyszerűnek kell maradnia, ezt mondja ki kifejezetten, ne bízza az összes bemutatási döntést a Utility elnevezésre. Terméklistaképek sorozatánál tartsa egységesen a képkivágás és a háttér követelményeit, miközben a termékleírást változtatja.

A V4.1 generálási referencia legfeljebb 10 000 karakteres promptokat, preferált színre és háttérszínre vonatkozó vezérlőket, véletlen seedet és egytől hatig terjedő kimeneti darabszámot támogat. Kompatibilis mentett stílus vagy opcionális referenciaképek irányíthatják a megjelenést; a külön V4 Styles családban viszont mindig kötelező a stílus. Opcionális referenciákhoz jól kivehető, egymással összhangban álló vizuális irányú anyagokat használjon. A referencia pontos színvisszaadása nem garantált, ezért a márkaszínre vonatkozó követelményt továbbra is kifejezetten le kell írni, és a kimeneten ellenőrizni kell. Referenciastílus-alapú generáláshoz egytől tízig terjedő számú PNG-, JPG- vagy WebP-képet használjon, összesen legfeljebb 64 MB, képenként 20 MB alatti mérettel. Minden referencia legrövidebb oldalának legalább 256 képpontosnak, leghosszabb oldalának legfeljebb 4096 képpontosnak, felbontásának pedig legfeljebb 16 megapixelesnek kell lennie. Vagy ezeket a referenciákat, vagy kompatibilis mentett stílust használjon, a kettőt együtt ne. Referenciastílus-alapú generálásnál a rugalmas illesztés szabadabb értelmezést enged, míg a pontos illesztés szorosabban követi a megjelenítést, a palettát, a kompozíciót és a világítást.

A Recraft a V4.1 termékcsaládhoz kép-kép átalakítást is dokumentál, amely meglévő képet és promptot egyesít 0 és 1 közötti strength értékkel. Az alacsonyabb érték közelebb marad a forráshoz, a magasabb nagyobb változtatást enged. Ez akkor hasznos, ha az új változatot a kiinduló kompozíciónak vagy témának kell meghatároznia. Ugyanez az átalakítási művelet nem fogadja el a V4.1 egyéni stílusvezérlőit. A gyártó képbemeneti korlátai: 20 MB alatti méret, legfeljebb 16 MP és 256–4096 képpont közötti oldalak.

A Utility Pro osztozik a V4.1 negative_prompt, válogatott stílusnevek, text_layout, artistic_level és no_text vezérlőkre vonatkozó korlátozásain. A kívánt jelenetet pozitív leírással adja meg, a pontos feliratozást vagy elrendezési munkát pedig szükség esetén megfelelő befejező lépésre hagyja. Mielőtt hű terméklistaanyagként kezelné a termékvizuált, ellenőrizze a megadott anyagot, alakot és szükséges részleteket. A használható eredmény világos termék- vagy látványtervi leíráshoz előkészített, nagyobb raszteres kompozíció; a pontos terméktényeket továbbra is a feladatban megadott adatok határozzák meg.

Ailoot Ultra · Képek POST /v1/images/generations recraft/recraft-v4.1-utility-pro

recraft/recraft-v4.1-utility-pro

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

Kezdő lépések

Elfogadott bemenetek: Szöveg · Képek
Eredmények: Képek

Elérhető az Ailootban · bemenetek és metódusok

Ailoot Ultra · Képek POST /v1/images/generations

Bemenet: text, image
Kimenet: image

Mező	Típus	Követelmény	Értékek és korlátok	Alapértelmezett
Mező`model`	Típus`string`	KövetelményKötelező	Értékek és korlátok recraft/recraft-v4.1-utility-pro	Alapértelmezett—
Mező`prompt`	Típus`string`	KövetelményKötelező	Értékek és korlátok Minimális hossz: 1	Alapértelmezett—
Mező`aspect_ratio`	Típus`string`	KövetelményOpcionális	Értékek és korlátok 1:1, 4:3, 3:4, 16:9, 9:16, auto	Alapértelmezett—
Mező`n`	Típus`integer`	KövetelményOpcionális	Értékek és korlátok Minimum: 1 Maximum: 6	Alapértelmezett—
Mező`input_references`	Típus`array`	KövetelményOpcionális	Értékek és korlátok Minimális elemszám: 0 Maximális elemszám: 1	Alapértelmezett—
Mező`provider`	Típus`object`	KövetelményOpcionális	Értékek és korlátok	Alapértelmezett—

Metódus paraméterei és életciklusa

Paraméter	Szerződés
Paraméter`content_type`	Szerződésapplication/json
Paraméter`required`	Szerződésmodel, prompt
Paraméter`material_types`	Szerződéstext, image

Életciklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · A ténylegesen visszaadott task_id vagy a médiatár bejegyzése

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Díjcsomagok

A végső díj számítása

A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.

A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.

Gyors mód: Nincs megadva Ha a gyors mód van kiválasztva
Flex mód: Nincs megadva Ha a flex mód van kiválasztva
Maximális gondolkodási ráfordítás: Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik

Becsült díjak összehasonlításhoz

Árak beállításonként

Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.

Beállítás	Díjtáblázat	Előre jelzett mennyiség	Elszámolási egység	Díj
BeállításTokenek alapdíjai	DíjtáblázatAlapdíj	Előre jelzett mennyiség—	Elszámolási egység—	Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token
Beállításkimeneti kép	Díjtáblázat—	Előre jelzett mennyiség—	Elszámolási egységkimeneti képenként	Díj Kimenet · kimeneti kép · Becslés, csak összehasonlításra $0.42 kimeneti képenként
BeállításA generálás becsült költsége	Díjtáblázat—	Előre jelzett mennyiségbecslés egy generálásra	Elszámolási egység—	Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.42 becslés a generálás előtt Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra.

Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →

Példakérések

Ailoot Ultra · Képek

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

Eredmények fogadása és mentése

Ailoot Ultra · Képek

Töltsön le minden visszaadott képet, vagy mentse a Base64-tartalmat

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

További tartalomlekérések

A meglévő, Önhöz tartozó médiafájlok lekérése

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.

Őrizzen meg minden elkészült eredményt

Mentsen minden elkészült képet; töltse le az összes visszaadott URL tartalmát, vagy dekódolja a Base64-tartalmat.

Őrizze meg a teljes választ és a fejléceket, minden tényleges kimenetet, az eredetileg visszaadott azonosítókat és az összes használati adatmezőt. Az eredeti műveletet állítsa helyre, a létrehozási kérés újbóli beküldése nélkül.

Ha az eredeti választ ellenőrizni kell

Őrizze meg a visszaadott X-Client-Request-ID értéket az egyeztetéshez. Csak a ténylegesen visszaadott task_id/asset_id értékekkel kérdezzen le, vagy használja a saját médiatárat; soha ne állítson össze feladat-URL-t a műveletazonosítóból, és soha ne küldje be újra a létrehozási kérést.

Válaszmezők

Mező	Típus
Mező`created`	Típus
Mező`data[].url`	Típus
Mező`data[].b64_json`	Típus
Mező`usage`	Típus

Álnevek

Modell álnevei

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

Metódusútvonalak álnevei

/v1/images

Kapcsolódó modellazonosítók

recraft/recraft-v4.1-utility-pro

FAQ · Recraft: Recraft V4.1 Utility Pro

Milyen bemenetek és eredmények érhetők el?: POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: text, image → image
Mely mezőket használja a kérés?: POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: model, prompt, aspect_ratio, n, input_references, provider
Milyen korlátok érvényesek?: POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4.1 Utility Pro