Recraft: Recraft V4.1 Utility Pro

Recraft V4.1 Utility Pro luo 2K-rasterikuvia painottaen yksinkertaisia, ennakoitavia näkymiä, tasaista valaistusta ja suoraan edestä kuvattua sommittelua. Se sopii yksityiskohtaisiin tuotekuviin ja mallikuviin, jotka tarvitsevat selkeää esitystä ilmaisuvoimaisen taiteellisen suunnan sijaan.

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

Tietoa mallista

Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.

Recraft V4.1 Utility Pro on Recraft V4.1:n Utility-haaran tarkempi rasteriversio. Valmistaja erottaa Utilityn suoraviivaisen esitystavan V4.1-päämallin ilmaisuvoimaisemmista kuvakulma-, valaistus- ja sommitteluvalinnoista. Utility suosii yksinkertaisia näkymiä, tasaista valaistusta ja suoraan edestä kuvattuja kohteita. Siksi se sopii tuotelistausten kuviin, mallikuviin ja muuhun työhön, jossa kohteen tulee olla helposti hahmotettava ja rauhallinen sommittelu palvelee tehtävää.

Täsmällinen mallikoodi on recraftv4_1_utility_pro. Valmistajan viite luettelee 2K-rasterituloksen tarkemmilla yksityiskohdilla häviöttömänä WebP- tai PNG-kuvana. Kokotaulukossa neliökuvan koko on 2048 × 2048 pikseliä ja 4:3-kuvan 2432 × 1792; muut tuetut kuvasuhteet käyttävät omia mittojaan. Tämä erottaa Utility Pron tavallisen Utilityn 1K-tuloksesta. Se ei tee kuvasta muokattavaa vektoritiedostoa; tähän tarkoitukseen Vector-versio tuottaa SVG:n.

Aloita briiffillä, joka nimeää kohteen, materiaalin, katselukulman, taustan ja muutamat näkyvissä vaadittavat yksityiskohdat. Pyydä tuotelistausta varten suoraan edestä nähty keraaminen säilytyspurkki vaalealla neutraalilla pinnalla, tasainen valaistus, suljettu kansi ja selkeää tilaa siluetin ympärille. Jos näkymän on pysyttävä suoraviivaisena, sano se erikseen sen sijaan, että luottaisit Utility-nimen sisältävän kaikki esitystavan valinnat. Pidä listaussarjan kuvien rajaus- ja taustavaatimukset samoina ja muuta tuotteen kuvausta.

V4.1-sukupolven viite tukee enintään 10 000 merkin kehotteita, halutun värin ja taustavärin säätöjä, satunnaissiementä ja yhdestä kuuteen tulosta. Yhteensopiva tallennettu tyyli tai valinnaiset viitekuvat voivat ohjata ulkoasua; erillinen V4 Styles -perhe on oma linjansa, jossa tyyli on aina pakollinen. Käytä valinnaisina viitteinä selkeitä aineistoja, joiden visuaalinen suunta on yhtenäinen. Viitteen värien täsmällistä toistoa ei taata, joten brändivärivaatimus tarvitsee silti selkeän briiffin ja tuloksen tarkistuksen. Käytä viitetyyliin perustuvassa luonnissa yhdestä kymmeneen PNG-, JPG- tai WebP-kuvaa, yhteensä enintään 64 MB ja kukin alle 20 MB. Kunkin viitteen lyhyimmän sivun on oltava vähintään 256 pikseliä, pisimmän enintään 4 096 pikseliä ja tarkkuuden enintään 16 megapikseliä. Käytä joko näitä viitteitä tai yhteensopivaa tallennettua tyyliä, älä molempia. Viitetyyliin perustuvassa luonnissa joustava vastaavuus sallii vapaamman tulkinnan, kun taas tarkka vastaavuus seuraa renderöintitapaa, väripalettia, sommittelua ja valaistusta läheisemmin.

Recraft dokumentoi myös V4.1-linjan kuvasta kuvaksi -toiminnon, joka yhdistää olemassa olevan kuvan kehotteeseen ja vahvuusarvoon väliltä 0–1. Pienempi vahvuus pysyy lähempänä lähtökuvaa, ja suurempi arvo sallii suuremman muutoksen. Tämä on hyödyllistä, kun alkuperäisen sommittelun tai kohteen tulee ohjata uutta versiota. Sama muunnostoiminto ei hyväksy V4.1:n mukautettuja tyylisäätöjä. Valmistajan kuvan syöterajat ovat alle 20 MB, enintään 16 MP ja sivut väliltä 256–4096 pikseliä.

Utility Pro jakaa V4.1:n rajoitukset negative_prompt-, kuratoitujen tyylinimien, text_layout-, artistic_level- ja no_text-säätöjen osalta. Anna myönteinen kuvaus tarkoitetusta näkymästä ja jätä tarkka tekstien tai asettelun työ tarvittaessa sopivaan viimeistelyvaiheeseen. Tarkista tuotekuvan materiaali, muoto ja tarvittavat yksityiskohdat annettua aineistoa vasten ennen kuin käsittelet sitä uskollisena listauskuvana. Hyödyllinen tulos on suurempi rasterisommitelma, joka on valmisteltu selkeään tuote- tai mallikuvabriiffiin; täsmälliset tuotefaktat pysyvät tehtävässä annettuina.

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

