Recraft: Recraft V4 Styles

A Recraft V4 Styles referenciák által meghatározott vizuális stílusban generál 1K raszterképeket. Mindennapi márka- és kampánymunkához készült, ahol minden új témának meg kell tartania ugyanazt a képi megoldást, textúrát és összképet.

Ailoot Ultra · Képek POST /v1/images/generations recraft/recraft-v4-styles

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 Styles a Recraft különálló, stíluskövetkezetes generálási családjának normál raszteres kiadása. Szöveges promptból készít új képet, referenciaanyagokkal rögzített stílust követve. Olyan illusztráció-, banner- vagy termékjelenet-sorozathoz hasznos, amelynek elemei egységes, felismerhető vizuális megjelenést követnek. A referencia hordozza a képi kidolgozást, textúrát és színlogikát; a prompt minden új anyagnál bevezeti a témát és jelenetet.

A gyártó 1K raszterkimenetet sorol fel veszteségmentes WebP vagy PNG formátumban. A négyzetméret 1024 × 1024, a dokumentált 16:9 méret 1344 × 768 pixel; álló és más támogatott arányok saját méreteket használnak. E kiadás elkülönül a Styles Pro 2K raszterkimenetétől és az SVG-t készítő Vector modellektől. A végső elrendezéshez válassz oldalarányt, ne feltételezd, hogy az 1K címke minden képnél azonos szélességet és magasságot jelent.

A stílus kötelező. Használj egy–tíz PNG, JPG vagy WebP referenciát, vagy korábbi stíluslétrehozásból mentett kompatibilis stílust. A dokumentált folyamat nem fogad együtt mentett stílusazonosítót és új referenciákat. Referencia lehet meglévő márka- vagy kampányanyag, nem szükségképpen eredetileg Recrafttal generált kép. Fájlonként 20 MB alatt, összesen legfeljebb 64 MB-osak legyenek. A stílus használatához nincs külön, felhasználó által futtatott tanítási feladat. Minden referencia legrövidebb oldala legalább 256, leghosszabb oldala legfeljebb 4 096 pixel, teljes felbontása legfeljebb 16 megapixel legyen.

Indulj egy erős referenciából vagy több, már közös vizuális nyelvű referenciából. Következetes referenciák segítik a stílus egyetlen tárgyon vagy pózon túli alkalmazását; független moodboard versengő motívumokat vezethet be. Alapértelmezett a flexible illesztés, több értelmezési térrel; a precise szorosabban követi a referencia képi megoldását, palettáját, kompozícióját és világítását. A pontos színreprodukció továbbra sem garantált.

Bannersorozathoz írd le, ahogy futár csomagot helyez egy küszöbre, nyugodt vízszintes kompozíciót és az egyik oldalon szabad helyet későbbi szövegnek. A következő leírások az eseményt vagy kameraszöget változtathatják azonos stílus megtartásával. A gyártó legfeljebb 10 000 karakteres promptot, preferált színeket, kívánt háttérszínt, véletlen seedet és egy–hat képet enged. Nem támogat negative_prompt vagy text_layout vezérlőt, illetve kurált stílusneveket, ezért a kívánt témát és elrendezést közvetlenül a leírásban add meg.

A Styles termékvonal nem kínál kép-kép módot vagy inpaintinget. A stílusreferencia újonnan generált képet irányít, nem garantálja a referencia tárgyainak vagy pixeleinek megőrzését. Ha a sorozat ismétlődőnek hat, a pózt, cselekvést, képkivágást vagy jelenetrészletet módosítsd ellentmondó referencia hozzáadása helyett. Minden eredményt a kívánt elrendezésében értékelj a téma világossága, hasznos tér és összefüggő képi kidolgozás szempontjából, majd a következő anyaghoz tartsd meg ugyanazt a kompatibilis stílust. Így a modell változó tartalom melletti ismételhető vizuális nyelvhez praktikus.

Ailoot Ultra · Képek POST /v1/images/generations recraft/recraft-v4-styles

recraft/recraft-v4-styles

Recraft /recraft/recraft-v4-styles

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-styles	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, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 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: 1 Maximális elemszám: 10	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	Elszámolási feltételek	Díj
BeállításTokenek alapdíjai	DíjtáblázatAlapdíj	Előre jelzett mennyiség—	Elszámolási egység—	Elszámolási feltételek—	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ásBemeneti referenciaanyag	Díjtáblázat—	Előre jelzett mennyiség—	Elszámolási egységkérésenként	Elszámolási feltételekStílus létrehozása stílusreferenciákkal végzett generáláskor; kérésenként egyszer számítandó fel, a kimeneti kép árán felül.	Díj Bemenet · Bemeneti referencia · Becslés, csak összehasonlításra $0.01 kérésenként
Beállításkimeneti kép	Díjtáblázat—	Előre jelzett mennyiség—	Elszámolási egységkimeneti képenként	Elszámolási feltételek—	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—	Elszámolási feltételek—	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-styles', '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-styles

Metódusútvonalak álnevei

/v1/images

Kapcsolódó modellazonosítók

recraft/recraft-v4-styles

FAQ · Recraft: Recraft V4 Styles

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

Recraft: Recraft V4 Styles