Source: https://ailoot.ai/models/fi/recraft-recraft-v4-1-utility/
Canonical: https://ailoot.ai/models/fi/recraft-recraft-v4-1-utility/
Language: fi

# Recraft: Recraft V4.1 Utility

[Markdown](https://ailoot.ai/models/fi/recraft-recraft-v4-1-utility/index.md) · [JSON](https://ailoot.ai/models/fi/recraft-recraft-v4-1-utility/facts.json)

## [Recraft: Recraft V4.1 Utility](https://ailoot.ai/models/fi/recraft-recraft-v4-1-utility/)

Recraft V4.1 Utility generoi 1K-rasterikuvia selkeisiin tuoteotoksiin, mallikuviin ja yksinkertaisiin kohtauksiin. Se suosii tasaista valaistusta ja suoraan edestä kuvattua sommittelua sekä tekstikehotteita ja valinnaisia kuva- tai tyylisyötteitä ennakoitavan visuaalisen suunnan luomiseksi.

- [**Ailoot Ultra · Kuvat** `POST /v1/images/generations` `recraft/recraft-v4.1-utility`](https://ailoot.ai/models/fi/recraft-recraft-v4-1-utility/#method-0)

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 on Recraftin V4.1-perheen tavallinen rasterimuotoinen Utility-malli. Se suosii yksinkertaisia kohtauksia, tasaista valaistusta ja edestä kuvattua sommittelua päämallin V4.1:n ilmeikkäämpien kulma-, valo- ja tunnelmavalintojen sijaan. Sen käytännön tehtävä on selkeä tuoteotos tai mallikuva, jossa esineen ja tarpeellisten yksityiskohtien tulee hallita. Nimenomainen Utility-versio on erillinen Utility Prosta, V4.1-päämallista ja SVG:tä tuottavista vektorimuunnelmista.

Valmistajan mallikoodi on recraftv4\_1\_utility. Se palauttaa 1K-rasterikuvia häviöttömänä WebP:nä tai PNG:nä, ja koot valitaan tuetuista kuvasuhteista. Neliökuva on 1024 × 1024 pikseliä ja 4:3-kuva 1216 × 896. Pro Utility -versio käyttää suurempia 2K-mittoja, joten näitä tuloskokoja ei tule osoittaa tavalliselle Utilitylle. Valitse halutun tuotelistauksen tai mallikuvan muoto ennen kohtauksen kuvailemista.

Hyödyllinen ohje nimeää tuotteen, näkökulman, materiaalin, pinnan, taustan ja valaistuksen selvästi. Pyydä tuotelistausta varten suoraan edestä kuvattu lämpöeristetty juomapullo vaalealla taustalla, tasaisesti valaistuna, koko siluetti näkyvissä ja ilman häiritseviä kohtauselementtejä. Jos tuotteella on todelliset mitat tai erottuvia osia, anna ne selvästi. Utilityn taipumus selkeään esitykseen ei vahvista ohjeesta puuttuvia faktoja oikeasta tuotteesta.

Generointi tukee enintään 10 000 merkin kehotteita, toivottujen värien ja taustavärin asetuksia, satunnaissiementä ja yhdestä kuuteen tulosta. Valinnaiset yhteensopivat omat tyylit tai viitekuvat voivat ohjata katalogin visuaalista kieltä. Käytä valaistukseltaan ja esitystavaltaan yhtenäistä viiteaineistoa ja säilytä sama yhteensopiva tyyli myöhemmissä tuoteohjeissa. Tarkkaa viitteen ja tuloksen värivastaavuutta ei taata, joten vertaa lopullista kuvaa tarvittavaan palettiin. Käytä viitetyyligenerointiin yhdestä kymmeneen PNG-, JPG- tai WebP-kuvaa, yhteensä enintään 64 MB ja kukin alle 20 MB. Jokaisen viitteen lyhyemmän sivun on oltava vähintään 256 pikseliä, pidemmän enintään 4 096 pikseliä ja tarkkuuden enintään 16 megapikseliä. Käytä joko näitä viitteitä tai yhteensopivaa tallennettua tyyliä, älä molempia. Viitetyyligeneroinnissa joustava vastaavuus sallii vapaamman tulkinnan, kun taas tarkka vastaavuus seuraa esitystapaa, palettia, sommittelua ja valaistusta lähempää.

Erillinen kuvasta kuvaksi -työnkulku käyttää olemassa olevaa kuvaa ja kehotetta; voimakkuus 0–1 ohjaa muutoksen laajuutta. Pienempi voimakkuus pitää tuloksen lähempänä lähdettä, suurempi antaa sen etääntyä enemmän. Syöte voi olla PNG, JPG, WebP tai SVG, alle 20 MB, enintään 16 MP ja sivupituuksiltaan 256–4096 pikseliä. V4.1:n omia tyylejä ei hyväksytä tähän muunnosoperaatioon, joka on eri asia kuin tyyliviitteen liittäminen uuteen generointiin.

V4.1 Utility ei hyväksy kuratoituja tyylinimiä eikä negative\_prompt-, text\_layout-, artistic\_level- tai no\_text-asetuksia. Anna haluttu valmis kohtaus suoraan myönteisessä kehotteessa. Pidä tuotekuvasarjan rajaus- ja taustaohjeet samoina ja vertaa sitten jokaista kuvaa annettuun tuotemuotoon, materiaaliin ja yksityiskohtiin ennen käyttöä asettelussa. Tavallinen Utility on kohdennettu rasterityökalu hillittyyn esitykseen; valitse tehtävään sopiva tulosmuoto ja versio.

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

[`recraft/recraft-v4.1-utility`](https://ailoot.ai/models/fi/#m=recraft%2Frecraft-v4.1-utility&route=Ultra&caller=recraft%2Frecraft-v4.1-utility&fmt=images)

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

### Aloitus

Recraft V4.1 Utility generoi 1K-rasterikuvia selkeisiin tuoteotoksiin, mallikuviin ja yksinkertaisiin kohtauksiin. Se suosii tasaista valaistusta ja suoraan edestä kuvattua sommittelua sekä tekstikehotteita ja valinnaisia kuva- tai tyylisyötteitä ennakoitavan visuaalisen suunnan luomiseksi.

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 | 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.07** tuloskuvaa kohden |
| AsetuksetArvioitu luontikustannus | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Laskutusyksikkö— | Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten **$0.07** 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 →](https://ailoot.ai/docs/fi/billing/reserve/)

### Esimerkkipyynnöt

#### Ailoot Ultra · Kuvat

curl

```bash
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', '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

```bash
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`](https://ailoot.ai/models/fi/#m=recraft%2Frecraft-v4.1-utility&route=Ultra&caller=recraft%2Frecraft-v4.1-utility&fmt=images)

#### Menetelmäpolkujen aliakset

`/v1/images`

#### Liittyvät kutsujan ID:t

[`recraft/recraft-v4.1-utility`](https://ailoot.ai/models/fi/#m=recraft%2Frecraft-v4.1-utility&route=Ultra&caller=recraft%2Frecraft-v4.1-utility&fmt=images)

FAQ · Recraft: Recraft V4.1 Utility

Mitä syötteitä ja tuloksia on saatavilla?

`POST /v1/images/generations` · `recraft/recraft-v4.1-utility`: `text`, `image` → `image`

Mitä kenttiä pyyntö käyttää?

`POST /v1/images/generations` · `recraft/recraft-v4.1-utility`: `model`, `prompt`, `aspect_ratio`, `n`, `input_references`, `provider`

Mitä rajoja sovelletaan?

`POST /v1/images/generations` · `recraft/recraft-v4.1-utility`: `n.minimum`: `1`; `n.maximum`: `6`

Yhdistä Ailoot Claude Codeen, OpenCodeen, Hermesiin tai omaan sovellukseesi.

## Yritys ja sen projektisalkku

Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.

## Osta tokenit alennuksella.

Tilausalennus säännölliseen käyttöön. Kampanjakoodit — jopa 50% tokeniostoista.

Tilaus

Valitse alennushintainen paketti säännöllisiä pyyntöjäsi varten.

Kampanjakoodi jopa 50%

Syötä koodi oston yhteydessä. Hinta lasketaan uudelleen voimassa olevan kampanjan mukaan.

Kulut historiassa

Malli, tokenit ja summa tallennetaan jokaiselle pyynnölle.

[Valitse tilaus](https://ailoot.ai/docs/fi/billing/subscriptions/) · [Katso mallihinnat](https://ailoot.ai/models/fi/)

## Yhdistä API tuotteeseen, jonka myyt.

SaaS, sovellukset ja botit Ailootin palveluehtojen ja lisenssisopimuksen mukaisesti. Pyydä edelleenmyyntiin jälleenmyyjälisenssi.

Kaupallinen sovellus

Lisää tekstin, kuvien, videoiden ja äänen luonti palvelusi maksullisiin ominaisuuksiin.

Jälleenmyyjälisenssi

Lähetä projektikuvaus ja pääsyn toteutustapa. Pyydä kirjalliset käyttö- ja jälleenmyyntiehdot.

Asiakirjat verkkosivustolla

Palveluehdot, lisenssisopimus ja tietojenkäsittelykäytäntö ovat saatavilla ennen yhdistämistä.

[Pyydä jälleenmyyjälisenssi](mailto:support@ailoot.ai) · [Palveluehdot ja lisenssisopimus](https://ailoot.ai/legal/offer?lang=fi)

## Ailoot · Yritys ja sen projektisalkku





Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan.





Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.





Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.
