Recraft V4.1 Utility je standardní rastrový model Utility v rodině Recraft V4.1. Upřednostňuje jednoduché scény, ploché osvětlení a čelní kompozici oproti výraznějším volbám úhlů, světla a nálady hlavního modelu V4.1. Jeho praktickou rolí je jasný produktový snímek nebo mockup, v němž mají dominovat předmět a potřebné detaily. Konkrétní edice Utility je oddělená od Utility Pro, hlavního modelu V4.1 a vektorových variant vytvářejících SVG.
Kód modelu výrobce je recraftv4_1_utility. Vrací rastrové obrázky 1K v bezztrátovém WebP nebo PNG s velikostmi vybranými z podporovaných poměrů stran. Čtvercový obrázek má 1024 × 1024 pixelů a obrázek 4:3 má 1216 × 896. Edice Pro Utility používá větší rozměry 2K, proto se tyto velikosti výstupu nemají přiřazovat standardnímu Utility. Před popisem scény zvolte formát zamýšlené produktové karty či mockupu.
Užitečné zadání pojmenuje produkt, úhel pohledu, materiál, povrch, pozadí a osvětlení prostými výrazy. Pro produktovou nabídku požadujte čelní pohled na termoizolační láhev na světlém pozadí, rovnoměrně nasvícenou, s viditelnou celou siluetou a bez rušivých prvků scény. Pokud má produkt skutečné rozměry či charakteristické součásti, dodejte tyto údaje explicitně. Preference přímočaré prezentace Utility nedokládá fakta o skutečném produktu, která v zadání chyběla.
Generování podporuje prompty do 10 000 znaků, ovládání preferovaných barev a barvy pozadí, náhodný seed a jeden až šest výstupů. Volitelné kompatibilní vlastní styly či referenční obrázky mohou vést vizuální jazyk katalogu. Použijte referenční materiály se shodným osvětlením a vykreslením a pro další produktová zadání ponechte stejný kompatibilní styl. Přesná barevná shoda reference s výstupem není zaručena, proto finální vizuál porovnejte s požadovanou paletou. 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í. Při generování podle stylových referencí dovoluje flexible matching volnější interpretaci, zatímco precise matching těsněji sleduje vykreslení, paletu, kompozici a osvětlení.
Samostatný postup image-to-image používá existující obrázek a prompt se silou od 0 do 1, která řídí rozsah změny. Nižší síla drží výsledek blíže zdroji; vyšší mu dovoluje větší odchylku. Vstup může být PNG, JPG, WebP nebo SVG pod 20 MB, do 16 MP, se stranami mezi 256 a 4096 pixely. V této transformační operaci se nepřijímají vlastní styly V4.1; liší se od připojení stylové reference k novému generování.
V4.1 Utility nepřijímá názvy předpřipravených stylů ani ovládání negative_prompt, text_layout, artistic_level či no_text. Požadovanou hotovou scénu zadejte přímo v pozitivním promptu. U série produktových materiálů ponechte stabilní pokyny k rámování a pozadí a před použitím v rozvržení každý obrázek porovnejte s dodaným tvarem produktu, materiálem a detaily. Standardní Utility je soustředěný rastrový nástroj pro zdrženlivou prezentaci; konkrétní výstupní formát a edici zvolte podle úlohy.
", "aboutText": "Recraft V4.1 Utility je standardní rastrový model Utility v rodině Recraft V4.1. Upřednostňuje jednoduché scény, ploché osvětlení a čelní kompozici oproti výraznějším volbám úhlů, světla a nálady hlavního modelu V4.1. Jeho praktickou rolí je jasný produktový snímek nebo mockup, v němž mají dominovat předmět a potřebné detaily. Konkrétní edice Utility je oddělená od Utility Pro, hlavního modelu V4.1 a vektorových variant vytvářejících SVG.\n\nKód modelu výrobce je recraftv4_1_utility. Vrací rastrové obrázky 1K v bezztrátovém WebP nebo PNG s velikostmi vybranými z podporovaných poměrů stran. Čtvercový obrázek má 1024 × 1024 pixelů a obrázek 4:3 má 1216 × 896. Edice Pro Utility používá větší rozměry 2K, proto se tyto velikosti výstupu nemají přiřazovat standardnímu Utility. Před popisem scény zvolte formát zamýšlené produktové karty či mockupu.\n\nUžitečné zadání pojmenuje produkt, úhel pohledu, materiál, povrch, pozadí a osvětlení prostými výrazy. Pro produktovou nabídku požadujte čelní pohled na termoizolační láhev na světlém pozadí, rovnoměrně nasvícenou, s viditelnou celou siluetou a bez rušivých prvků scény. Pokud má produkt skutečné rozměry či charakteristické součásti, dodejte tyto údaje explicitně. Preference přímočaré prezentace Utility nedokládá fakta o skutečném produktu, která v zadání chyběla.\n\nGenerování podporuje prompty do 10 000 znaků, ovládání preferovaných barev a barvy pozadí, náhodný seed a jeden až šest výstupů. Volitelné kompatibilní vlastní styly či referenční obrázky mohou vést vizuální jazyk katalogu. Použijte referenční materiály se shodným osvětlením a vykreslením a pro další produktová zadání ponechte stejný kompatibilní styl. Přesná barevná shoda reference s výstupem není zaručena, proto finální vizuál porovnejte s požadovanou paletou. 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í. Při generování podle stylových referencí dovoluje flexible matching volnější interpretaci, zatímco precise matching těsněji sleduje vykreslení, paletu, kompozici a osvětlení.\n\nSamostatný postup image-to-image používá existující obrázek a prompt se silou od 0 do 1, která řídí rozsah změny. Nižší síla drží výsledek blíže zdroji; vyšší mu dovoluje větší odchylku. Vstup může být PNG, JPG, WebP nebo SVG pod 20 MB, do 16 MP, se stranami mezi 256 a 4096 pixely. V této transformační operaci se nepřijímají vlastní styly V4.1; liší se od připojení stylové reference k novému generování.\n\nV4.1 Utility nepřijímá názvy předpřipravených stylů ani ovládání negative_prompt, text_layout, artistic_level či no_text. Požadovanou hotovou scénu zadejte přímo v pozitivním promptu. U série produktových materiálů ponechte stabilní pokyny k rámování a pozadí a před použitím v rozvržení každý obrázek porovnejte s dodaným tvarem produktu, materiálem a detaily. Standardní Utility je soustředěný rastrový nástroj pro zdrženlivou prezentaci; konkrétní výstupní formát a edici zvolte podle úlohy.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "f642f27b73e29491095c3b629f5d152d43267e21d1387d4a01b88579951748de", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "cs", "methods": [ { "html": "recraft/recraft-v4.1-utilityRecraft V4.1 Utility generuje rastrové obrázky 1K pro přímočaré produktové snímky, mockupy a jednoduché scény. Upřednostňuje ploché osvětlení a čelní kompozici s textovými prompty a volitelnými obrazovými či stylovými vstupy pro předvídatelný vizuální směr.
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
Recraft V4.1 Utility je standardní rastrový model Utility v rodině Recraft V4.1. Upřednostňuje jednoduché scény, ploché osvětlení a čelní kompozici oproti výraznějším volbám úhlů, světla a nálady hlavního modelu V4.1. Jeho praktickou rolí je jasný produktový snímek nebo mockup, v němž mají dominovat předmět a potřebné detaily. Konkrétní edice Utility je oddělená od Utility Pro, hlavního modelu V4.1 a vektorových variant vytvářejících SVG.
Kód modelu výrobce je recraftv4_1_utility. Vrací rastrové obrázky 1K v bezztrátovém WebP nebo PNG s velikostmi vybranými z podporovaných poměrů stran. Čtvercový obrázek má 1024 × 1024 pixelů a obrázek 4:3 má 1216 × 896. Edice Pro Utility používá větší rozměry 2K, proto se tyto velikosti výstupu nemají přiřazovat standardnímu Utility. Před popisem scény zvolte formát zamýšlené produktové karty či mockupu.
Užitečné zadání pojmenuje produkt, úhel pohledu, materiál, povrch, pozadí a osvětlení prostými výrazy. Pro produktovou nabídku požadujte čelní pohled na termoizolační láhev na světlém pozadí, rovnoměrně nasvícenou, s viditelnou celou siluetou a bez rušivých prvků scény. Pokud má produkt skutečné rozměry či charakteristické součásti, dodejte tyto údaje explicitně. Preference přímočaré prezentace Utility nedokládá fakta o skutečném produktu, která v zadání chyběla.
Generování podporuje prompty do 10 000 znaků, ovládání preferovaných barev a barvy pozadí, náhodný seed a jeden až šest výstupů. Volitelné kompatibilní vlastní styly či referenční obrázky mohou vést vizuální jazyk katalogu. Použijte referenční materiály se shodným osvětlením a vykreslením a pro další produktová zadání ponechte stejný kompatibilní styl. Přesná barevná shoda reference s výstupem není zaručena, proto finální vizuál porovnejte s požadovanou paletou. 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í. Při generování podle stylových referencí dovoluje flexible matching volnější interpretaci, zatímco precise matching těsněji sleduje vykreslení, paletu, kompozici a osvětlení.
Samostatný postup image-to-image používá existující obrázek a prompt se silou od 0 do 1, která řídí rozsah změny. Nižší síla drží výsledek blíže zdroji; vyšší mu dovoluje větší odchylku. Vstup může být PNG, JPG, WebP nebo SVG pod 20 MB, do 16 MP, se stranami mezi 256 a 4096 pixely. V této transformační operaci se nepřijímají vlastní styly V4.1; liší se od připojení stylové reference k novému generování.
V4.1 Utility nepřijímá názvy předpřipravených stylů ani ovládání negative_prompt, text_layout, artistic_level či no_text. Požadovanou hotovou scénu zadejte přímo v pozitivním promptu. U série produktových materiálů ponechte stabilní pokyny k rámování a pozadí a před použitím v rozvržení každý obrázek porovnejte s dodaným tvarem produktu, materiálem a detaily. Standardní Utility je soustředěný rastrový nástroj pro zdrženlivou prezentaci; konkrétní výstupní formát a edici zvolte podle úlohy.
POST /v1/images/generationstext, imageimage| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity recraft/recraft-v4.1-utility | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity Minimální délka: 1 | Výchozí— |
Poleaspect_ratio | Typstring | PožadavekVolitelné | Hodnoty a limity 1:1, 4:3, 3:4, 16:9, 9:16, auto | Výchozí— |
Polen | Typinteger | PožadavekVolitelné | Hodnoty a limity Minimum: 1 Maximum: 6 | Výchozí— |
Poleinput_references | Typarray | PožadavekVolitelné | Hodnoty a limity Minimální počet položek: 0 Maximální počet položek: 1 | Výchozí— |
Poleprovider | Typobject | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt |
Parametrmaterial_types | Kontrakttext, image |
Ž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}
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.
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ů |
| Konfiguracevýstupní obrázek | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza výstupní obrázek | Poplatek Výstup · výstupní obrázek · Odhad pouze pro srovnání $0.07 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.07 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í →
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\nStá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}/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ázek; stáhněte obsah každé vrácené URL nebo dekódujte obsah Base64.
Uchovejte úplnou odpověď a hlavičky, všechny skutečné výstupy, původní vrácené identifikátory a všechna pole s údaji o využití. Obnovte původní operaci bez opětovného odeslání požadavku na vytvoření.
Uchovejte vrácené X-Client-Request-ID pro spárování záznamů. Načítejte pouze skutečně vrácené hodnoty task_id/asset_id nebo vlastní knihovnu médií; nikdy nevytvářejte URL úlohy z ID operace a nikdy znovu neodesílejte požadavek na vytvoření.
| Pole | Typ |
|---|---|
Polecreated | Typ |
Poledata[].url | Typ |
Poledata[].b64_json | Typ |
Poleusage | Typ |
Ailoot Ultra recraft/recraft-v4.1-utility
/v1/images