Recraft V4.1 Utility Pro je rastrový variant vetvy Utility v rámci Recraft V4.1 s vyšším rozlíšením. Výrobca odlišuje priamočiaru prezentáciu Utility od expresívnejších volieb uhla, osvetlenia a kompozície v hlavnom modeli V4.1. Utility uprednostňuje jednoduché scény, rovnomerné osvetlenie a objekty zobrazené spredu. Preto sa hodí na vizuály produktových ponúk, makety a ďalšiu prácu, pri ktorej má byť predmet ľahko čitateľný a pokojná kompozícia slúži úlohe.
Presný kód modelu je recraftv4_1_utility_pro. Referenčná dokumentácia výrobcu uvádza rastrový výstup 2K s jemnejšími detailmi vo formáte bezstratového WebP alebo PNG. Tabuľka veľkostí uvádza 2 048 × 2 048 pixelov pre štvorcové obrázky a 2 432 × 1 792 pre pomer 4:3, pričom ďalšie podporované pomery strán používajú vlastné rozmery. Tým sa Utility Pro odlišuje od výstupu 1K v štandardnom Utility. Obrázok sa tým nestáva upraviteľným vektorovým súborom; na tento účel poskytuje edícia Vector formát SVG.
Začnite zadaním, ktoré pomenuje predmet, materiál, uhol pohľadu, pozadie a niekoľko detailov, ktoré musia byť viditeľné. Pre produktovú ponuku vyžiadajte keramickú úložnú nádobu zobrazenú spredu na svetlom neutrálnom povrchu, rovnomerné osvetlenie, zatvorené viečko a voľný priestor okolo siluety. Ak má scéna zostať jednoduchá, uveďte to explicitne a nespoliehajte sa na to, že názov Utility v sebe zahŕňa všetky prezentačné rozhodnutia. Pri sérii obrázkov pre ponuky zachovajte požiadavky na záber a pozadie a meňte opis produktu.
Referenčná dokumentácia generovania V4.1 podporuje zadania s najviac 10 000 znakmi, ovládanie preferovaných farieb a farby pozadia, náhodný seed a jeden až šesť výstupov. Vzhľad môže viesť kompatibilný uložený štýl alebo voliteľné referenčné obrázky; vyhradená rodina V4 Styles je samostatný rad, pri ktorom je štýl vždy povinný. Pri voliteľných referenciách používajte jasné podklady so zhodným vizuálnym smerovaním. Presná reprodukcia farby z referencie nie je zaručená, preto požiadavka na farbu značky stále potrebuje explicitné zadanie a kontrolu výstupu. Pri generovaní podľa referenčného štýlu použite jeden až desať obrázkov PNG, JPG alebo WebP s celkovou veľkosťou najviac 64 MB a s veľkosťou každého menšou než 20 MB. Najkratšia strana každej referencie musí mať aspoň 256 pixelov, najdlhšia najviac 4 096 pixelov a rozlíšenie najviac 16 megapixelov. Použite buď tieto referencie, alebo kompatibilný uložený štýl, nie oboje. Pri generovaní podľa referenčného štýlu umožňuje flexibilné prispôsobenie voľnejšiu interpretáciu, zatiaľ čo presné prispôsobenie dôslednejšie sleduje vykreslenie, paletu, kompozíciu a osvetlenie.
Recraft tiež dokumentuje pre rad V4.1 postup image-to-image, ktorý spája existujúci obrázok so zadaním a intenzitou od 0 do 1. Nižšia intenzita zostáva bližšie k zdroju a vyššia hodnota umožňuje väčšiu zmenu. Je to užitočné, keď má východisková kompozícia alebo objekt ovplyvniť novú verziu. V tej istej transformačnej operácii neprijíma ovládacie prvky vlastného štýlu V4.1. Výrobca stanovuje pre vstupný obrázok limity menej než 20 MB, najviac 16 MP a strany od 256 do 4 096 pixelov.
Utility Pro zdieľa obmedzenia V4.1 pre ovládacie prvky negative_prompt, kurátorované názvy štýlov, text_layout, artistic_level a no_text. Dodajte kladný opis zamýšľanej scény a presné nápisy či rozloženie podľa potreby ponechajte na vhodný dokončovací krok. Pred tým, než produktový vizuál považujete za verný podklad pre ponuku, skontrolujte dodaný materiál, tvar a potrebné detaily. Užitočným výsledkom je väčšia rastrová kompozícia pripravená podľa jasného produktového zadania alebo zadania makety, pričom presné fakty o produkte zostávajú tie, ktoré boli dodané v úlohe.
", "aboutText": "Recraft V4.1 Utility Pro je rastrový variant vetvy Utility v rámci Recraft V4.1 s vyšším rozlíšením. Výrobca odlišuje priamočiaru prezentáciu Utility od expresívnejších volieb uhla, osvetlenia a kompozície v hlavnom modeli V4.1. Utility uprednostňuje jednoduché scény, rovnomerné osvetlenie a objekty zobrazené spredu. Preto sa hodí na vizuály produktových ponúk, makety a ďalšiu prácu, pri ktorej má byť predmet ľahko čitateľný a pokojná kompozícia slúži úlohe.\n\nPresný kód modelu je recraftv4_1_utility_pro. Referenčná dokumentácia výrobcu uvádza rastrový výstup 2K s jemnejšími detailmi vo formáte bezstratového WebP alebo PNG. Tabuľka veľkostí uvádza 2 048 × 2 048 pixelov pre štvorcové obrázky a 2 432 × 1 792 pre pomer 4:3, pričom ďalšie podporované pomery strán používajú vlastné rozmery. Tým sa Utility Pro odlišuje od výstupu 1K v štandardnom Utility. Obrázok sa tým nestáva upraviteľným vektorovým súborom; na tento účel poskytuje edícia Vector formát SVG.\n\nZačnite zadaním, ktoré pomenuje predmet, materiál, uhol pohľadu, pozadie a niekoľko detailov, ktoré musia byť viditeľné. Pre produktovú ponuku vyžiadajte keramickú úložnú nádobu zobrazenú spredu na svetlom neutrálnom povrchu, rovnomerné osvetlenie, zatvorené viečko a voľný priestor okolo siluety. Ak má scéna zostať jednoduchá, uveďte to explicitne a nespoliehajte sa na to, že názov Utility v sebe zahŕňa všetky prezentačné rozhodnutia. Pri sérii obrázkov pre ponuky zachovajte požiadavky na záber a pozadie a meňte opis produktu.\n\nReferenčná dokumentácia generovania V4.1 podporuje zadania s najviac 10 000 znakmi, ovládanie preferovaných farieb a farby pozadia, náhodný seed a jeden až šesť výstupov. Vzhľad môže viesť kompatibilný uložený štýl alebo voliteľné referenčné obrázky; vyhradená rodina V4 Styles je samostatný rad, pri ktorom je štýl vždy povinný. Pri voliteľných referenciách používajte jasné podklady so zhodným vizuálnym smerovaním. Presná reprodukcia farby z referencie nie je zaručená, preto požiadavka na farbu značky stále potrebuje explicitné zadanie a kontrolu výstupu. Pri generovaní podľa referenčného štýlu použite jeden až desať obrázkov PNG, JPG alebo WebP s celkovou veľkosťou najviac 64 MB a s veľkosťou každého menšou než 20 MB. Najkratšia strana každej referencie musí mať aspoň 256 pixelov, najdlhšia najviac 4 096 pixelov a rozlíšenie najviac 16 megapixelov. Použite buď tieto referencie, alebo kompatibilný uložený štýl, nie oboje. Pri generovaní podľa referenčného štýlu umožňuje flexibilné prispôsobenie voľnejšiu interpretáciu, zatiaľ čo presné prispôsobenie dôslednejšie sleduje vykreslenie, paletu, kompozíciu a osvetlenie.\n\nRecraft tiež dokumentuje pre rad V4.1 postup image-to-image, ktorý spája existujúci obrázok so zadaním a intenzitou od 0 do 1. Nižšia intenzita zostáva bližšie k zdroju a vyššia hodnota umožňuje väčšiu zmenu. Je to užitočné, keď má východisková kompozícia alebo objekt ovplyvniť novú verziu. V tej istej transformačnej operácii neprijíma ovládacie prvky vlastného štýlu V4.1. Výrobca stanovuje pre vstupný obrázok limity menej než 20 MB, najviac 16 MP a strany od 256 do 4 096 pixelov.\n\nUtility Pro zdieľa obmedzenia V4.1 pre ovládacie prvky negative_prompt, kurátorované názvy štýlov, text_layout, artistic_level a no_text. Dodajte kladný opis zamýšľanej scény a presné nápisy či rozloženie podľa potreby ponechajte na vhodný dokončovací krok. Pred tým, než produktový vizuál považujete za verný podklad pre ponuku, skontrolujte dodaný materiál, tvar a potrebné detaily. Užitočným výsledkom je väčšia rastrová kompozícia pripravená podľa jasného produktového zadania alebo zadania makety, pričom presné fakty o produkte zostávajú tie, ktoré boli dodané v úlohe.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "4ab70a547486129c188a85073e41d0242aa589c534de3983944d66d27e8c9c80", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sk", "methods": [ { "html": "recraft/recraft-v4.1-utility-proRecraft V4.1 Utility Pro generuje rastrové obrázky v rozlíšení 2K s dôrazom na jednoduché, predvídateľné scény, rovnomerné osvetlenie a kompozíciu spredu. Hodí sa na detailné produktové zábery a makety, ktoré potrebujú jasnú prezentáciu namiesto výrazného umeleckého smerovania.
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Recraft V4.1 Utility Pro je rastrový variant vetvy Utility v rámci Recraft V4.1 s vyšším rozlíšením. Výrobca odlišuje priamočiaru prezentáciu Utility od expresívnejších volieb uhla, osvetlenia a kompozície v hlavnom modeli V4.1. Utility uprednostňuje jednoduché scény, rovnomerné osvetlenie a objekty zobrazené spredu. Preto sa hodí na vizuály produktových ponúk, makety a ďalšiu prácu, pri ktorej má byť predmet ľahko čitateľný a pokojná kompozícia slúži úlohe.
Presný kód modelu je recraftv4_1_utility_pro. Referenčná dokumentácia výrobcu uvádza rastrový výstup 2K s jemnejšími detailmi vo formáte bezstratového WebP alebo PNG. Tabuľka veľkostí uvádza 2 048 × 2 048 pixelov pre štvorcové obrázky a 2 432 × 1 792 pre pomer 4:3, pričom ďalšie podporované pomery strán používajú vlastné rozmery. Tým sa Utility Pro odlišuje od výstupu 1K v štandardnom Utility. Obrázok sa tým nestáva upraviteľným vektorovým súborom; na tento účel poskytuje edícia Vector formát SVG.
Začnite zadaním, ktoré pomenuje predmet, materiál, uhol pohľadu, pozadie a niekoľko detailov, ktoré musia byť viditeľné. Pre produktovú ponuku vyžiadajte keramickú úložnú nádobu zobrazenú spredu na svetlom neutrálnom povrchu, rovnomerné osvetlenie, zatvorené viečko a voľný priestor okolo siluety. Ak má scéna zostať jednoduchá, uveďte to explicitne a nespoliehajte sa na to, že názov Utility v sebe zahŕňa všetky prezentačné rozhodnutia. Pri sérii obrázkov pre ponuky zachovajte požiadavky na záber a pozadie a meňte opis produktu.
Referenčná dokumentácia generovania V4.1 podporuje zadania s najviac 10 000 znakmi, ovládanie preferovaných farieb a farby pozadia, náhodný seed a jeden až šesť výstupov. Vzhľad môže viesť kompatibilný uložený štýl alebo voliteľné referenčné obrázky; vyhradená rodina V4 Styles je samostatný rad, pri ktorom je štýl vždy povinný. Pri voliteľných referenciách používajte jasné podklady so zhodným vizuálnym smerovaním. Presná reprodukcia farby z referencie nie je zaručená, preto požiadavka na farbu značky stále potrebuje explicitné zadanie a kontrolu výstupu. Pri generovaní podľa referenčného štýlu použite jeden až desať obrázkov PNG, JPG alebo WebP s celkovou veľkosťou najviac 64 MB a s veľkosťou každého menšou než 20 MB. Najkratšia strana každej referencie musí mať aspoň 256 pixelov, najdlhšia najviac 4 096 pixelov a rozlíšenie najviac 16 megapixelov. Použite buď tieto referencie, alebo kompatibilný uložený štýl, nie oboje. Pri generovaní podľa referenčného štýlu umožňuje flexibilné prispôsobenie voľnejšiu interpretáciu, zatiaľ čo presné prispôsobenie dôslednejšie sleduje vykreslenie, paletu, kompozíciu a osvetlenie.
Recraft tiež dokumentuje pre rad V4.1 postup image-to-image, ktorý spája existujúci obrázok so zadaním a intenzitou od 0 do 1. Nižšia intenzita zostáva bližšie k zdroju a vyššia hodnota umožňuje väčšiu zmenu. Je to užitočné, keď má východisková kompozícia alebo objekt ovplyvniť novú verziu. V tej istej transformačnej operácii neprijíma ovládacie prvky vlastného štýlu V4.1. Výrobca stanovuje pre vstupný obrázok limity menej než 20 MB, najviac 16 MP a strany od 256 do 4 096 pixelov.
Utility Pro zdieľa obmedzenia V4.1 pre ovládacie prvky negative_prompt, kurátorované názvy štýlov, text_layout, artistic_level a no_text. Dodajte kladný opis zamýšľanej scény a presné nápisy či rozloženie podľa potreby ponechajte na vhodný dokončovací krok. Pred tým, než produktový vizuál považujete za verný podklad pre ponuku, skontrolujte dodaný materiál, tvar a potrebné detaily. Užitočným výsledkom je väčšia rastrová kompozícia pripravená podľa jasného produktového zadania alebo zadania makety, pričom presné fakty o produkte zostávajú tie, ktoré boli dodané v úlohe.
POST /v1/images/generationstext, imageimage| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity recraft/recraft-v4.1-utility-pro | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Minimálna dĺžka: 1 | Predvolené— |
Poleaspect_ratio | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 1:1, 4:3, 3:4, 16:9, 9:16, auto | Predvolené— |
Polen | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 1 Maximum: 6 | Predvolené— |
Poleinput_references | Typarray | PožiadavkaVoliteľné | Hodnoty a limity Minimálny počet položiek: 0 Maximálny počet položiek: 1 | Predvolené— |
Poleprovider | Typobject | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt |
Parametermaterial_types | Špecifikáciatext, image |
Životný cyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · skutočne vrátené task_id alebo záznam v knižnici médií
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Odhadované množstvo | Účtovacia jednotka | Poplatok |
|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Účtovacia jednotka— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov |
| Konfiguráciavýstupný obrázok | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza výstupný obrázok | Poplatok Výstup · výstupný obrázok · Odhad iba na porovnanie $0.42 za výstupný obrázok |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Účtovacia jednotka— | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.42 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie. |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
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.1-utility-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\nStiahnite každý vrátený obrázok alebo uložte jeho obsah Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nUložte každý dokončený obrázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.
Uchovajte úplnú odpoveď a hlavičky, všetky skutočné výstupy, pôvodné vrátené identifikátory a všetky polia s údajmi o spotrebe. Obnovte pôvodnú operáciu bez opätovného odoslania požiadavky na vytvorenie.
Uchovajte vrátené X-Client-Request-ID na zosúladenie záznamov. Čítajte iba skutočne vrátené hodnoty task_id/asset_id alebo vlastnú knižnicu médií; nikdy nevytvárajte URL úlohy z ID operácie a nikdy znova neodosielajte požiadavku na vytvorenie.
| Pole | Typ |
|---|---|
Polecreated | Typ |
Poledata[].url | Typ |
Poledata[].b64_json | Typ |
Poleusage | Typ |
Ailoot Ultra recraft/recraft-v4.1-utility-pro
/v1/images