Recraft: Recraft V4.1 Utility Pro

Recraft V4.1 Utility Pro vytváří rastrové obrázky v rozlišení 2K s důrazem na jednoduché, předvídatelné scény, rovnoměrné osvětlení a čelní kompozici. Hodí se pro detailní produktové snímky a mockupy vyžadující jasnou prezentaci spíše než výrazné umělecké pojetí.

Ailoot Ultra · Obrázky POST /v1/images/generations recraft/recraft-v4.1-utility-pro

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.1 Utility Pro je rastrová varianta větve Utility v rámci Recraft V4.1 s vyšším rozlišením. Výrobce odlišuje přímočarou prezentaci Utility od výraznější volby úhlů, osvětlení a kompozice u hlavního modelu V4.1. Utility upřednostňuje jednoduché scény, rovnoměrné osvětlení a objekty zepředu. Hodí se proto pro vizuály produktových nabídek, mockupy a další práci, kde má být předmět snadno čitelný a úloze prospívá klidná kompozice.

Přesný kód modelu je recraftv4_1_utility_pro. Dokumentace výrobce uvádí rastrový výstup 2K s jemnějšími detaily v bezztrátovém WebP nebo PNG. Tabulka velikostí stanovuje 2048 × 2048 pixelů pro čtvercové obrázky a 2432 × 1792 pro poměr 4:3, přičemž další podporované poměry stran mají vlastní rozměry. Tím se Utility Pro liší od výstupu 1K standardního Utility. Obrázek se tím nestává upravitelným vektorovým souborem; pro tento účel poskytuje edice Vector formát SVG.

Začněte zadáním, které pojmenuje předmět, materiál, úhel pohledu, pozadí a několik detailů, které musí být viditelné. Pro produktovou nabídku si vyžádejte čelní pohled na keramickou úložnou dózu na světlém neutrálním povrchu, rovnoměrné osvětlení, zavřené víko a volné místo kolem siluety. Má-li scéna zůstat jednoduchá, uveďte to výslovně a nespoléhejte na to, že název Utility zahrnuje všechny volby prezentace. U série produktových obrázků zachovejte stejné požadavky na záběr a pozadí a měňte popis produktu.

Dokumentace generování V4.1 podporuje zadání o délce až 10 000 znaků, nastavení preferovaných barev a barvy pozadí, náhodný seed a jeden až šest výstupů. Vzhled může řídit kompatibilní uložený styl nebo volitelné obrazové předlohy; specializovaná rodina V4 Styles je samostatná řada, kde je styl vždy povinný. Pro volitelné předlohy používejte jasné podklady se vzájemně slučitelným vizuálním směrem. Přesná reprodukce barev z předlohy není zaručena, takže požadavek na barvu značky stále potřebuje výslovné zadání a kontrolu výstupu. Pro generování podle referenčního stylu použijte jeden až deset obrázků PNG, JPG nebo WebP, celkem nejvýše 64 MB a každý menší než 20 MB. Každá předloha musí mít kratší stranu alespoň 256 pixelů, delší stranu nejvýše 4 096 pixelů a rozlišení nejvýše 16 megapixelů. Použijte buď tyto předlohy, nebo kompatibilní uložený styl, nikoli obojí. Při generování podle referenčního stylu umožňuje flexibilní shoda volnější interpretaci, zatímco přesná shoda důsledněji sleduje způsob vykreslení, paletu, kompozici a osvětlení.

Recraft také pro řadu V4.1 dokumentuje převod obrázku na obrázek, který kombinuje stávající obrázek se zadáním a intenzitou od 0 do 1. Nižší intenzita zůstává blíže zdroji a vyšší hodnota dovoluje větší změnu. To se hodí, když má výchozí kompozice nebo hlavní motiv ovlivnit novou verzi. Tatáž transformační operace nepřijímá nastavení vlastních stylů V4.1. Limity obrazového vstupu výrobce jsou velikost pod 20 MB, rozlišení do 16 MP a strany mezi 256 a 4096 pixely.

Utility Pro sdílí omezení V4.1 pro ovládací prvky negative_prompt, předvolené názvy stylů, text_layout, artistic_level a no_text. Zamýšlenou scénu popište kladně a přesné nápisy nebo práci s rozvržením podle potřeby ponechte vhodnému dokončovacímu kroku. Než produktový vizuál přijmete jako věrný podklad nabídky, zkontrolujte dodaný materiál, tvar a potřebné detaily. Užitečným výsledkem je větší rastrová kompozice připravená podle jasného produktového zadání nebo zadání mockupu, přičemž přesná fakta o produktu zůstávají ta, která dodává úloha.

Ailoot Ultra · Obrázky POST /v1/images/generations recraft/recraft-v4.1-utility-pro

recraft/recraft-v4.1-utility-pro

Recraft /recraft/recraft-v4.1-utility-pro

Úvod

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

Dostupné v Ailoot · vstupy a metody

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

Vstup: text, image
Výstup: image

Pole	Typ	Požadavek	Hodnoty a limity	Výchozí
Pole`model`	Typ`string`	PožadavekPovinné	Hodnoty a limity recraft/recraft-v4.1-utility-pro	Výchozí—
Pole`prompt`	Typ`string`	PožadavekPovinné	Hodnoty a limity Minimální délka: 1	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`n`	Typ`integer`	PožadavekVolitelné	Hodnoty a limity Minimum: 1 Maximum: 6	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í—
Pole`provider`	Typ`object`	PožadavekVolitelné	Hodnoty a limity	Výchozí—

Parametry a životní cyklus metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, prompt
Parametr`material_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}

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ů
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.42 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.42 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í →

Příklady požadavků

Ailoot Ultra · Obrázky

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'recraft/recraft-v4.1-utility-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        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"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

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}

Další načtení obsahu

Načíst existující soubory, které vám patří

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

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 ú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í.

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

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 odpovědi

Pole	Typ
Pole`created`	Typ
Pole`data[].url`	Typ
Pole`data[].b64_json`	Typ
Pole`usage`	Typ

Aliasy

Aliasy modelu

Ailoot Ultra recraft/recraft-v4.1-utility-pro

Aliasy cest metod

/v1/images

Související ID modelů

recraft/recraft-v4.1-utility-pro

FAQ · Recraft: Recraft V4.1 Utility Pro

Jaké vstupy a výsledky jsou dostupné?: POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: text, image → image
Jaká pole požadavek používá?: POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: model, prompt, aspect_ratio, n, input_references, provider
Jaké limity platí?: POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4.1 Utility Pro