Recraft: Recraft V4 Styles Pro

Recraft V4 Styles Pro generuoja 2K rastrinius vaizdus etalonais apibrėžtu vizualiniu stiliumi. Jis skirtas detaliai kampanijų medžiagai ir vaizdų rinkiniams, kurių tekstūra, atvaizdavimas, paletė ir bendra išvaizda turi išlikti nuoseklūs keičiantis objektui.

Ailoot Ultra · Vaizdai POST /v1/images/generations recraft/recraft-v4-styles-pro

Apie modelį

Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.

Recraft V4 Styles Pro yra didesnės raiškos rastrinis modelis specializuotoje Recraft V4 Styles šeimoje. Jis kuria naują vaizdą iš tekstinio aprašo ir vizualinio stiliaus, pateikto etaloniniais vaizdais ar išsaugotu stiliumi. Modelis skirtas kampanijoms, prekės ženklo iliustracijoms ir kitiems vaizdų rinkiniams, kuriuose atvaizdavimas, tekstūra ir kompozicijos pobūdis turi pereiti iš vieno kūrinio į kitą. Jis skiriasi nuo Recraft V4 Pro ir V4.1 Pro, kuriems stiliaus įvestis yra pasirenkama, o ne pagrindinis modelio reikalavimas.

Styles Pro pateikia 2K rastrinę išvestį nenuostolingu WebP arba PNG formatu. Gamintojo dydžių lentelėje kvadratinis rezultatas yra 2048 × 2048 pikselių, o 16:9 – 2688 × 1536; kiti palaikomi santykiai turi savo matmenis. Didesnė Pro išvestis gali būti naudinga detaliems kampanijų vaizdams ir didesniems maketams. Vektorinės versijos pateikia SVG ir neturi fiksuoto dydžio pikseliais, todėl šios rastrinės Pro versijos nereikėtų rinktis, kai rezultatas turi būti redaguojamas vektorinis failas.

Kiekvienam Styles šeimos generavimui būtinas stilius. Pateikite nuo vieno iki dešimties PNG, JPG arba WebP etaloninių vaizdų arba pakartotinai naudokite suderinamą išsaugotą stilių; stiliaus identifikatorius ir nauji etalonai yra alternatyvios įvestys, kurių nereikia jungti. Gamintojo eiga leidžia iki 64 MB visiems etalonams, kiekvienas failas turi būti mažesnis nei 20 MB. Stiliaus kūrimui nereikia naudotojo atliekamo mokymo etapo. Vienas aiškus etalonas gali nustatyti nuoseklią kryptį, o keli etalonai padeda, kai jau dalijasi ta pačia vizualine kalba, užuot siūlę konkuruojančias išvaizdas. Trumpesnė kiekvieno etalono kraštinė turi būti bent 256 pikselių, ilgesnė – ne daugiau kaip 4 096 pikselių, o bendra raiška – ne didesnė nei 16 megapikselių.

Numatytasis lankstus stiliaus derinimas leidžia laisviau interpretuoti etaloną. Tikslus derinimas labiau atkartoja atvaizdavimą, paletę, kompoziciją ir apšvietimą. Etalonas apibrėžia vizualinę kalbą, tačiau tekstiniame apraše vis tiek reikia aprašyti naują objektą, veiksmą, sceną ir kadravimą. Detaliai produkto kampanijai nurodykite stiklinį butelį ant šviesaus akmens paviršiaus, trijų ketvirčių rakursą, minkštą šoninę šviesą ir laisvą vietą antraštei, o pateiktas etalonas perduos fotografinį apdorojimą.

Modelis priima iki 10 000 simbolių užklausas, palaiko pageidaujamas spalvas ir norimą fono spalvą bei gali naudoti atsitiktinumo sėklą. Dokumentuota generavimo eiga gali pateikti nuo vieno iki šešių vaizdų. Naudingi jo valdikliai skiriasi nuo senesnių Recraft versijų: parinktų stilių pavadinimai, negative_prompt ir text_layout nepalaikomi, o Styles šeima nesiūlo vaizdo keitimo pagal vaizdą ar inpainting. Etalonas yra stiliaus šaltinis, o ne kaukė ar instrukcija išsaugoti esamą fotografiją pikselis į pikselį.

Paruoškite aiškią, pakankamai detalią etaloninę medžiagą ir kurdami rinkinį pakartotinai naudokite tą patį stilių. Jei rezultatai kartojasi, tekstiniame apraše pakeiskite objektą, pozą, kameros kampą ar sceną, užuot pridėję nesusijusį etaloną. Tikslus etalono ir rezultato spalvų atitikimas negarantuojamas; pageidaujamų spalvų valdikliai išreiškia kryptį, o ne patvirtintą spalvų atitikimą. Galutinę kampanijos medžiagą įvertinkite numatytu ekrano ar spaudos dydžiu ir patikrinkite, ar objektas, naudinga tuščia erdvė ir vizualinis apdorojimas atitinka aprašą.

Ailoot Ultra · Vaizdai POST /v1/images/generations recraft/recraft-v4-styles-pro

recraft/recraft-v4-styles-pro

Recraft /recraft/recraft-v4-styles-pro

Pradžia

Leidžiamos įvestys: Tekstas · Vaizdai
Rezultatai: Vaizdai

