{ "aboutHtml": "

A Recraft V4 a Recraft V4 generációjának normál rasztermodellje. A gyártó a tervezői ítélőképességet hangsúlyozza: kiegyensúlyozott kompozíciót, összefüggő színkapcsolatokat és a vizuális szándékot támogató részletességet. Stilizált illusztrációval, fotografikus jelenetekkel és grafikai dizájnkoncepciókkal dolgozhat. Akkor használd, ha a leírás esztétikai választást és promptpontosságot egyesítő képet kíván, akár rövid irányból hangulatot fedezel fel, akár tudatos elrendezést részletezel.

A pontos modellkód recraftv4. Gyártói referenciája 1K raszterkimenetet sorol fel veszteségmentes WebP vagy PNG formátumban. A négyzetes kép 1024 × 1024, a 16:9 1344 × 768, a 2:3 832 × 1280 pixel; más támogatott arányok saját méreteket használnak. A V4 Pro külön 2K raszteres kiadás, a V4 Vector és Pro Vector szerkeszthető SVG-t ad vissza. A kívánt eredményhez pontos V4 változatot válassz, e különböző kimeneti tulajdonságok összekeverése helyett.

A gyártói útmutató megkülönbözteti a rövid értelmező promptot a strukturált alkotói iránytól. Rövid kifejezés teret hagyhat a forma, hangulat és képkivágás felfedezésének. Strukturált leírás megnevezheti a témát, környezetet, pózt, anyagot, másodlagos elemeket, fényt és vizuális hierarchiát. Történetmesélő illusztrációhoz írj le kis hídon áthaladó kerékpárost, merész egyszerűsített formákat, meleg visszafogott színeket és világos balról jobbra mozgást. E tartalmi és kompozíciós döntések jobban végrehajthatók, mint független stílusjelzők hosszú listája.

A V4 tartománya illusztrációt, térhatású és fotórealisztikus képi világot foglal magában. Az útmutató illusztrációhoz a rajzi logika, 3D-megjelenésű képhez az anyag, fény, kamera és mélység leírását ajánlja. Utóbbi raszteres vizuál marad, nem szerkeszthető mesh. Plakát- vagy csomagoláskoncepciónál add meg, mely szavak elsődlegesek, hol legyenek és hogyan hat egymásra a kép és tipográfia. A gyártó olvasható rövid és közepes hosszúságú szöveget emel ki; használat előtt ellenőrizd a visszaadott kép tényleges szövegét és elrendezését.

A generálás legfeljebb 10 000 karakteres promptot, véletlen seedet, egy–hat kimenetet, preferált színeket és kívánt háttérszínt támogat. Opcionális kompatibilis egyéni stílusok és referenciaképek flexible vagy precise illesztéssel irányíthatják a vizuális megoldást. Tiszta referenciát vagy közös vizuális világhoz tartozó készletet válassz, majd a prompt írja le az új témát és jelenetet. A referencia és kimenet színegyezése nem garantált, ezért a szükséges paletta legyen kifejezett, és vesd össze vele az eredményt. 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.

A dokumentált kép-kép művelet meglévő képet és promptot egyesít; 0–1 közötti strength határozza meg, milyen messzire távolodik az új kimenet a forrástól. E művelet nem fogad V4 stílusvezérlőket. A jelenlegi generálási referencia a kurált stílusneveket, negative_prompt, text_layout, artistic_level és no_text vezérlőket is kizárja. Készíts pozitív leírást a kívánt eredményről, és a képet célkompozíciójában értékeld. A normál V4 célzott raszteres dizájnértelmezést ad, konkrét kiadással, formátummal és kimeneti mérettel. Kép-kép módban PNG, JPG, WebP vagy SVG bemenetet adj 20 MB alatt, legfeljebb 16 megapixellel és mindkét oldalon 256–4 096 pixellel.

", "aboutText": "A Recraft V4 a Recraft V4 generációjának normál rasztermodellje. A gyártó a tervezői ítélőképességet hangsúlyozza: kiegyensúlyozott kompozíciót, összefüggő színkapcsolatokat és a vizuális szándékot támogató részletességet. Stilizált illusztrációval, fotografikus jelenetekkel és grafikai dizájnkoncepciókkal dolgozhat. Akkor használd, ha a leírás esztétikai választást és promptpontosságot egyesítő képet kíván, akár rövid irányból hangulatot fedezel fel, akár tudatos elrendezést részletezel.\n\nA pontos modellkód recraftv4. Gyártói referenciája 1K raszterkimenetet sorol fel veszteségmentes WebP vagy PNG formátumban. A négyzetes kép 1024 × 1024, a 16:9 1344 × 768, a 2:3 832 × 1280 pixel; más támogatott arányok saját méreteket használnak. A V4 Pro külön 2K raszteres kiadás, a V4 Vector és Pro Vector szerkeszthető SVG-t ad vissza. A kívánt eredményhez pontos V4 változatot válassz, e különböző kimeneti tulajdonságok összekeverése helyett.\n\nA gyártói útmutató megkülönbözteti a rövid értelmező promptot a strukturált alkotói iránytól. Rövid kifejezés teret hagyhat a forma, hangulat és képkivágás felfedezésének. Strukturált leírás megnevezheti a témát, környezetet, pózt, anyagot, másodlagos elemeket, fényt és vizuális hierarchiát. Történetmesélő illusztrációhoz írj le kis hídon áthaladó kerékpárost, merész egyszerűsített formákat, meleg visszafogott színeket és világos balról jobbra mozgást. E tartalmi és kompozíciós döntések jobban végrehajthatók, mint független stílusjelzők hosszú listája.\n\nA V4 tartománya illusztrációt, térhatású és fotórealisztikus képi világot foglal magában. Az útmutató illusztrációhoz a rajzi logika, 3D-megjelenésű képhez az anyag, fény, kamera és mélység leírását ajánlja. Utóbbi raszteres vizuál marad, nem szerkeszthető mesh. Plakát- vagy csomagoláskoncepciónál add meg, mely szavak elsődlegesek, hol legyenek és hogyan hat egymásra a kép és tipográfia. A gyártó olvasható rövid és közepes hosszúságú szöveget emel ki; használat előtt ellenőrizd a visszaadott kép tényleges szövegét és elrendezését.\n\nA generálás legfeljebb 10 000 karakteres promptot, véletlen seedet, egy–hat kimenetet, preferált színeket és kívánt háttérszínt támogat. Opcionális kompatibilis egyéni stílusok és referenciaképek flexible vagy precise illesztéssel irányíthatják a vizuális megoldást. Tiszta referenciát vagy közös vizuális világhoz tartozó készletet válassz, majd a prompt írja le az új témát és jelenetet. A referencia és kimenet színegyezése nem garantált, ezért a szükséges paletta legyen kifejezett, és vesd össze vele az eredményt. 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.\n\nA dokumentált kép-kép művelet meglévő képet és promptot egyesít; 0–1 közötti strength határozza meg, milyen messzire távolodik az új kimenet a forrástól. E művelet nem fogad V4 stílusvezérlőket. A jelenlegi generálási referencia a kurált stílusneveket, negative_prompt, text_layout, artistic_level és no_text vezérlőket is kizárja. Készíts pozitív leírást a kívánt eredményről, és a képet célkompozíciójában értékeld. A normál V4 célzott raszteres dizájnértelmezést ad, konkrét kiadással, formátummal és kimeneti mérettel. Kép-kép módban PNG, JPG, WebP vagy SVG bemenetet adj 20 MB alatt, legfeljebb 16 megapixellel és mindkét oldalon 256–4 096 pixellel.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "78d3f780df28d6e0a4418c96e80dcbde4eafee34dd6164f1c54b020ec73e397a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "hu", "methods": [ { "html": "

•

Recraft: Recraft V4

Recraft /recraft/recraft-v4

Kezdő lépések

A Recraft V4 1K raszterképeket generál a kompozícióra, színkapcsolatokra és részletes alkotói irányra összpontosítva. Illusztrációt, fotórealisztikus jeleneteket és grafikai dizájnkoncepciókat fed le, opcionális stílusbemenetekkel és külön kép-kép munkafolyamattal.

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

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 a Recraft V4 generációjának normál rasztermodellje. A gyártó a tervezői ítélőképességet hangsúlyozza: kiegyensúlyozott kompozíciót, összefüggő színkapcsolatokat és a vizuális szándékot támogató részletességet. Stilizált illusztrációval, fotografikus jelenetekkel és grafikai dizájnkoncepciókkal dolgozhat. Akkor használd, ha a leírás esztétikai választást és promptpontosságot egyesítő képet kíván, akár rövid irányból hangulatot fedezel fel, akár tudatos elrendezést részletezel.

A pontos modellkód recraftv4. Gyártói referenciája 1K raszterkimenetet sorol fel veszteségmentes WebP vagy PNG formátumban. A négyzetes kép 1024 × 1024, a 16:9 1344 × 768, a 2:3 832 × 1280 pixel; más támogatott arányok saját méreteket használnak. A V4 Pro külön 2K raszteres kiadás, a V4 Vector és Pro Vector szerkeszthető SVG-t ad vissza. A kívánt eredményhez pontos V4 változatot válassz, e különböző kimeneti tulajdonságok összekeverése helyett.

A gyártói útmutató megkülönbözteti a rövid értelmező promptot a strukturált alkotói iránytól. Rövid kifejezés teret hagyhat a forma, hangulat és képkivágás felfedezésének. Strukturált leírás megnevezheti a témát, környezetet, pózt, anyagot, másodlagos elemeket, fényt és vizuális hierarchiát. Történetmesélő illusztrációhoz írj le kis hídon áthaladó kerékpárost, merész egyszerűsített formákat, meleg visszafogott színeket és világos balról jobbra mozgást. E tartalmi és kompozíciós döntések jobban végrehajthatók, mint független stílusjelzők hosszú listája.

A V4 tartománya illusztrációt, térhatású és fotórealisztikus képi világot foglal magában. Az útmutató illusztrációhoz a rajzi logika, 3D-megjelenésű képhez az anyag, fény, kamera és mélység leírását ajánlja. Utóbbi raszteres vizuál marad, nem szerkeszthető mesh. Plakát- vagy csomagoláskoncepciónál add meg, mely szavak elsődlegesek, hol legyenek és hogyan hat egymásra a kép és tipográfia. A gyártó olvasható rövid és közepes hosszúságú szöveget emel ki; használat előtt ellenőrizd a visszaadott kép tényleges szövegét és elrendezését.

A generálás legfeljebb 10 000 karakteres promptot, véletlen seedet, egy–hat kimenetet, preferált színeket és kívánt háttérszínt támogat. Opcionális kompatibilis egyéni stílusok és referenciaképek flexible vagy precise illesztéssel irányíthatják a vizuális megoldást. Tiszta referenciát vagy közös vizuális világhoz tartozó készletet válassz, majd a prompt írja le az új témát és jelenetet. A referencia és kimenet színegyezése nem garantált, ezért a szükséges paletta legyen kifejezett, és vesd össze vele az eredményt. 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.

A dokumentált kép-kép művelet meglévő képet és promptot egyesít; 0–1 közötti strength határozza meg, milyen messzire távolodik az új kimenet a forrástól. E művelet nem fogad V4 stílusvezérlőket. A jelenlegi generálási referencia a kurált stílusneveket, negative_prompt, text_layout, artistic_level és no_text vezérlőket is kizárja. Készíts pozitív leírást a kívánt eredményről, és a képet célkompozíciójában értékeld. A normál V4 célzott raszteres dizájnértelmezést ad, konkrét kiadással, formátummal és kimeneti mérettel. Kép-kép módban PNG, JPG, WebP vagy SVG bemenetet adj 20 MB alatt, legfeljebb 16 megapixellel és mindkét oldalon 256–4 096 pixellel.

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

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

Bemenet: text, image
Kimenet: image
Kimeneti formátum: Képfájl

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	Alapértelmezett—
Mező`prompt`	Típus`string`	KövetelményKötelező	Értékek és korlátok Minimális hossz: 1	Alapértelmezett—
Mező`n`	Típus`integer`	KövetelményOpcionális	Értékek és korlátok Minimum: 1 Maximum: 6	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ő`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—

Bemeneti anyagok kombinációi

Szövegből kép · Kötelező: prompt

reference_guided_image · Kötelező: prompt, actual image reference

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
Paraméter`optional_controls`	Szerződésn, aspect_ratio, input_references
Paraméter`n`	Szerződés{"minimum":1,"maximum":6}
Paraméter`reference_images`	Szerződés{"minimum":0,"maximum":1,"source":"az ügyfél által ténylegesen megadott anyag"}
Paraméter`provider_specific_options`	SzerződésKizárólag a mentett pontos végpontengedélyezési lista szerinti style/controls/text_layout; kitalált szerkezetek nélkül.

Metódus álnevei: /v1/images

É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}

A kizárólag szöveges utasítást tartalmazó példa megőrzi a hivatalos ImageGenerationRequest szerkezetét.

Őrizze meg az összes visszaadott képet és a teljes választ; a kimenetek száma a tényleges darabszám, nem a kért n.

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ásUltra	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.08 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.08 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 →

A referencia-díjszabás részletei

A modellszintű referenciatáblázatok nem módosítják a metódusválasztást, az árajánlatokat vagy a díjakat. A tényleges díjak a kiválasztott Ailoot-metódus díjtételeit használják.

Képárazási beállítások

Árak beállításonként

Beállítás	Elszámolási feltételek	Díj
BeállításKimeneti kép	Elszámolási feltételekNincs deklarált árazási változat.	Díj Kimenet · Kimeneti kép $0.08 képenként Az egyenértékű felsorolások ugyanazt a díjat írják le; nem jelentenek második díjat.

Példakérések

Ailoot Ultra · Képek

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'recraft/recraft-v4', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n    if not items: raise SystemExit("No completed images; retain the full response")\n    for index, item in enumerate(items):\n        encoded=item.get("b64_json")\n        uri=item.get("url", "")\n        if not encoded and uri.startswith("data:image/"):\n            header, separator, encoded=uri.partition(",")\n            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n        if encoded:\n            raw=base64.b64decode(encoded,validate=True)\n        elif uri:\n            uri=urljoin("https://api.ailoot.ai",uri)\n            parsed=urlsplit(uri)\n            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n                raise SystemExit("Invalid returned image URL")\n            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n            args=["curl","--fail-with-body","--silent","--show-error",uri]\n            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n            temporary=Path(f"image-{index}.bin")\n            subprocess.run(args+["-o",str(temporary)],check=True)\n            raw=temporary.read_bytes()\n            temporary.unlink()\n        else: raise SystemExit("Image has neither bytes nor URL")\n        if not raw: raise SystemExit("Empty image result")\n        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"\n        Path(f"image-{index}.{ext}").write_bytes(raw)\n    print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\n

from openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n    if not items: raise SystemExit("No completed images; retain the full response")\n    for index, item in enumerate(items):\n        encoded=item.get("b64_json")\n        uri=item.get("url", "")\n        if not encoded and uri.startswith("data:image/"):\n            header, separator, encoded=uri.partition(",")\n            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n        if encoded:\n            raw=base64.b64decode(encoded,validate=True)\n        elif uri:\n            uri=urljoin("https://api.ailoot.ai",uri)\n            parsed=urlsplit(uri)\n            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n                raise SystemExit("Invalid returned image URL")\n            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n            args=["curl","--fail-with-body","--silent","--show-error",uri]\n            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n            temporary=Path(f"image-{index}.bin")\n            subprocess.run(args+["-o",str(temporary)],check=True)\n            raw=temporary.read_bytes()\n            temporary.unlink()\n        else: raise SystemExit("Image has neither bytes nor URL")\n        if not raw: raise SystemExit("Empty image result")\n        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"\n        Path(f"image-{index}.{ext}").write_bytes(raw)\n    print("Every returned image saved; complete response metadata retained")\n\nrequest={'model': 'recraft/recraft-v4', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\n

import OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "recraft/recraft-v4", "prompt": "a red panda astronaut floating in space, studio lighting"};\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n  const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n  if(!encoded && uri.startsWith("data:image/")) {\n    const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n    encoded=uri.slice(comma+1);\n  }\n  if(encoded) {\n    if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n    raw=Buffer.from(encoded,"base64");\n  } else if(uri) {\n    const u=new URL(uri,"https://api.ailoot.ai");\n    if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n    const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n    const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n    if(!response.ok) throw new Error("Image content download failed: "+response.status);\n    raw=Buffer.from(await response.arrayBuffer());\n  } else throw new Error("Image has neither bytes nor URL");\n  if(!raw.length) throw new Error("Empty image result");\n  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";\n  writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\n

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}

Ő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.

Őrizzen meg minden adatelemet és a teljes felhasználási adatokat; vegye saját tárolásba és mentse el az összes ténylegesen visszaadott képet. Ne találjon ki URL-címeket vagy azonosítókat.

Ha az eredeti választ ellenőrizni kell

Ha egy képgenerálási vagy képszerkesztési eredmény ellenőrzést igényel, őrizze meg az eredeti operation_id/X-Client-Request-ID értéket és a visszaadott eredményadatokat. A saját, már meglévő eredményeket a médiatárból állítsa helyre a tényleges task_id vagy asset_id értékekkel. Ne küldje be újra a generálási/szerkesztési kérést, és ne állítson össze állapotlekérdezési URL-t az operation_id értékéből.

Válaszmezők

Mező	Típus
Mező`created`	Típusinteger
Mező`data[].url`	Típusstring
Mező`data[].b64_json`	Típusbase64 string
Mező`usage`	Típusobject

Hibák és következő lépések

Válasz	Feltétel	Következő lépés
Válasz400 · `invalid_request_error`	FeltételÉrvénytelen kötelező mezők, az anyag érvénytelen reprezentációja vagy érvénytelen paraméterérték	Következő lépésJavítsa a jelzett mezőket egy új létrehozási kérés előtt.
Válasz`server_error`	FeltételA visszaadott válasz szerint a művelet vagy az eredmény ellenőrzést igényel	Következő lépésŐrizze meg az eredetileg visszaadott művelet- vagy feladatazonosítót, a kérés fejléceit és a választ; folytassa az eredeti művelet támogatott lekérdezéseit. Ne küldje be újra a létrehozási kérést.

Álnevek

Modell álnevei

Ailoot Ultra recraft/recraft-v4

Metódusútvonalak álnevei

/v1/images

Kapcsolódó modellazonosítók

recraft/recraft-v4

", "method_identity": { "effective_request_model_id": "recraft/recraft-v4", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "recraft/recraft-v4", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|recraft%2Frecraft-v4", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain every data item and complete usage; own and save all actual returned images. No invented URLs or IDs.", "errors": [ { "code": null, "condition": "Érvénytelen kötelező mezők, az anyag érvénytelen reprezentációja vagy érvénytelen paraméterérték", "http_status": 400, "recovery": "Javítsa a jelzett mezőket egy új létrehozási kérés előtt.", "type": "invalid_request_error" }, { "code": null, "condition": "A visszaadott válasz szerint a művelet vagy az eredmény ellenőrzést igényel", "http_status": null, "recovery": "Őrizze meg az eredetileg visszaadott művelet- vagy feladatazonosítót, a kérés fejléceit és a választ; folytassa az eredeti művelet támogatott lekérdezéseit. Ne küldje be újra a létrehozási kérést.", "type": "server_error" } ], "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Ha egy képgenerálási vagy képszerkesztési eredmény ellenőrzést igényel, őrizze meg az eredeti operation_id/X-Client-Request-ID értéket és a visszaadott eredményadatokat. A saját, már meglévő eredményeket a médiatárból állítsa helyre a tényleges task_id vagy asset_id értékekkel. Ne küldje be újra a generálási/szerkesztési kérést, és ne állítson össze állapotlekérdezési URL-t az operation_id értékéből." }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_image", "required": [ "prompt" ] }, { "content_type": "application/json", "maximum_references": 1, "mode": "reference_guided_image", "required": [ "prompt", "actual image reference" ] } ], "outputs": { "all_results": "Őrizzen meg minden adatelemet és a teljes felhasználási adatokat; vegye saját tárolásba és mentse el az összes ténylegesen visszaadott képet. Ne találjon ki URL-címeket vagy azonosítókat.", "family": "image", "fields": [ { "description": null, "name": "created", "type": "integer" }, { "description": null, "name": "data[].url", "type": "string" }, { "description": null, "name": "data[].b64_json", "type": "base64 string" }, { "description": null, "name": "usage", "type": "object" } ], "format": "actual validated raster MIME" }, "parameters": [ { "availability": "source_interface", "enum": [ "recraft/recraft-v4" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "saved_exact_supplier_endpoint", "maximum": 6, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "availability": "saved_exact_supplier_endpoint", "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "availability": "saved_exact_supplier_endpoint", "items": { "image_url": { "url": "actual HTTP(S) image URL or base64 data URI" }, "type": "image_url" }, "maximum_items": 1, "minimum_items": 0, "name": "input_references", "required": false, "type": "array" } ], "request_schema": { "properties": { "aspect_ratio": { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "type": "array" }, "model": { "enum": [ "recraft/recraft-v4" ], "type": "string" }, "n": { "maximum": 6, "minimum": 1, "type": "integer" }, "prompt": { "minLength": 1, "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "body": { "model": "recraft/recraft-v4", "prompt": "a red panda astronaut floating in space, studio lighting" }, "content_type": "application/json", "parameter_source": "parameters + request_schema; no fabricated reference URL" } }, "hints": [ "A kizárólag szöveges utasítást tartalmazó példa megőrzi a hivatalos ImageGenerationRequest szerkezetét.", "Őrizze meg az összes visszaadott képet és a teljes választ; a kimenetek száma a tényleges darabszám, nem a kért n." ], "input": { "content_type": "application/json", "material_types": [ "text", "image" ], "n": { "maximum": 6, "minimum": 1 }, "optional_controls": [ "n", "aspect_ratio", "input_references" ], "provider_specific_options": "Kizárólag a mentett pontos végpontengedélyezési lista szerinti style/controls/text_layout; kitalált szerkezetek nélkül.", "reference_images": { "maximum": 1, "minimum": 0, "source": "az ügyfél által ténylegesen megadott anyag" }, "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "A ténylegesen visszaadott task_id vagy a médiatár bejegyzése", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "If an image generation or edit result requires a check, keep the original operation_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task_id or asset_id values. Do not resubmit the generation/edit request or construct a polling URL from operation_id." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [ "/v1/images" ], "operation_modes": [ "text_to_image", "reference_guided_image" ], "output": { "all_results": true, "family": "image", "format": "actual validated raster MIME", "result": "every actual owned URL or b64_json" } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quantity_basis": "actual returned output images", "quoted_unit": "per image output" }, "label": "Ultra", "units": [ { "amount": "0.08", "amount_unit": "usd_per_output_image", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per image output", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "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.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "A generálás becsült költsége", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'recraft/recraft-v4', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit(\"No completed images; retain the full response\")\n for index, item in enumerate(items):\n encoded=item.get(\"b64_json\")\n uri=item.get(\"url\", \"\")\n if not encoded and uri.startswith(\"data:image/\"):\n header, separator, encoded=uri.partition(\",\")\n if not separator or \";base64\" not in header: raise SystemExit(\"Unsupported image data URI\")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin(\"https://api.ailoot.ai\",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!=\"https\" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit(\"Invalid returned image URL\")\n owned=parsed.netloc==\"api.ailoot.ai\" and parsed.path.startswith(\"/v1/media/assets/\") and parsed.path.endswith(\"/content\")\n args=[\"curl\",\"--fail-with-body\",\"--silent\",\"--show-error\",uri]\n if owned: args += [\"-H\",\"Authorization: Bearer \"+os.environ[\"AILOOT_API_KEY\"]]\n temporary=Path(f\"image-{index}.bin\")\n subprocess.run(args+[\"-o\",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit(\"Image has neither bytes nor URL\")\n if not raw: raise SystemExit(\"Empty image result\")\n 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\"