Recraft V4.1 Utility je štandardný rastrový model Utility v rodine Recraft V4.1. Uprednostňuje jednoduché scény, rovnomerné osvetlenie a čelnú kompozíciu oproti expresívnejším voľbám uhla, svetla a nálady hlavného modelu V4.1. Jeho praktickou úlohou je jasný produktový záber alebo maketa, v ktorých má dominovať predmet a potrebné detaily. Presná edícia Utility je oddelená od Utility Pro, hlavného modelu V4.1 a vektorových variantov vytvárajúcich SVG.
Kód modelu výrobcu je recraftv4_1_utility. Vracia rastrové obrázky 1K v bezstratovom WebP alebo PNG s veľkosťami vybranými z podporovaných pomerov strán. Štvorcový obrázok má 1024 × 1024 pixelov a obrázok 4:3 má 1216 × 896. Edícia Pro Utility používa väčšie rozmery 2K, preto tieto výstupné veľkosti nemožno priraďovať štandardnému Utility. Pred opisom scény vyberte formát zamýšľaného produktového záznamu alebo makety.
Užitočné zadanie pomenúva produkt, uhol pohľadu, materiál, povrch, pozadie a osvetlenie jednoduchými slovami. Pri produktovom zázname požadujte čelný pohľad na izolačnú fľašu na svetlom pozadí, rovnomerne osvetlenú, s viditeľnou celou siluetou a bez rušivých prvkov scény. Ak produkt má skutočné rozmery alebo rozlišujúce časti, tieto detaily dodajte výslovne. Uprednostňovanie priamej prezentácie v Utility nepotvrdzuje fakty o reálnom produkte, ktoré v zadaní chýbali.
Generovanie podporuje zadania do 10 000 znakov, ovládanie preferovaných farieb a farby pozadia, náhodný seed a jeden až šesť výstupov. Voliteľné kompatibilné vlastné štýly či referenčné obrázky môžu usmerňovať vizuálny jazyk katalógu. Používajte referenčné podklady zhodujúce sa v osvetlení a vykresľovaní a pre ďalšie produktové zadania zachovajte rovnaký kompatibilný štýl. Presná farebná zhoda referencie a výstupu nie je zaručená, preto konečný vizuál porovnajte s požadovanou paletou. Pri generovaní podľa referenčného štýlu použite jeden až desať obrázkov PNG, JPG alebo WebP, spolu najviac 64 MB a každý pod 20 MB. Každá referencia potrebuje kratšiu stranu aspoň 256 pixelov, dlhšiu stranu najviac 4 096 pixelov a rozlíšenie najviac 16 megapixelov. Použite buď tieto referencie, alebo kompatibilný uložený štýl, nie obe možnosti. Pri generovaní podľa referenčného štýlu flexibilná zhoda umožňuje voľnejšiu interpretáciu, kým presná zhoda bližšie sleduje vykresľovanie, paletu, kompozíciu a osvetlenie.
Samostatný postup image-to-image používa existujúci obrázok a zadanie so silou od 0 do 1 riadiacou rozsah zmeny. Nižšia sila drží výsledok bližšie zdroju; vyššia mu umožňuje väčšiu odchýlku. Vstupom môže byť PNG, JPG, WebP alebo SVG pod 20 MB, do 16 MP, so stranami od 256 do 4096 pixelov. Táto transformačná operácia neprijíma vlastné štýly V4.1 a je odlišná od pripojenia štýlovej referencie k novému generovaniu.
V4.1 Utility neprijíma názvy kurátorovaných štýlov ani ovládania negative_prompt, text_layout, artistic_level alebo no_text. Požadovanú dokončenú scénu zadajte priamo v pozitívnom zadaní. Pri sérii produktových vizuálov udržujte stabilné pokyny na rámovanie a pozadie a pred použitím v rozložení porovnajte každý obrázok s dodaným tvarom, materiálom a detailmi produktu. Štandardný Utility je sústredený rastrový nástroj na zdržanlivú prezentáciu; konkrétny výstupný formát a edíciu vyberte podľa úlohy.
", "aboutText": "Recraft V4.1 Utility je štandardný rastrový model Utility v rodine Recraft V4.1. Uprednostňuje jednoduché scény, rovnomerné osvetlenie a čelnú kompozíciu oproti expresívnejším voľbám uhla, svetla a nálady hlavného modelu V4.1. Jeho praktickou úlohou je jasný produktový záber alebo maketa, v ktorých má dominovať predmet a potrebné detaily. Presná edícia Utility je oddelená od Utility Pro, hlavného modelu V4.1 a vektorových variantov vytvárajúcich SVG.\n\nKód modelu výrobcu je recraftv4_1_utility. Vracia rastrové obrázky 1K v bezstratovom WebP alebo PNG s veľkosťami vybranými z podporovaných pomerov strán. Štvorcový obrázok má 1024 × 1024 pixelov a obrázok 4:3 má 1216 × 896. Edícia Pro Utility používa väčšie rozmery 2K, preto tieto výstupné veľkosti nemožno priraďovať štandardnému Utility. Pred opisom scény vyberte formát zamýšľaného produktového záznamu alebo makety.\n\nUžitočné zadanie pomenúva produkt, uhol pohľadu, materiál, povrch, pozadie a osvetlenie jednoduchými slovami. Pri produktovom zázname požadujte čelný pohľad na izolačnú fľašu na svetlom pozadí, rovnomerne osvetlenú, s viditeľnou celou siluetou a bez rušivých prvkov scény. Ak produkt má skutočné rozmery alebo rozlišujúce časti, tieto detaily dodajte výslovne. Uprednostňovanie priamej prezentácie v Utility nepotvrdzuje fakty o reálnom produkte, ktoré v zadaní chýbali.\n\nGenerovanie podporuje zadania do 10 000 znakov, ovládanie preferovaných farieb a farby pozadia, náhodný seed a jeden až šesť výstupov. Voliteľné kompatibilné vlastné štýly či referenčné obrázky môžu usmerňovať vizuálny jazyk katalógu. Používajte referenčné podklady zhodujúce sa v osvetlení a vykresľovaní a pre ďalšie produktové zadania zachovajte rovnaký kompatibilný štýl. Presná farebná zhoda referencie a výstupu nie je zaručená, preto konečný vizuál porovnajte s požadovanou paletou. Pri generovaní podľa referenčného štýlu použite jeden až desať obrázkov PNG, JPG alebo WebP, spolu najviac 64 MB a každý pod 20 MB. Každá referencia potrebuje kratšiu stranu aspoň 256 pixelov, dlhšiu stranu najviac 4 096 pixelov a rozlíšenie najviac 16 megapixelov. Použite buď tieto referencie, alebo kompatibilný uložený štýl, nie obe možnosti. Pri generovaní podľa referenčného štýlu flexibilná zhoda umožňuje voľnejšiu interpretáciu, kým presná zhoda bližšie sleduje vykresľovanie, paletu, kompozíciu a osvetlenie.\n\nSamostatný postup image-to-image používa existujúci obrázok a zadanie so silou od 0 do 1 riadiacou rozsah zmeny. Nižšia sila drží výsledok bližšie zdroju; vyššia mu umožňuje väčšiu odchýlku. Vstupom môže byť PNG, JPG, WebP alebo SVG pod 20 MB, do 16 MP, so stranami od 256 do 4096 pixelov. Táto transformačná operácia neprijíma vlastné štýly V4.1 a je odlišná od pripojenia štýlovej referencie k novému generovaniu.\n\nV4.1 Utility neprijíma názvy kurátorovaných štýlov ani ovládania negative_prompt, text_layout, artistic_level alebo no_text. Požadovanú dokončenú scénu zadajte priamo v pozitívnom zadaní. Pri sérii produktových vizuálov udržujte stabilné pokyny na rámovanie a pozadie a pred použitím v rozložení porovnajte každý obrázok s dodaným tvarom, materiálom a detailmi produktu. Štandardný Utility je sústredený rastrový nástroj na zdržanlivú prezentáciu; konkrétny výstupný formát a edíciu vyberte podľa úlohy.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "6b19aa6a25cd830c93fbe71ccfc9e537d7d4743822eb7a5eb60ae4b1beffcda1", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sk", "methods": [ { "html": "recraft/recraft-v4.1-utilityRecraft V4.1 Utility generuje rastrové obrázky 1K pre jednoduché produktové zábery, makety a nenáročné scény. Uprednostňuje rovnomerné osvetlenie a čelnú kompozíciu s textovými zadaniami a voliteľnými obrazovými či štýlovými vstupmi pre predvídateľný vizuálny smer.
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 je štandardný rastrový model Utility v rodine Recraft V4.1. Uprednostňuje jednoduché scény, rovnomerné osvetlenie a čelnú kompozíciu oproti expresívnejším voľbám uhla, svetla a nálady hlavného modelu V4.1. Jeho praktickou úlohou je jasný produktový záber alebo maketa, v ktorých má dominovať predmet a potrebné detaily. Presná edícia Utility je oddelená od Utility Pro, hlavného modelu V4.1 a vektorových variantov vytvárajúcich SVG.
Kód modelu výrobcu je recraftv4_1_utility. Vracia rastrové obrázky 1K v bezstratovom WebP alebo PNG s veľkosťami vybranými z podporovaných pomerov strán. Štvorcový obrázok má 1024 × 1024 pixelov a obrázok 4:3 má 1216 × 896. Edícia Pro Utility používa väčšie rozmery 2K, preto tieto výstupné veľkosti nemožno priraďovať štandardnému Utility. Pred opisom scény vyberte formát zamýšľaného produktového záznamu alebo makety.
Užitočné zadanie pomenúva produkt, uhol pohľadu, materiál, povrch, pozadie a osvetlenie jednoduchými slovami. Pri produktovom zázname požadujte čelný pohľad na izolačnú fľašu na svetlom pozadí, rovnomerne osvetlenú, s viditeľnou celou siluetou a bez rušivých prvkov scény. Ak produkt má skutočné rozmery alebo rozlišujúce časti, tieto detaily dodajte výslovne. Uprednostňovanie priamej prezentácie v Utility nepotvrdzuje fakty o reálnom produkte, ktoré v zadaní chýbali.
Generovanie podporuje zadania do 10 000 znakov, ovládanie preferovaných farieb a farby pozadia, náhodný seed a jeden až šesť výstupov. Voliteľné kompatibilné vlastné štýly či referenčné obrázky môžu usmerňovať vizuálny jazyk katalógu. Používajte referenčné podklady zhodujúce sa v osvetlení a vykresľovaní a pre ďalšie produktové zadania zachovajte rovnaký kompatibilný štýl. Presná farebná zhoda referencie a výstupu nie je zaručená, preto konečný vizuál porovnajte s požadovanou paletou. Pri generovaní podľa referenčného štýlu použite jeden až desať obrázkov PNG, JPG alebo WebP, spolu najviac 64 MB a každý pod 20 MB. Každá referencia potrebuje kratšiu stranu aspoň 256 pixelov, dlhšiu stranu najviac 4 096 pixelov a rozlíšenie najviac 16 megapixelov. Použite buď tieto referencie, alebo kompatibilný uložený štýl, nie obe možnosti. Pri generovaní podľa referenčného štýlu flexibilná zhoda umožňuje voľnejšiu interpretáciu, kým presná zhoda bližšie sleduje vykresľovanie, paletu, kompozíciu a osvetlenie.
Samostatný postup image-to-image používa existujúci obrázok a zadanie so silou od 0 do 1 riadiacou rozsah zmeny. Nižšia sila drží výsledok bližšie zdroju; vyššia mu umožňuje väčšiu odchýlku. Vstupom môže byť PNG, JPG, WebP alebo SVG pod 20 MB, do 16 MP, so stranami od 256 do 4096 pixelov. Táto transformačná operácia neprijíma vlastné štýly V4.1 a je odlišná od pripojenia štýlovej referencie k novému generovaniu.
V4.1 Utility neprijíma názvy kurátorovaných štýlov ani ovládania negative_prompt, text_layout, artistic_level alebo no_text. Požadovanú dokončenú scénu zadajte priamo v pozitívnom zadaní. Pri sérii produktových vizuálov udržujte stabilné pokyny na rámovanie a pozadie a pred použitím v rozložení porovnajte každý obrázok s dodaným tvarom, materiálom a detailmi produktu. Štandardný Utility je sústredený rastrový nástroj na zdržanlivú prezentáciu; konkrétny výstupný formát a edíciu vyberte podľa úlohy.
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 | 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.07 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.07 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', '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
/v1/images