Recraft: Recraft V4 Styles Pro

Recraft V4 Styles Pro generuje rastrové obrázky 2K vo vizuálnom štýle určenom referenciami. Je navrhnutý pre podrobné kampaňové vizuály a obrazové sady, ktorých textúra, vykresľovanie, paleta a celkový vzhľad majú zostať konzistentné pri zmene subjektu.

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

O modeli

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 Styles Pro je rastrový model s vyšším rozlíšením v samostatnej rodine Recraft V4 Styles. Vytvára nový obrázok z textového zadania a vizuálneho štýlu dodaného prostredníctvom referenčných obrázkov alebo uloženého štýlu. Model je určený pre kampane, značkovú ilustráciu a ďalšie obrazové sady, pri ktorých treba prenášať vykresľovanie, textúru a kompozičný charakter z jedného vizuálu na ďalší. Je oddelený od Recraft V4 Pro a V4.1 Pro, pri ktorých je štýlový vstup voliteľný namiesto určujúcej požiadavky modelu.

Styles Pro vytvára rastrový výstup 2K s formátmi bezstratový WebP alebo PNG. Štvorcový výstup v tabuľke veľkostí výrobcu má 2048 × 2048 pixelov, zatiaľ čo výstup 16:9 má 2688 × 1536; ďalšie podporované pomery majú vlastné rozmery. Väčší výstup Pro môže byť užitočný pre podrobné kampaňové vizuály a väčšie rozloženia. Vektorové varianty naopak vytvárajú SVG a nemajú pevnú pixelovú veľkosť, preto túto rastrovú edíciu Pro nevyberajte, keď zamýšľaným výstupom je editovateľný vektorový súbor.

Každé generovanie v rodine Styles vyžaduje štýl. Dodajte jeden až desať referenčných obrázkov PNG, JPG alebo WebP alebo opakovane použite kompatibilný uložený štýl; identifikátor štýlu a nové referencie sú alternatívne vstupy, nie dvojica na kombinovanie. Postup výrobcu povoľuje spolu najviac 64 MB referencií, s každým súborom pod 20 MB. Vytvorenie štýlu nevyžaduje tréningový krok vykonávaný používateľom. Jedna jasná referencia môže určiť súdržný smer a viaceré pomáhajú vtedy, keď už zdieľajú rovnaký vizuálny jazyk namiesto konkurenčných vzhľadov. Každá referencia musí mať kratšiu stranu aspoň 256 pixelov, dlhšiu najviac 4 096 pixelov a celkové rozlíšenie najviac 16 megapixelov.

Flexibilná zhoda štýlu je predvolená a umožňuje voľnejšiu interpretáciu referencie. Presná zhoda bližšie sleduje vykresľovanie, paletu, kompozíciu a osvetlenie. Referencia definuje vizuálny jazyk; textové zadanie stále musí opísať nový subjekt, akciu, scénu a rámovanie. Pri podrobnej produktovej kampani určte sklenenú fľašu na svetlom kamennom povrchu, trojštvrťový pohľad, jemné bočné svetlo a voľný priestor pre nadpis, zatiaľ čo dodaná referencia prenáša fotografické spracovanie.

Model prijíma zadania do 10 000 znakov, podporuje preferované farby a požadovanú farbu pozadia a môže používať náhodný seed. Dokumentovaný postup generovania môže vrátiť jeden až šesť obrázkov. Jeho užitočné ovládanie sa líši od starších edícií Recraft: názvy kurátorovaných štýlov, negative_prompt a text_layout nie sú podporované a rodina Styles neposkytuje image-to-image ani inpainting. Referencia je zdrojom štýlu, nie maskou ani pokynom zachovať existujúcu fotografiu pixel po pixeli.

Pripravte čisté, dostatočne podrobné referenčné podklady a pri rozvíjaní sady opakovane používajte rovnaký štýl. Ak sa výstupy opakujú, meňte subjekt, pózu, uhol kamery alebo scénu v textovom zadaní namiesto pridávania nesúvisiacej referencie. Presná farebná zhoda referencie a výstupu nie je zaručená; ovládanie preferovaných farieb vyjadruje smer, nie výsledok farebnej korektúry. Pri konečnom kampaňovom vizuáli posúďte obrázok pri zamýšľanej veľkosti zobrazenia či tlače a overte, či subjekt, užitočný prázdny priestor a vizuálne spracovanie zodpovedajú zadaniu.

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

