Recraft: Recraft V4 Styles

Recraft V4 Styles generuje rastrové obrázky 1K ve vizuálním stylu určeném referencemi. Je navržen pro každodenní práci se značkou a kampaněmi, kde má každý nový objekt zachovávat stejné vykreslení, texturu a celkový vzhled.

Ailoot Ultra · Obrázky POST /v1/images/generations recraft/recraft-v4-styles

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 Styles je standardní rastrová edice specializované rodiny Recraft pro generování s konzistentním stylem. Vytváří nový obrázek z textového promptu a současně sleduje styl stanovený referenčními materiály. Model je užitečný pro série ilustrací, bannerů nebo produktových scén se společným rozpoznatelným vizuálním zpracováním. Reference nese vykreslení, texturu a barevnou logiku; prompt přináší objekt a scénu pro každý nový materiál.

Výrobce uvádí rastrový výstup 1K v bezztrátovém WebP nebo PNG. Čtvercová velikost je 1024 × 1024 pixelů a dokumentovaná velikost 16:9 je 1344 × 768; formáty na výšku a další podporované poměry používají vlastní velikosti. Tato edice se liší od rastrového výstupu 2K Styles Pro i modelů Vector vytvářejících SVG. Poměr stran zvolte pro finální rozvržení místo předpokladu, že označení 1K znamená stejnou šířku a výšku všech obrázků.

Styl je povinný. Použijte jednu až deset referencí PNG, JPG nebo WebP nebo kompatibilní styl uložený z dřívějšího vytvoření stylu. Dokumentovaný postup nepřijímá uložený identifikátor stylu a nové reference současně. Referencemi mohou být existující materiály značky či kampaně místo obrázků původně generovaných Recraftem. Musí mít pod 20 MB na soubor a celkem nejvýše 64 MB. Před použitím stylu není třeba samostatná uživatelem spouštěná trénovací úloha. Každá reference musí mít nejkratší stranu alespoň 256 pixelů, nejdelší nejvýše 4 096 pixelů a celkové rozlišení nejvýše 16 megapixelů.

Začněte jednou silnou referencí nebo několika, které se již shodují na vizuálním jazyce. Konzistentní reference pomáhají používat styl napříč různými předměty a pózami; nesouvisející moodboard může přidat soupeřící motivy. Výchozí flexible matching ponechává více interpretačního prostoru; precise matching těsněji sleduje vykreslení, paletu, kompozici a osvětlení reference. Přesná reprodukce barev přesto není zaručena.

Pro sérii bannerů popište kurýra pokládajícího balík před dveře, klidnou vodorovnou kompozici a volný prostor na jedné straně pro pozdější text. Další zadání mohou měnit událost či úhel kamery při zachování stejného stylu. Výrobce dovoluje prompty do 10 000 znaků, preferované barvy, požadovanou barvu pozadí, náhodný seed a jeden až šest obrázků. Nepodporuje negative_prompt, názvy předpřipravených stylů ani text_layout, proto zamýšlený objekt a rozvržení popište přímo v zadání.

Řada Styles nenabízí image-to-image ani inpainting. Stylová reference vede nově generovaný obrázek místo záruky zachování předmětů či pixelů reference. Pokud sada působí opakovaně, upravte pózu, děj, rámování či detail scény místo přidávání konfliktní reference. Každý výsledek posuďte v zamýšleném rozvržení z hlediska jasnosti objektu, užitečného prostoru a souvislého vykreslení a pro další materiál ponechte stejný kompatibilní styl. Díky tomu je model praktický pro opakovatelný vizuální jazyk s měnícím se obsahem.

Ailoot Ultra · Obrázky POST /v1/images/generations recraft/recraft-v4-styles

recraft/recraft-v4-styles

Recraft /recraft/recraft-v4-styles

Ú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-styles	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, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 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: 1 Maximální počet položek: 10	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	Podmínky účtování	Poplatek
KonfiguraceZákladní sazby za tokeny	Tabulka sazebZákladní sazba	Předpokládané množství—	Účtovací jednotka—	Podmínky účtování—	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ů
KonfiguraceVstupní reference	Tabulka sazeb—	Předpokládané množství—	Účtovací jednotkaza požadavek	Podmínky účtováníVytvoření stylu při generování se stylovými referencemi; jednou za požadavek, navíc k ceně výstupního obrázku.	Poplatek Vstup · Vstupní reference · Odhad pouze pro srovnání $0.01 za požadavek
Konfiguracevýstupní obrázek	Tabulka sazeb—	Předpokládané množství—	Účtovací jednotkaza výstupní obrázek	Podmínky účtování—	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—	Podmínky účtování—	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í →

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-styles', '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-styles

Aliasy cest metod

/v1/images

Související ID modelů

recraft/recraft-v4-styles

FAQ · Recraft: Recraft V4 Styles

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

Recraft: Recraft V4 Styles