Recraft: Recraft V4.1 Utility Pro

Recraft V4.1 Utility Pro ustvarja rastrske slike 2K s poudarkom na preprostih, predvidljivih prizorih, enakomerni osvetlitvi in čelni kompoziciji. Primeren je za podrobne fotografije izdelkov in makete, ki potrebujejo jasno predstavitev namesto izrazite likovne usmeritve.

Ailoot Ultra · Slike POST /v1/images/generations recraft/recraft-v4.1-utility-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.1 Utility Pro je rastrska različica z višjo ločljivostjo v veji Utility družine Recraft V4.1. Proizvajalec razlikuje med preprosto predstavitvijo modela Utility in izrazitejšimi izbirami kota, osvetlitve in kompozicije pri glavnem modelu V4.1. Utility daje prednost preprostim prizorom, enakomerni osvetlitvi in čelnemu pogledu na motive. Zato je primeren za podobe izdelkov v katalogih, makete in drugo delo, pri katerem mora biti predmet jasno razviden, mirna kompozicija pa služi nalogi.

Natančna oznaka modela je recraftv4_1_utility_pro. Proizvajalčeva dokumentacija navaja rastrski izhod 2K z drobnejšimi podrobnostmi v formatu WebP brez izgub ali PNG. Tabela velikosti določa 2048 × 2048 slikovnih pik za kvadratne slike in 2432 × 1792 za 4:3, druga podprta razmerja stranic pa uporabljajo svoje dimenzije. To loči Utility Pro od izhoda 1K standardnega Utility. Slike ne spremeni v urejljivo vektorsko datoteko; za ta namen izdaja Vector zagotavlja SVG.

Začnite z opisom, ki navede predmet, material, zorni kot, ozadje in nekaj podrobnosti, ki morajo biti vidne. Za predstavitev izdelka zahtevajte čelni pogled na keramični kozarec za shranjevanje na svetli nevtralni podlagi, enakomerno osvetlitev, zaprt pokrov in prazen prostor okoli silhuete. Če mora prizor ostati preprost, to izrecno povejte, namesto da se zanašate, da ime Utility vsebuje vse odločitve o predstavitvi. Pri seriji slik izdelkov ohranite enake zahteve za kadriranje in ozadje ter spreminjajte opis izdelka.

Dokumentacija ustvarjanja za V4.1 podpira pozive do 10.000 znakov, nastavitve želenih barv in barve ozadja, naključno seme ter od enega do šest izhodov. Združljiv shranjeni slog ali izbirne referenčne slike lahko usmerjajo videz; namenska družina V4 Styles je ločena linija, v kateri je slog vedno obvezen. Pri izbirnih referencah uporabite jasna gradiva s skladno vizualno usmeritvijo. Natančna reprodukcija barv iz reference ni zagotovljena, zato zahteva za barvo blagovne znamke še vedno potrebuje izrecen opis in preverjanje izhoda. Za ustvarjanje po referenčnem slogu uporabite od ene do deset slik PNG, JPG ali WebP, skupaj največ 64 MB in vsako manjšo od 20 MB. Najkrajša stranica vsake reference mora meriti vsaj 256 slikovnih pik, najdaljša največ 4.096 slikovnih pik, ločljivost pa največ 16 milijonov slikovnih pik. Uporabite bodisi te reference bodisi združljiv shranjeni slog, ne obojega. Pri ustvarjanju po referenčnem slogu prilagodljivo ujemanje dopušča svobodnejšo interpretacijo, natančno ujemanje pa tesneje sledi upodobitvi, paleti, kompoziciji in osvetlitvi.

Recraft za linijo V4.1 dokumentira tudi pretvorbo slike v sliko, ki združuje obstoječo sliko s pozivom in močjo od 0 do 1. Nižja moč ostane bližje izvirniku, višja vrednost pa dovoljuje večjo spremembo. To je uporabno, kadar naj začetna kompozicija ali motiv vplivata na novo različico. V istem postopku preoblikovanja ne sprejema nastavitev slogov po meri za V4.1. Proizvajalčeve omejitve slikovnega vhoda so manj kot 20 MB, do 16 MP in stranici med 256 in 4096 slikovnimi pikami.

Utility Pro ima enake omejitve V4.1 glede negative_prompt, imen predpripravljenih slogov, text_layout, artistic_level in no_text. Podajte pozitiven opis predvidenega prizora ter po potrebi natančno obdelavo napisov ali postavitve prepustite ustreznemu zaključnemu koraku. Podobo izdelka preverite glede na podani material, obliko in potrebne podrobnosti, preden jo obravnavate kot zvesto kataloško gradivo. Uporaben rezultat je večja rastrska kompozicija, pripravljena za jasen opis izdelka ali makete, natančna dejstva o izdelku pa ostajajo tista, ki so podana v nalogi.

Ailoot Ultra · Slike POST /v1/images/generations recraft/recraft-v4.1-utility-pro

recraft/recraft-v4.1-utility-pro

Recraft /recraft/recraft-v4.1-utility-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.1-utility-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, 4:3, 3:4, 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: 0 Največ elementov: 1	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	Strošek
NastavitevOsnovne cene žetonov	Cenovna lestvicaOsnovna cena	Predvidena količina—	Obračunska enota—	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
Nastavitevizhodna slika	Cenovna lestvica—	Predvidena količina—	Obračunska enotana izhodno sliko	Strošek Izhod · izhodna slika · Ocena samo za primerjavo $0.42 na izhodno sliko
NastavitevOcenjeni strošek ustvarjanja	Cenovna lestvica—	Predvidena količinaocena za eno generiranje	Obračunska enota—	Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $0.42 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.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

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

Druga imena poti metod

/v1/images

Povezani ID-ji za klic

recraft/recraft-v4.1-utility-pro

FAQ · Recraft: Recraft V4.1 Utility Pro

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

Recraft: Recraft V4.1 Utility Pro