recraft/recraft-v4.1-utility-pro

Recraft /recraft/recraft-v4.1-utility-pro

Aloitus

Hyväksytyt syötteet: Teksti · Kuvat
Tulokset: Kuvat

Saatavilla Ailootissa · syötteet & menetelmät

Ailoot Ultra · Kuvat POST /v1/images/generations

Syötetyypit: text, image
Tulostyypit: image

Kenttä	Tyyppi	Vaatimus	Arvot & rajat	Oletus
Kenttä`model`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat recraft/recraft-v4.1-utility-pro	Oletus—
Kenttä`prompt`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat Vähimmäispituus: 1	Oletus—
Kenttä`aspect_ratio`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat 1:1, 4:3, 3:4, 16:9, 9:16, auto	Oletus—
Kenttä`n`	Tyyppi`integer`	VaatimusValinnainen	Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 6	Oletus—
Kenttä`input_references`	Tyyppi`array`	VaatimusValinnainen	Arvot & rajat Kohteiden vähimmäismäärä: 0 Kohteiden enimmäismäärä: 1	Oletus—
Kenttä`provider`	Tyyppi`object`	VaatimusValinnainen	Arvot & rajat	Oletus—

Menetelmän parametrit ja elinkaari

Parametri	Sopimus
Parametri`content_type`	Sopimusapplication/json
Parametri`required`	Sopimusmodel, prompt
Parametri`material_types`	Sopimustext, image

Elinkaari: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · todellisuudessa palautettu task_id tai mediakirjaston tietue

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Hinnoittelu

Lopullisen veloituksen laskenta

Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.

Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.

Nopea tila: Ei määritetty Kun nopea tila on valittu
Flex-tila: Ei määritetty Kun flex-tila on valittu
Päättelyn enimmäisteho: Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä

Arvioidut vertailuhinnat

Hinnat asetusten mukaan

Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.

Asetukset	Hinnasto	Ennustettu määrä	Laskutusyksikkö	Veloitus
AsetuksetTokenien perushinnat	HinnastoPerushinta	Ennustettu määrä—	Laskutusyksikkö—	Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten — / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten — / 1K tokenia
Asetuksetkuvatuloste	Hinnasto—	Ennustettu määrä—	Laskutusyksikkötuloskuvaa kohden	Veloitus Tuloste · kuvatuloste · Arvio vain vertailua varten $0.42 tuloskuvaa kohden
AsetuksetArvioitu luontikustannus	Hinnasto—	Ennustettu määräyhden generoinnin arvio	Laskutusyksikkö—	Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.42 arvio ennen generointia Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta.

Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →

Esimerkkipyynnöt

Ailoot Ultra · Kuvat

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

Vastaanota ja tallenna tulokset

Ailoot Ultra · Kuvat

Lataa jokainen palautettu kuva tai tallenna sen Base64-sisältö

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

Muut sisällön lukukerrat

Lue olemassa olevat omistamasi aineistot

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.

Säilytä kaikki valmistuneet tulokset

Tallenna jokainen valmistunut kuva; nouda jokainen palautettu URL tai pura sen Base64-sisältö.

Säilytä koko vastaus ja otsakkeet, jokainen todellinen tuloste, alkuperäiset palautetut tunnisteet ja kaikki käyttötietokentät. Selvitä alkuperäisen operaation tila lähettämättä luontipyyntöä uudelleen.

Jos alkuperäinen vastaus on tarkistettava

Säilytä palautettu X-Client-Request-ID täsmäytystä varten. Tee lukukyselyt vain todellisuudessa palautetuilla task_id/asset_id-arvoilla tai käytä omistamaasi mediakirjastoa; älä koskaan rakenna tehtävän URL-osoitetta operaation ID:n perusteella äläkä lähetä luontipyyntöä uudelleen.

Vastauksen kentät

Kenttä	Tyyppi
Kenttä`created`	Tyyppi
Kenttä`data[].url`	Tyyppi
Kenttä`data[].b64_json`	Tyyppi
Kenttä`usage`	Tyyppi

Aliakset

Mallin aliakset

Ailoot Ultra recraft/recraft-v4.1-utility-pro

Menetelmäpolkujen aliakset

/v1/images

Liittyvät kutsujan ID:t

recraft/recraft-v4.1-utility-pro

FAQ · Recraft: Recraft V4.1 Utility Pro

Mitä syötteitä ja tuloksia on saatavilla?: POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: text, image → image
Mitä kenttiä pyyntö käyttää?: POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: model, prompt, aspect_ratio, n, input_references, provider
Mitä rajoja sovelletaan?: POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4.1 Utility Pro