{ "aboutHtml": "

Recraft V4 Pro je rastrový model s vyšším rozlišením v rodině Recraft V4. V4 se zaměřuje na vizuální úsudek, vyváženou kompozici, souvislé barvy a pečlivou interpretaci tvůrčího směru. Výrobce určuje Pro pro jemnější detaily, realističtější složité scény a rozsáhlé produkční vizuály. Použijte jej pro detailní ilustraci, redakční obrázek, koncept plakátu či jiný materiál těžící z většího rastrového výsledku. Zůstává oddělený od pozdějšího modelu V4.1 a výstupu SVG V4 Pro Vector.

Konkrétní kód výrobce je recraftv4_pro. Dokumentovaný výstup je rastrový 2K v bezztrátovém WebP nebo PNG: 2048 × 2048 pixelů pro čtverec, 2688 × 1536 pro 16:9 a 1664 × 2560 pro 2:3. Ostatní podporované poměry mají vlastní rozměry. Zvolte poměr stran pro zamýšlené rozvržení nebo přesnou povolenou velikost; libovolná pixelová velikost není součástí dokumentované smlouvy generování. Standardní V4 má menší rastrový výstup 1K, zatímco vektorové modely nemají pevné pixelové rozlišení.

V4 může interpretovat krátký prompt pro zkoumání nebo strukturovaný prompt pro řízený výsledek. Pro konkrétní výtvarný směr postupuje příručka výrobce od objektu a prostředí k rámování, vlastnostem, prostorovým vztahům, osvětlení, hloubce a náladě. U redakčního produktového obrázku požadujte dramatickou svislou fotografii sochařsky pojaté židle, povrchy z kartáčovaného kovu, boční osvětlení, klidné tmavé pozadí a prostor nad předmětem pro nadpis. Pojmenování těchto vztahů objasňuje zamýšlenou kompozici více než obecný požadavek na prémiový obrázek.

Tvůrčí rozsah rodiny zahrnuje příběhovou ilustraci, fotorealistické scény a prostorové vizuály s vodítky pro materiál a osvětlení. Výsledek vypadající jako 3D je stále obrázkem, nikoli editovatelnou 3D scénou. U grafického plakátu určete vizuální vrstvy a jejich interakci: pozadí, ilustraci či fotografii, hierarchii nadpisu a podpůrný text. V4 je určen pro čitelné krátké a středně dlouhé fráze, ale konečný pravopis a hierarchii je třeba prohlédnout místo odvozování z názvu modelu.

Současná dokumentace generování dovoluje prompty do 10 000 znaků, jeden až šest výstupů, náhodný seed a ovládání preferovaných barev a barvy pozadí. Volitelné vlastní styly či kompatibilní referenční obrázky mohou vést vzhled pomocí flexible nebo precise matching. Model nepřijímá starší ovládání V3 negative_prompt, předpřipravené styly, text_layout, artistic_level ani no_text. Zamýšlený finální obrázek popište v pozitivním promptu a požadavky na objekt, rozvržení a barvy ponechte explicitní. Pro generování podle stylových referencí použijte jeden až deset obrázků PNG, JPG nebo WebP, celkem nejvýše 64 MB a každý pod 20 MB. Každá reference potřebuje nejkratší stranu alespoň 256 pixelů, nejdelší nejvýše 4 096 pixelů a rozlišení nejvýše 16 megapixelů. Použijte buď tyto reference, nebo kompatibilní uložený styl, nikoli obojí.

Recraft dokumentuje samostatnou operaci image-to-image pro V4. Kombinuje existující obrázek a prompt se silou od 0 do 1 řídící míru změny a v této operaci nepřijímá ovládání vlastních stylů V4. Zdroj připravte v rámci limitů obrazového vstupu výrobce a uveďte vlastnosti, které se mají přenést do nového výsledku. U většího finálního materiálu zkontrolujte jemné detaily, ořez a písmo v zamýšlené velikosti. Další rastrové detaily Pro tuto kontrolu podporují, zatímco obrázek zůstává generovanou interpretací dodaného tvůrčího zadání. Pro image-to-image dodejte PNG, JPG, WebP nebo SVG pod 20 MB, nejvýše 16 megapixelů, s oběma stranami mezi 256 a 4 096 pixely.

", "aboutText": "Recraft V4 Pro je rastrový model s vyšším rozlišením v rodině Recraft V4. V4 se zaměřuje na vizuální úsudek, vyváženou kompozici, souvislé barvy a pečlivou interpretaci tvůrčího směru. Výrobce určuje Pro pro jemnější detaily, realističtější složité scény a rozsáhlé produkční vizuály. Použijte jej pro detailní ilustraci, redakční obrázek, koncept plakátu či jiný materiál těžící z většího rastrového výsledku. Zůstává oddělený od pozdějšího modelu V4.1 a výstupu SVG V4 Pro Vector.\n\nKonkrétní kód výrobce je recraftv4_pro. Dokumentovaný výstup je rastrový 2K v bezztrátovém WebP nebo PNG: 2048 × 2048 pixelů pro čtverec, 2688 × 1536 pro 16:9 a 1664 × 2560 pro 2:3. Ostatní podporované poměry mají vlastní rozměry. Zvolte poměr stran pro zamýšlené rozvržení nebo přesnou povolenou velikost; libovolná pixelová velikost není součástí dokumentované smlouvy generování. Standardní V4 má menší rastrový výstup 1K, zatímco vektorové modely nemají pevné pixelové rozlišení.\n\nV4 může interpretovat krátký prompt pro zkoumání nebo strukturovaný prompt pro řízený výsledek. Pro konkrétní výtvarný směr postupuje příručka výrobce od objektu a prostředí k rámování, vlastnostem, prostorovým vztahům, osvětlení, hloubce a náladě. U redakčního produktového obrázku požadujte dramatickou svislou fotografii sochařsky pojaté židle, povrchy z kartáčovaného kovu, boční osvětlení, klidné tmavé pozadí a prostor nad předmětem pro nadpis. Pojmenování těchto vztahů objasňuje zamýšlenou kompozici více než obecný požadavek na prémiový obrázek.\n\nTvůrčí rozsah rodiny zahrnuje příběhovou ilustraci, fotorealistické scény a prostorové vizuály s vodítky pro materiál a osvětlení. Výsledek vypadající jako 3D je stále obrázkem, nikoli editovatelnou 3D scénou. U grafického plakátu určete vizuální vrstvy a jejich interakci: pozadí, ilustraci či fotografii, hierarchii nadpisu a podpůrný text. V4 je určen pro čitelné krátké a středně dlouhé fráze, ale konečný pravopis a hierarchii je třeba prohlédnout místo odvozování z názvu modelu.\n\nSoučasná dokumentace generování dovoluje prompty do 10 000 znaků, jeden až šest výstupů, náhodný seed a ovládání preferovaných barev a barvy pozadí. Volitelné vlastní styly či kompatibilní referenční obrázky mohou vést vzhled pomocí flexible nebo precise matching. Model nepřijímá starší ovládání V3 negative_prompt, předpřipravené styly, text_layout, artistic_level ani no_text. Zamýšlený finální obrázek popište v pozitivním promptu a požadavky na objekt, rozvržení a barvy ponechte explicitní. Pro generování podle stylových referencí použijte jeden až deset obrázků PNG, JPG nebo WebP, celkem nejvýše 64 MB a každý pod 20 MB. Každá reference potřebuje nejkratší stranu alespoň 256 pixelů, nejdelší nejvýše 4 096 pixelů a rozlišení nejvýše 16 megapixelů. Použijte buď tyto reference, nebo kompatibilní uložený styl, nikoli obojí.\n\nRecraft dokumentuje samostatnou operaci image-to-image pro V4. Kombinuje existující obrázek a prompt se silou od 0 do 1 řídící míru změny a v této operaci nepřijímá ovládání vlastních stylů V4. Zdroj připravte v rámci limitů obrazového vstupu výrobce a uveďte vlastnosti, které se mají přenést do nového výsledku. U většího finálního materiálu zkontrolujte jemné detaily, ořez a písmo v zamýšlené velikosti. Další rastrové detaily Pro tuto kontrolu podporují, zatímco obrázek zůstává generovanou interpretací dodaného tvůrčího zadání. Pro image-to-image dodejte PNG, JPG, WebP nebo SVG pod 20 MB, nejvýše 16 megapixelů, s oběma stranami mezi 256 a 4 096 pixely.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "17a70e89200c1cc8af1a16ba05df0dde07f79112f961b228ede3561935755e7d", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "cs", "methods": [ { "html": "

•

Recraft: Recraft V4 Pro

Recraft /recraft/recraft-v4-pro

Úvod

Recraft V4 Pro generuje rastrové obrázky 2K pro detailní kompozice, fotorealismus, ilustraci a tvůrčí práci určenou k tisku. Je edicí V4 s vyšším rozlišením, textovými zadáními, volitelnými stylovými vstupy a samostatným postupem image-to-image.

Přijímané vstupy: Text · Obrázky
Výsledky: Obrázky

O modelu

Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.

Recraft V4 Pro je rastrový model s vyšším rozlišením v rodině Recraft V4. V4 se zaměřuje na vizuální úsudek, vyváženou kompozici, souvislé barvy a pečlivou interpretaci tvůrčího směru. Výrobce určuje Pro pro jemnější detaily, realističtější složité scény a rozsáhlé produkční vizuály. Použijte jej pro detailní ilustraci, redakční obrázek, koncept plakátu či jiný materiál těžící z většího rastrového výsledku. Zůstává oddělený od pozdějšího modelu V4.1 a výstupu SVG V4 Pro Vector.

Konkrétní kód výrobce je recraftv4_pro. Dokumentovaný výstup je rastrový 2K v bezztrátovém WebP nebo PNG: 2048 × 2048 pixelů pro čtverec, 2688 × 1536 pro 16:9 a 1664 × 2560 pro 2:3. Ostatní podporované poměry mají vlastní rozměry. Zvolte poměr stran pro zamýšlené rozvržení nebo přesnou povolenou velikost; libovolná pixelová velikost není součástí dokumentované smlouvy generování. Standardní V4 má menší rastrový výstup 1K, zatímco vektorové modely nemají pevné pixelové rozlišení.

V4 může interpretovat krátký prompt pro zkoumání nebo strukturovaný prompt pro řízený výsledek. Pro konkrétní výtvarný směr postupuje příručka výrobce od objektu a prostředí k rámování, vlastnostem, prostorovým vztahům, osvětlení, hloubce a náladě. U redakčního produktového obrázku požadujte dramatickou svislou fotografii sochařsky pojaté židle, povrchy z kartáčovaného kovu, boční osvětlení, klidné tmavé pozadí a prostor nad předmětem pro nadpis. Pojmenování těchto vztahů objasňuje zamýšlenou kompozici více než obecný požadavek na prémiový obrázek.

Tvůrčí rozsah rodiny zahrnuje příběhovou ilustraci, fotorealistické scény a prostorové vizuály s vodítky pro materiál a osvětlení. Výsledek vypadající jako 3D je stále obrázkem, nikoli editovatelnou 3D scénou. U grafického plakátu určete vizuální vrstvy a jejich interakci: pozadí, ilustraci či fotografii, hierarchii nadpisu a podpůrný text. V4 je určen pro čitelné krátké a středně dlouhé fráze, ale konečný pravopis a hierarchii je třeba prohlédnout místo odvozování z názvu modelu.

Současná dokumentace generování dovoluje prompty do 10 000 znaků, jeden až šest výstupů, náhodný seed a ovládání preferovaných barev a barvy pozadí. Volitelné vlastní styly či kompatibilní referenční obrázky mohou vést vzhled pomocí flexible nebo precise matching. Model nepřijímá starší ovládání V3 negative_prompt, předpřipravené styly, text_layout, artistic_level ani no_text. Zamýšlený finální obrázek popište v pozitivním promptu a požadavky na objekt, rozvržení a barvy ponechte explicitní. Pro generování podle stylových referencí použijte jeden až deset obrázků PNG, JPG nebo WebP, celkem nejvýše 64 MB a každý pod 20 MB. Každá reference potřebuje nejkratší stranu alespoň 256 pixelů, nejdelší nejvýše 4 096 pixelů a rozlišení nejvýše 16 megapixelů. Použijte buď tyto reference, nebo kompatibilní uložený styl, nikoli obojí.

Recraft dokumentuje samostatnou operaci image-to-image pro V4. Kombinuje existující obrázek a prompt se silou od 0 do 1 řídící míru změny a v této operaci nepřijímá ovládání vlastních stylů V4. Zdroj připravte v rámci limitů obrazového vstupu výrobce a uveďte vlastnosti, které se mají přenést do nového výsledku. U většího finálního materiálu zkontrolujte jemné detaily, ořez a písmo v zamýšlené velikosti. Další rastrové detaily Pro tuto kontrolu podporují, zatímco obrázek zůstává generovanou interpretací dodaného tvůrčího zadání. Pro image-to-image dodejte PNG, JPG, WebP nebo SVG pod 20 MB, nejvýše 16 megapixelů, s oběma stranami mezi 256 a 4 096 pixely.

Dostupné v Ailoot · vstupy a metody

Ailoot Ultra · Obrázky POST /v1/images/generations

Vstup: text, image
Výstup: image
Výstupní formát: Soubor obrázku

Pole	Typ	Požadavek	Hodnoty a limity	Výchozí
Pole`model`	Typ`string`	PožadavekPovinné	Hodnoty a limity recraft/recraft-v4-pro	Výchozí—
Pole`prompt`	Typ`string`	PožadavekPovinné	Hodnoty a limity Minimální délka: 1	Výchozí—
Pole`n`	Typ`integer`	PožadavekVolitelné	Hodnoty a limity Minimum: 1 Maximum: 6	Výchozí—
Pole`aspect_ratio`	Typ`string`	PožadavekVolitelné	Hodnoty a limity 1:1, 4:3, 3:4, 16:9, 9:16, auto	Výchozí—
Pole`input_references`	Typ`array`	PožadavekVolitelné	Hodnoty a limity Minimální počet položek: 0 Maximální počet položek: 1	Výchozí—

Kombinace vstupních materiálů

Text na obrázek · Povinné: prompt

Parametry a životní cyklus metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, prompt
Parametr`material_types`	Kontrakttext, image
Parametr`optional_controls`	Kontraktaspect_ratio, n, input_references
Parametr`exact_supported_parameters`	Kontrakt{"aspect_ratio":{"type":"enum","values":["1:1","4:3","3:4","16:9","9:16","auto"]},"n":{"type":"range","min":1,"max":6},"input_references":{"type":"range","min":0,"max":1}}
Parametr`reference_material_rule`	KontraktPouze skutečné obrazové reference zákazníka; vztahují se na ně podmínky koncového bodu poskytovatele.

Aliasy metody: /v1/images

Životní cyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · skutečně vrácené task_id nebo záznam v knihovně médií

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Použijte přesný model a dokumentovaná vstupní pole.

Uchovejte celou odpověď, každý skutečný výstup a původní vrácená ID.

Tarify

Jak se vypočítá konečný poplatek

Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.

Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.

Rychlý režim: Neuvedeno Při výběru rychlého režimu
Režim flex: Neuvedeno Při výběru režimu flex
Maximální intenzita uvažování: Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)

Odhadované sazby pro srovnání

Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

Konfigurace	Tabulka sazeb	Předpokládané množství	Účtovací jednotka	Poplatek
KonfiguraceZákladní sazby za tokeny	Tabulka sazebZákladní sazba	Předpokládané množství—	Účtovací jednotka—	Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů
KonfiguraceUltra	Tabulka sazeb—	Předpokládané množství—	Účtovací jednotkaza výstupní obrázek	Poplatek Výstup · výstup obrázku · Odhad pouze pro srovnání $0.5 za výstupní obrázek
KonfiguraceOdhadovaná cena generování	Tabulka sazeb—	Předpokládané množstvíodhad pro jedno generování	Účtovací jednotka—	Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.5 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování.

Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →

Podrobnosti referenčního tarifu

Referenční tabulky modelu nemění výběr metody, cenové nabídky ani poplatky. Skutečné poplatky používají sazby vybrané metody Ailoot.

Cenové konfigurace obrázků

Ceny podle konfigurace

Konfigurace	Podmínky účtování	Poplatek
KonfiguraceVýstupní obrázek	Podmínky účtováníNení deklarována žádná cenová varianta.	Poplatek Výstup · Výstupní obrázek $0.5 za obrázek Ekvivalentní položky popisují tutéž účtovanou částku; nepřidávají druhý poplatek.

Příklady požadavků

Ailoot Ultra · Obrázky

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-pro', '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-pro', '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-pro", "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

Přijímání a ukládání výsledků

Ailoot Ultra · Obrázky

Stáhněte každý vrácený obrázek nebo uložte jeho obsah Base64

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

Uchovejte všechny dokončené výsledky

Uložte každý dokončený obrázek; stáhněte obsah každé vrácené URL nebo dekódujte obsah Base64.

Uchovejte každou datovou položku a úplné údaje o využití; převezměte do správy a uložte všechny skutečně vrácené obrázky. Žádné vymyšlené URL ani ID.

Pokud je nutné ověřit původní odpověď

Pokud výsledek generování nebo úpravy obrázku vyžaduje kontrolu, uchovejte původní operation_id/X-Client-Request-ID a vrácené informace o výsledku. Existující vlastní výsledky obnovte prostřednictvím knihovny médií pomocí skutečných hodnot task_id nebo asset_id. Požadavek na generování či úpravu znovu neodesílejte a nevytvářejte URL pro dotazování na stav z operation_id.

Pole odpovědi

Pole	Typ
Pole`created`	Typinteger
Pole`data[].url`	Typstring
Pole`data[].b64_json`	Typbase64 string
Pole`usage`	Typobject

Aliasy

Aliasy modelu

Ailoot Ultra recraft/recraft-v4-pro

Aliasy cest metod

/v1/images

Související ID modelů

recraft/recraft-v4-pro

", "method_identity": { "effective_request_model_id": "recraft/recraft-v4-pro", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "recraft/recraft-v4-pro", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|recraft%2Frecraft-v4-pro", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.", "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.", "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": "Pokud výsledek generování nebo úpravy obrázku vyžaduje kontrolu, uchovejte původní operation_id/X-Client-Request-ID a vrácené informace o výsledku. Existující vlastní výsledky obnovte prostřednictvím knihovny médií pomocí skutečných hodnot task_id nebo asset_id. Požadavek na generování či úpravu znovu neodesílejte a nevytvářejte URL pro dotazování na stav z operation_id." }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_image", "required": [ "prompt" ] } ], "outputs": { "all_results": "Uchovejte každou datovou položku a úplné údaje o využití; převezměte do správy a uložte všechny skutečně vrácené obrázky. Žádné vymyšlené URL ani ID.", "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-pro" ], "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": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "material_rule": "Actual customer HTTP(S) image URL or base64 data URI; no invented reference 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, "minItems": 0, "type": "array" }, "model": { "enum": [ "recraft/recraft-v4-pro" ], "type": "string" }, "n": { "maximum": 6, "minimum": 1, "type": "integer" }, "prompt": { "minLength": 1, "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "recraft/recraft-v4-pro", "prompt": "a red panda astronaut floating in space, studio lighting" }, "content_type": "application/json" } }, "hints": [ "Použijte přesný model a dokumentovaná vstupní pole.", "Uchovejte celou odpověď, každý skutečný výstup a původní vrácená ID." ], "input": { "content_type": "application/json", "exact_supported_parameters": { "aspect_ratio": { "type": "enum", "values": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ] }, "input_references": { "max": 1, "min": 0, "type": "range" }, "n": { "max": 6, "min": 1, "type": "range" } }, "material_types": [ "text", "image" ], "optional_controls": [ "aspect_ratio", "n", "input_references" ], "reference_material_rule": "Pouze skutečné obrazové reference zákazníka; vztahují se na ně podmínky koncového bodu poskytovatele.", "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": "skutečně vrácené task_id nebo záznam v knihovně médií", "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 physical units", "quoted_unit": "per image output" }, "label": "Ultra", "units": [ { "amount": "0.5", "amount_unit": "usd_per_image_output", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "image output", "native_amount_usd_per_unit": "0.5", "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": "Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Odhadovaná cena generování", "units": [ { "amount": "0.5", "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.5", "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-pro', '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\"