recraft/recraft-v4-styles-pro

Recraft /recraft/recraft-v4-styles-pro

Úvod

Povolené vstupy: Text · Obrázky
Výsledky: Obrázky

Dostupné v Ailoot · vstupy a metódy

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

Vstup: text, image
Výstup: image

Pole	Typ	Požiadavka	Hodnoty a limity	Predvolené
Pole`model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity recraft/recraft-v4-styles-pro	Predvolené—
Pole`prompt`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity Minimálna dĺžka: 1	Predvolené—
Pole`aspect_ratio`	Typ`string`	PožiadavkaVoliteľné	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	Predvolené—
Pole`n`	Typ`integer`	PožiadavkaVoliteľné	Hodnoty a limity Minimum: 1 Maximum: 6	Predvolené—
Pole`input_references`	Typ`array`	PožiadavkaVoliteľné	Hodnoty a limity Minimálny počet položiek: 1 Maximálny počet položiek: 10	Predvolené—
Pole`provider`	Typ`object`	PožiadavkaVoliteľné	Hodnoty a limity	Predvolené—

Parametre a životný cyklus metódy

Parameter	Špecifikácia
Parameter`content_type`	Špecifikáciaapplication/json
Parameter`required`	Špecifikáciamodel, prompt
Parameter`material_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}

Cenník

Ako sa vypočíta konečný poplatok

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.

Rýchly režim: Neuvedené Keď je zvolený rýchly režim
Režim Flex: Neuvedené Keď je zvolený režim flex
Maximálna úroveň uvažovania: Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)

Odhadované sadzby na porovnanie

Ceny podľa konfigurácie

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	Podmienky účtovania	Poplatok
KonfiguráciaZákladné sadzby za tokeny	SadzobníkZákladná sadzba	Odhadované množstvo—	Účtovacia jednotka—	Podmienky účtovania—	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áciaVstupná referencia	Sadzobník—	Odhadované množstvo—	Účtovacia jednotkaza požiadavku	Podmienky účtovaniaVytvorenie štýlu pri generovaní s referenciami štýlu; raz za požiadavku, navyše k cene výstupného obrázka.	Poplatok Vstup · Vstupná referencia · Odhad iba na porovnanie $0.01 za požiadavku
Konfiguráciavýstupný obrázok	Sadzobník—	Odhadované množstvo—	Účtovacia jednotkaza výstupný obrázok	Podmienky účtovania—	Poplatok Výstup · výstupný obrázok · Odhad iba na porovnanie $0.2 za výstupný obrázok
KonfiguráciaOdhadované náklady na generovanie	Sadzobník—	Odhadované množstvoodhad pre jedno generovanie	Účtovacia jednotka—	Podmienky účtovania—	Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.2 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 →

Príklady požiadaviek

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-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

Prijať a uložiť výsledky

Ailoot Ultra · Obrázky

Stiahnite každý vrátený obrázok alebo 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}

Čítanie ďalšieho obsahu

Čítať existujúce podklady, ktoré vám patria

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.

Uchovať všetky dokončené výsledky

Ulož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.

Ak treba overiť pôvodnú odpoveď

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.

Polia odpovede

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

Aliasy

Aliasy modelov

Ailoot Ultra recraft/recraft-v4-styles-pro

Aliasy ciest metód

/v1/images

Súvisiace ID na volanie

recraft/recraft-v4-styles-pro

FAQ · Recraft: Recraft V4 Styles Pro

Aké vstupy a výsledky sú dostupné?: POST /v1/images/generations · recraft/recraft-v4-styles-pro: text, image → image
Aké polia používa požiadavka?: POST /v1/images/generations · recraft/recraft-v4-styles-pro: model, prompt, aspect_ratio, n, input_references, provider
Aké limity platia?: POST /v1/images/generations · recraft/recraft-v4-styles-pro: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4 Styles Pro