Recraft: Recraft V4 Styles Pro

Recraft V4 Styles Pro ustvarja rastrske slike 2K v vizualnem slogu, določenem z referencami. Namenjen je podrobnim gradivom za kampanje in slikovnim zbirkam, pri katerih morajo tekstura, upodobitev, paleta in celoten videz ostati skladni tudi ob spreminjanju motiva.

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

O modelu

Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.

Recraft V4 Styles Pro je rastrski model z višjo ločljivostjo v Recraftovi namenski družini V4 Styles. Novo sliko ustvari iz besedilnega opisa in vizualnega sloga, podanega z referenčnimi slikami ali shranjenim slogom. Namenjen je kampanjam, ilustracijam za blagovne znamke in drugim slikovnim zbirkam, pri katerih je treba upodobitev, teksturo in značaj kompozicije prenesti z enega gradiva na drugo. Ločen je od modelov Recraft V4 Pro in V4.1 Pro, pri katerih je slogovni vhod izbiren in ne temeljna zahteva modela.

Styles Pro ustvarja rastrski izhod 2K v formatih WebP brez izgub ali PNG. Kvadratni izhod v proizvajalčevi tabeli velikosti meri 2048 × 2048 slikovnih pik, izhod 16:9 pa 2688 × 1536; druga podprta razmerja imajo svoje dimenzije. Večji izhod izdaje Pro je lahko uporaben za podrobne podobe kampanj in večje postavitve. Vektorske različice nasprotno ustvarjajo SVG in nimajo fiksne velikosti v slikovnih pikah, zato te rastrske izdaje Pro ne izberite, če potrebujete vektorsko datoteko, ki jo je mogoče urejati.

Vsako ustvarjanje v družini Styles zahteva slog. Pošljite od ene do deset referenčnih slik PNG, JPG ali WebP ali znova uporabite združljiv shranjeni slog; identifikator sloga in nove reference so alternativni vhodi in jih ne združujte. Proizvajalčev postopek dovoljuje reference v skupni velikosti do 64 MB, pri čemer mora biti vsaka datoteka manjša od 20 MB. Ustvarjanje sloga ne zahteva koraka učenja, ki bi ga izvajal uporabnik. Ena jasna referenca lahko vzpostavi skladno usmeritev, več referenc pa pomaga, kadar že delijo isti vizualni jezik in ne tekmujejo z različnimi videzi. Najkrajša stranica vsake reference mora meriti vsaj 256 slikovnih pik, najdaljša največ 4.096 slikovnih pik, skupna ločljivost pa največ 16 milijonov slikovnih pik.

Prilagodljivo slogovno ujemanje je privzeto in dopušča svobodnejšo interpretacijo reference. Natančno ujemanje tesneje sledi upodobitvi, paleti, kompoziciji in osvetlitvi. Referenca določa vizualni jezik; besedilni opis mora še vedno opredeliti novi motiv, dejanje, prizor in kadriranje. Za podrobno kampanjo izdelka določite steklenico na svetli kamniti podlagi, pogled pod kotom treh četrtin, mehko stransko osvetlitev in prazen prostor za naslov, priložena referenca pa naj določa fotografsko obdelavo.

Model sprejema pozive do 10.000 znakov, podpira želene barve in želeno barvo ozadja ter lahko uporabi naključno seme. Dokumentirani postopek ustvarjanja lahko vrne od ene do šest slik. Uporabne nastavitve se razlikujejo od starejših izdaj Recraft: imena predpripravljenih slogov, negative_prompt in text_layout niso podprti, družina Styles pa ne omogoča pretvorbe slike v sliko ali zapolnjevanja izbranih delov slike. Referenca je vir sloga, ne maska ali navodilo, naj se obstoječa fotografija ohrani slikovno piko za slikovno piko.

Pripravite jasne referenčne podobe z dovolj podrobnostmi in pri razvijanju zbirke znova uporabljajte isti slog. Če rezultati postanejo ponavljajoči, v besedilnem opisu spremenite motiv, pozo, kot kamere ali prizor, namesto da dodate nepovezano referenco. Natančno barvno ujemanje med referenco in izhodom ni zagotovljeno; nastavitve želenih barv izražajo usmeritev, ne rezultata barvnega preverjanja. Končno gradivo kampanje ocenite pri predvideni prikazni ali tiskani velikosti ter preverite, ali motiv, uporaben prazen prostor in vizualna obdelava ustrezajo opisu.

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

recraft/recraft-v4-styles-pro

