Recraft: Recraft V4.1 Utility

A Recraft V4.1 Utility 1K raszterképeket generál egyszerű termékfelvételekhez, mockupokhoz és egyszerű jelenetekhez. Egyenletes világítást és szemből komponált képet részesít előnyben, szöveges promptokkal és opcionális képi vagy stílusbemenetekkel a kiszámítható vizuális irányhoz.

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

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 a Recraft V4.1 családjának normál raszteres Utility modellje. Egyszerű jeleneteket, egyenletes világítást és szemből komponált képet részesít előnyben a fő V4.1 modell kifejezőbb nézőszög-, fény- és hangulatválasztásaival szemben. Gyakorlati szerepe tiszta termékfelvétel vagy mockup, amelyben a tárgy és a szükséges részletek dominálnak. A pontos Utility kiadás elkülönül a Utility Prótól, a fő V4.1 modelltől és az SVG-t készítő vektorváltozatoktól.

A gyártói modellkód recraftv4_1_utility. 1K raszterképeket ad vissza veszteségmentes WebP vagy PNG formátumban, a támogatott oldalarányokhoz tartozó méretekkel. A négyzetes kép 1024 × 1024, a 4:3-as kép 1216 × 896 pixeles. A Pro Utility kiadás nagyobb, 2K méreteket használ, ezért azokat ne rendeld a normál Utilityhez. A jelenet leírása előtt válaszd ki a tervezett terméklista-kép vagy mockup alakját.

A hasznos leírás egyszerű szavakkal nevezi meg a terméket, nézőpontot, anyagot, felületet, hátteret és világítást. Terméklistához kérj szemből látható hőszigetelt palackot világos háttéren, egyenletesen megvilágítva, teljes látható sziluettel és zavaró jelenetelemek nélkül. Ha a terméknek tényszerű méretei vagy jellegzetes részei vannak, ezeket kifejezetten add meg. A Utility egyszerű bemutatást előnyben részesítő jellege nem állapít meg a leírásból hiányzó tényeket egy valós termékről.

A generálás legfeljebb 10 000 karakteres promptot, preferált szín- és háttérszín-vezérlőt, véletlen seedet és egy–hat kimenetet támogat. Opcionális kompatibilis egyéni stílusok vagy referenciaképek irányíthatják a katalógus vizuális nyelvét. Egyező világítású és képi megoldású referenciaanyagokat használj, és a következő termékleírásokhoz tartsd meg ugyanazt a kompatibilis stílust. A referencia és kimenet pontos színegyezése nem garantált, ezért a végső vizuált vesd össze a szükséges palettával. Referenciastílusú generáláshoz egy–tíz PNG, JPG vagy WebP képet használj, összesen legfeljebb 64 MB-tal és egyenként 20 MB alatt. Minden referencia legrövidebb oldala legalább 256, leghosszabb oldala legfeljebb 4 096 pixel, felbontása legfeljebb 16 megapixel legyen. E referenciák vagy kompatibilis mentett stílus valamelyikét használd, ne mindkettőt. Referenciastílusú generálásnál a flexible illesztés lazább értelmezést enged, a precise szorosabban követi a képi megoldást, palettát, kompozíciót és világítást.

A külön kép-kép munkafolyamat meglévő képet és promptot használ, a változás mértékét 0–1 közötti strength szabályozza. Kisebb strength közelebb tartja az eredményt a forráshoz, nagyobb távolabb engedi. Bemenete PNG, JPG, WebP vagy SVG lehet 20 MB alatt, legfeljebb 16 MP-rel és 256–4096 pixeles oldalakkal. Ezen átalakítási műveletben nem fogad el V4.1 egyéni stílusokat; ez elkülönül az új generáláshoz csatolt stílusreferenciától.

A V4.1 Utility nem fogad kurált stílusneveket, negative_prompt, text_layout, artistic_level vagy no_text vezérlőket. A kívánt kész jelenetet közvetlenül a pozitív promptban add meg. Termékképsorozatnál a képkivágási és háttérutasítások maradjanak stabilak, majd elrendezésben való használat előtt minden képet vesd össze a megadott termékalakkal, anyaggal és részletekkel. A normál Utility célzott raszteres eszköz visszafogott bemutatáshoz; a konkrét kimeneti formátumot és kiadást a feladathoz válaszd.

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

recraft/recraft-v4.1-utility

Recraft /recraft/recraft-v4.1-utility

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	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.07 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.07 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', '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

Metódusútvonalak álnevei

/v1/images

Kapcsolódó modellazonosítók

recraft/recraft-v4.1-utility

FAQ · Recraft: Recraft V4.1 Utility

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

Recraft: Recraft V4.1 Utility