Recraft: Recraft V4 Styles

Recraft V4 Styles ustvarja rastrske slike 1K v vizualnem slogu, določenem z referencami. Namenjen je vsakodnevnemu delu za blagovne znamke in kampanje, pri katerem mora vsak novi motiv ohraniti enako upodobitev, teksturo in celoten videz.

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

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 je standardna rastrska izdaja Recraftove namenske družine za ustvarjanje slogovno skladnih slik. Iz besedilnega poziva ustvari novo sliko in pri tem sledi slogu, vzpostavljenemu z referenčnimi gradivi. Uporaben je za serije ilustracij, pasic ali prizorov z izdelki, ki naj imajo prepoznavno skupno vizualno obdelavo. Referenca prenaša upodobitev, teksturo in barvno logiko, poziv pa za vsako novo gradivo uvede motiv in prizor.

Proizvajalec navaja rastrski izhod 1K v formatu WebP brez izgub ali PNG. Kvadratna velikost je 1024 × 1024 slikovnih pik, dokumentirana velikost 16:9 pa 1344 × 768; pokončna in druga podprta razmerja imajo svoje velikosti. Ta izdaja se razlikuje od rastrskega izhoda 2K modela Styles Pro in od modelov Vector, ki ustvarjajo SVG. Razmerje stranic izberite za končno postavitev, namesto da predpostavljate, da oznaka 1K pomeni enako širino in višino vsake slike.

Slog je obvezen. Uporabite od ene do deset referenc PNG, JPG ali WebP ali združljiv slog, shranjen pri prejšnjem ustvarjanju sloga. Dokumentirani postopek ne sprejema hkrati identifikatorja shranjenega sloga in novih referenc. Reference so lahko obstoječa gradiva blagovne znamke ali kampanje, ne nujno slike, ki jih je ustvaril Recraft. Vsaka datoteka mora biti manjša od 20 MB, vse skupaj pa velike največ 64 MB. Pred uporabo sloga ni ločene naloge učenja, ki bi jo izvajal uporabnik. 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.

Začnite z eno močno referenco ali več referencami, ki se že ujemajo v vizualnem jeziku. Skladne reference pomagajo slog prenesti tudi na druge predmete ali poze; nepovezana zbirka navdihov lahko uvede nasprotujoče si motive. Prilagodljivo ujemanje je privzeto in pušča več prostora za interpretacijo; natančno ujemanje tesneje sledi upodobitvi, paleti, kompoziciji in osvetlitvi reference. Natančna reprodukcija barv še vedno ni zagotovljena.

Za serijo pasic opišite dostavljavca, ki polaga paket pred vrata, mirno vodoravno kompozicijo in prazen prostor na eni strani za poznejše besedilo. Naslednji opisi lahko spremenijo dogodek ali kot kamere in ohranijo isti slog. Proizvajalec dovoljuje pozive do 10.000 znakov, želene barve, želeno barvo ozadja, naključno seme ter od ene do šest slik. Ne podpira negative_prompt, imen predpripravljenih slogov ali text_layout, zato želeni motiv in postavitev opišite neposredno.

Linija Styles ne ponuja pretvorbe slike v sliko ali zapolnjevanja izbranih delov slike. Slogovna referenca usmerja novo ustvarjeno sliko in ne jamči ohranitve predmetov ali slikovnih pik iz reference. Če je zbirka videti ponavljajoča, spremenite pozo, dejanje, kadriranje ali podrobnosti prizora, namesto da dodate nezdružljivo referenco. Vsak rezultat ocenite v predvideni postavitvi glede jasnosti motiva, uporabnega prostora in skladne upodobitve, nato pa za naslednje gradivo ohranite isti združljivi slog. Tako je model praktičen za ponovljiv vizualni jezik s spreminjajočo se vsebino.

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

recraft/recraft-v4-styles

Recraft /recraft/recraft-v4-styles

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	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.07 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.07 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', '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

Druga imena poti metod

/v1/images

Povezani ID-ji za klic

recraft/recraft-v4-styles

FAQ · Recraft: Recraft V4 Styles

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

Recraft: Recraft V4 Styles