Recraft /recraft/recraft-v4-styles-pro

Začetek

Dovoljeni vhodi: Besedilo · Slike
Rezultati: Slike

Na voljo v Ailoot · vhodi in metode

Ailoot Ultra · Slike POST /v1/images/generations

Vhod: text, image
Izhod: image

Polje	Vrsta	Zahteva	Vrednosti in omejitve	Privzeto
Polje`model`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve recraft/recraft-v4-styles-pro	Privzeto—
Polje`prompt`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve Najmanjša dolžina: 1	Privzeto—
Polje`aspect_ratio`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto	Privzeto—
Polje`n`	Vrsta`integer`	ZahtevaIzbirno	Vrednosti in omejitve Najmanj: 1 Največ: 6	Privzeto—
Polje`input_references`	Vrsta`array`	ZahtevaIzbirno	Vrednosti in omejitve Najmanjše število elementov: 1 Največ elementov: 10	Privzeto—
Polje`provider`	Vrsta`object`	ZahtevaIzbirno	Vrednosti in omejitve	Privzeto—

Parametri in življenjski cikel metode

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

Življenjski cikel: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Dejansko vrnjeni task_id ali zapis v medijski knjižnici

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cenik

Kako se izračuna končni strošek

Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.

Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.

Hitri način: Ni navedeno Ko je izbran hitri način
Način flex: Ni navedeno Ko je izbran način flex
Najvišja raven razmišljanja: Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)

Ocenjene cene za primerjavo

Cene po nastavitvah

Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.

Nastavitev	Cenovna lestvica	Predvidena količina	Obračunska enota	Obračunski pogoji	Strošek
NastavitevOsnovne cene žetonov	Cenovna lestvicaOsnovna cena	Predvidena količina—	Obračunska enota—	Obračunski pogoji—	Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov
NastavitevVhodna referenca	Cenovna lestvica—	Predvidena količina—	Obračunska enotana zahtevo	Obračunski pogojiUstvarjanje sloga pri ustvarjanju s slogovnimi referencami; enkrat na zahtevo poleg cene izhodne slike.	Strošek Vhod · Vhodna referenca · Ocena samo za primerjavo $0.01 na zahtevo
Nastavitevizhodna slika	Cenovna lestvica—	Predvidena količina—	Obračunska enotana izhodno sliko	Obračunski pogoji—	Strošek Izhod · izhodna slika · Ocena samo za primerjavo $0.2 na izhodno sliko
NastavitevOcenjeni strošek ustvarjanja	Cenovna lestvica—	Predvidena količinaocena za eno generiranje	Obračunska enota—	Obračunski pogoji—	Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $0.2 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje.

Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →

Primeri zahtev

Ailoot Ultra · Slike

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

Prejmi in shrani rezultate

Ailoot Ultra · Slike

Prenesite vsako vrnjeno sliko ali shranite njeno vsebino Base64

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

Branje druge vsebine

Preberi obstoječa gradiva, ki vam pripadajo

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.

Ohrani vse dokončane rezultate

Shranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.

Shranite celoten odgovor in glave, vse dejanske izhode, izvirne vrnjene identifikatorje in vsa polja s podatki o porabi. Pridobite podatke izvirne operacije brez ponovnega pošiljanja zahteve za ustvarjanje.

Če je treba preveriti izvirni odgovor

Shranite vrnjeni X-Client-Request-ID za uskladitev evidenc. Berite samo dejansko vrnjene vrednosti task_id/asset_id ali svojo medijsko knjižnico; iz ID operacije nikoli ne sestavite URL opravila in zahteve za ustvarjanje nikoli ne pošljite znova.

Polja odgovora

Polje	Vrsta
Polje`created`	Vrsta
Polje`data[].url`	Vrsta
Polje`data[].b64_json`	Vrsta
Polje`usage`	Vrsta

Druga imena

Druga imena modelov

Ailoot Ultra recraft/recraft-v4-styles-pro

Druga imena poti metod

/v1/images

Povezani ID-ji za klic

recraft/recraft-v4-styles-pro

FAQ · Recraft: Recraft V4 Styles Pro

Kateri vhodi in rezultati so na voljo?: POST /v1/images/generations · recraft/recraft-v4-styles-pro: text, image → image
Katera polja uporablja zahteva?: POST /v1/images/generations · recraft/recraft-v4-styles-pro: model, prompt, aspect_ratio, n, input_references, provider
Katere omejitve veljajo?: POST /v1/images/generations · recraft/recraft-v4-styles-pro: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4 Styles Pro