Recraft: Recraft V4.1 Utility Pro

Recraft V4.1 Utility Pro generuje rastrové obrázky v rozlíšení 2K s dôrazom na jednoduché, predvídateľné scény, rovnomerné osvetlenie a kompozíciu spredu. Hodí sa na detailné produktové zábery a makety, ktoré potrebujú jasnú prezentáciu namiesto výrazného umeleckého smerovania.

Ailoot Ultra · Obrázky POST /v1/images/generations recraft/recraft-v4.1-utility-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.1 Utility Pro je rastrový variant vetvy Utility v rámci Recraft V4.1 s vyšším rozlíšením. Výrobca odlišuje priamočiaru prezentáciu Utility od expresívnejších volieb uhla, osvetlenia a kompozície v hlavnom modeli V4.1. Utility uprednostňuje jednoduché scény, rovnomerné osvetlenie a objekty zobrazené spredu. Preto sa hodí na vizuály produktových ponúk, makety a ďalšiu prácu, pri ktorej má byť predmet ľahko čitateľný a pokojná kompozícia slúži úlohe.

Presný kód modelu je recraftv4_1_utility_pro. Referenčná dokumentácia výrobcu uvádza rastrový výstup 2K s jemnejšími detailmi vo formáte bezstratového WebP alebo PNG. Tabuľka veľkostí uvádza 2 048 × 2 048 pixelov pre štvorcové obrázky a 2 432 × 1 792 pre pomer 4:3, pričom ďalšie podporované pomery strán používajú vlastné rozmery. Tým sa Utility Pro odlišuje od výstupu 1K v štandardnom Utility. Obrázok sa tým nestáva upraviteľným vektorovým súborom; na tento účel poskytuje edícia Vector formát SVG.

Začnite zadaním, ktoré pomenuje predmet, materiál, uhol pohľadu, pozadie a niekoľko detailov, ktoré musia byť viditeľné. Pre produktovú ponuku vyžiadajte keramickú úložnú nádobu zobrazenú spredu na svetlom neutrálnom povrchu, rovnomerné osvetlenie, zatvorené viečko a voľný priestor okolo siluety. Ak má scéna zostať jednoduchá, uveďte to explicitne a nespoliehajte sa na to, že názov Utility v sebe zahŕňa všetky prezentačné rozhodnutia. Pri sérii obrázkov pre ponuky zachovajte požiadavky na záber a pozadie a meňte opis produktu.

Referenčná dokumentácia generovania V4.1 podporuje zadania s najviac 10 000 znakmi, ovládanie preferovaných farieb a farby pozadia, náhodný seed a jeden až šesť výstupov. Vzhľad môže viesť kompatibilný uložený štýl alebo voliteľné referenčné obrázky; vyhradená rodina V4 Styles je samostatný rad, pri ktorom je štýl vždy povinný. Pri voliteľných referenciách používajte jasné podklady so zhodným vizuálnym smerovaním. Presná reprodukcia farby z referencie nie je zaručená, preto požiadavka na farbu značky stále potrebuje explicitné zadanie a kontrolu výstupu. Pri generovaní podľa referenčného štýlu použite jeden až desať obrázkov PNG, JPG alebo WebP s celkovou veľkosťou najviac 64 MB a s veľkosťou každého menšou než 20 MB. Najkratšia strana každej referencie musí mať aspoň 256 pixelov, najdlhšia najviac 4 096 pixelov a rozlíšenie najviac 16 megapixelov. Použite buď tieto referencie, alebo kompatibilný uložený štýl, nie oboje. Pri generovaní podľa referenčného štýlu umožňuje flexibilné prispôsobenie voľnejšiu interpretáciu, zatiaľ čo presné prispôsobenie dôslednejšie sleduje vykreslenie, paletu, kompozíciu a osvetlenie.

Recraft tiež dokumentuje pre rad V4.1 postup image-to-image, ktorý spája existujúci obrázok so zadaním a intenzitou od 0 do 1. Nižšia intenzita zostáva bližšie k zdroju a vyššia hodnota umožňuje väčšiu zmenu. Je to užitočné, keď má východisková kompozícia alebo objekt ovplyvniť novú verziu. V tej istej transformačnej operácii neprijíma ovládacie prvky vlastného štýlu V4.1. Výrobca stanovuje pre vstupný obrázok limity menej než 20 MB, najviac 16 MP a strany od 256 do 4 096 pixelov.

Utility Pro zdieľa obmedzenia V4.1 pre ovládacie prvky negative_prompt, kurátorované názvy štýlov, text_layout, artistic_level a no_text. Dodajte kladný opis zamýšľanej scény a presné nápisy či rozloženie podľa potreby ponechajte na vhodný dokončovací krok. Pred tým, než produktový vizuál považujete za verný podklad pre ponuku, skontrolujte dodaný materiál, tvar a potrebné detaily. Užitočným výsledkom je väčšia rastrová kompozícia pripravená podľa jasného produktového zadania alebo zadania makety, pričom presné fakty o produkte zostávajú tie, ktoré boli dodané v úlohe.

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

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.1-utility-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, 4:3, 3:4, 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: 0 Maximálny počet položiek: 1	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	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.42 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.42 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.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

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.1-utility-pro

Aliasy ciest metód

/v1/images

Súvisiace ID na volanie

recraft/recraft-v4.1-utility-pro

FAQ · Recraft: Recraft V4.1 Utility Pro

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

Recraft: Recraft V4.1 Utility Pro