Prieinama Ailoot · įvestys ir metodai

Ailoot Ultra · Vaizdai POST /v1/images/generations

Įvestis: text, image
Išvestis: image

Laukas	Tipas	Reikalavimas	Reikšmės ir ribos	Numatyta
Laukas`model`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos recraft/recraft-v4-styles-pro	Numatyta—
Laukas`prompt`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos Mažiausias ilgis: 1	Numatyta—
Laukas`aspect_ratio`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto	Numatyta—
Laukas`n`	Tipas`integer`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausia reikšmė: 1 Didžiausia reikšmė: 6	Numatyta—
Laukas`input_references`	Tipas`array`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausias elementų skaičius: 1 Didžiausias elementų skaičius: 10	Numatyta—
Laukas`provider`	Tipas`object`	ReikalavimasNeprivaloma	Reikšmės ir ribos	Numatyta—

Metodo parametrai ir gyvavimo ciklas

Parametras	Specifikacija
Parametras`content_type`	Specifikacijaapplication/json
Parametras`required`	Specifikacijamodel, prompt
Parametras`material_types`	Specifikacijatext, image

Gyvavimo ciklas: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · faktiškai grąžinta task_id reikšmė arba medijos bibliotekos įrašas

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Planai

Kaip apskaičiuojamas galutinis mokestis

Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.

Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.

Spartusis režimas: Nenurodyta Pasirinkus spartųjį režimą
Flex režimas: Nenurodyta Pasirinkus flex režimą
Didžiausios samprotavimo pastangos: Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)

Numatomi įkainiai palyginimui

Kainos pagal konfigūraciją

Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.

Konfigūracija	Įkainių lentelė	Numatomas kiekis	Apskaitos vienetas	Apmokestinimo sąlygos	Mokestis
KonfigūracijaBaziniai žetonų įkainiai	Įkainių lentelėBazinis įkainis	Numatomas kiekis—	Apskaitos vienetas—	Apmokestinimo sąlygos—	Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų
KonfigūracijaĮvesties pavyzdinė medžiaga	Įkainių lentelė—	Numatomas kiekis—	Apskaitos vienetasuž užklausą	Apmokestinimo sąlygosStiliaus kūrimas generuojant pagal stiliaus pavyzdžius; vieną kartą už užklausą, papildomai prie išvesties paveikslėlio kainos.	Mokestis Įvestis · Įvesties referencinė medžiaga · Įvertis tik palyginimui $0.01 už užklausą
Konfigūracijaišvesties vaizdas	Įkainių lentelė—	Numatomas kiekis—	Apskaitos vienetasuž išvesties vaizdą	Apmokestinimo sąlygos—	Mokestis Išvestis · išvesties vaizdas · Įvertis tik palyginimui $0.2 už išvesties vaizdą
KonfigūracijaNumatoma generavimo kaina	Įkainių lentelė—	Numatomas kiekisvieno generavimo įvertis	Apskaitos vienetas—	Apmokestinimo sąlygos—	Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $0.2 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis.

Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →

Užklausų pavyzdžiai

Ailoot Ultra · Vaizdai

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

Gauti ir išsaugoti rezultatus

Ailoot Ultra · Vaizdai

Atsisiųskite kiekvieną grąžintą vaizdą arba išsaugokite jo Base64 turinį

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Kito turinio skaitymas

Skaityti esamą jums priklausančią medžiagą

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.

Išsaugoti visus baigtus rezultatus

Išsaugokite kiekvieną baigtą vaizdą; gaukite turinį iš kiekvieno grąžinto URL arba dekoduokite jo Base64 turinį.

Išsaugokite visą atsakymą ir antraštes, visus faktiškai gautus rezultatus, pradinius grąžintus identifikatorius ir visus naudojimo apskaitos laukus. Atkurkite prieigą prie pradinės operacijos pakartotinai neteikdami kūrimo užklausos.

Jei reikia patikrinti pradinį atsakymą

Išsaugokite grąžintą X-Client-Request-ID duomenims sutikrinti. Tikrinkite tik faktiškai grąžintas task_id/asset_id reikšmes arba jums priklausančią medijos biblioteką; niekada nekurkite užduoties URL iš operacijos ID ir niekada pakartotinai neteikite kūrimo užklausos.

Atsakymo laukai

Laukas	Tipas
Laukas`created`	Tipas
Laukas`data[].url`	Tipas
Laukas`data[].b64_json`	Tipas
Laukas`usage`	Tipas

Pseudonimai

Modelių pseudonimai

Ailoot Ultra recraft/recraft-v4-styles-pro

Metodų kelių pseudonimai

/v1/images

Susiję ID iškvietimui

recraft/recraft-v4-styles-pro

FAQ · Recraft: Recraft V4 Styles Pro

Kokios įvestys ir rezultatai prieinami?: POST /v1/images/generations · recraft/recraft-v4-styles-pro: text, image → image
Kokius laukus naudoja užklausa?: POST /v1/images/generations · recraft/recraft-v4-styles-pro: model, prompt, aspect_ratio, n, input_references, provider
Kokie apribojimai taikomi?: POST /v1/images/generations · recraft/recraft-v4-styles-pro: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4 Styles Pro