Source: https://ailoot.ai/models/fi/recraft-recraft-v3/ Canonical: https://ailoot.ai/models/fi/recraft-recraft-v3/ Language: fi # Recraft: Recraft V3 [Markdown](https://ailoot.ai/models/fi/recraft-recraft-v3/index.md) · [JSON](https://ailoot.ai/models/fi/recraft-recraft-v3/facts.json) ## [Recraft: Recraft V3](https://ailoot.ai/models/fi/recraft-recraft-v3/) Recraft V3 luo valokuvia, kuvituksia ja graafisia asetteluja tekstin huomioivalla sommittelulla ja tyyliasetuksilla. Sen erilliset rasteri- ja SVG-muunnelmat sopivat julisteisiin, brändättyihin kuvasarjoihin, kuvakkeisiin ja suunnitelmiin, joissa sanamuodon ja visuaalisen rakenteen on toimittava yhdessä. - [**Ailoot Ultra · Kuvat** `POST /v1/images/generations` `recraft/recraft-v3`](https://ailoot.ai/models/fi/recraft-recraft-v3/#method-0) Tietoa mallista Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle. Recraft V3 on kuvien generointimalli, joka on rakennettu graafiseen suunnitteluun sekä valokuvamaisiin ja kuvitettuihin kohtauksiin. Kirjallinen ohje kuvaa kohteen, ympäristön ja sommittelun; tuloksena on kuva. V3 kehittää Recraftin tekstin muodostamista ja fotorealismia ja säilyttää samalla esimerkkikuvien tyylin yhtenäisyyden ilman uudelleenkoulutusta. #### Teksti osana sommittelua V3 käsittelee kuvan sisäistä tekstiä, myös pidempää sisältöä ja keskikokoista tekstausta. Recraft kuvaa asetteluvaiheen, jossa sanat ja niiden paikat määritellään ennen kuvan generointia. Asettelu voidaan tuottaa automaattisesti ohjeesta tai järjestää käsin Recraftin suunnitteluympäristössä. Tämä auttaa yhdistämään otsikon, kuvituksen ja tukitekstin samaan sommitelmaan. Valmistaja dokumentoi myös tarkat tekstiasettelukoordinaatit, jotka ilmaistaan suhteessa kuvaan kiinteän pikseliruudukon sijaan. Jokainen tekstielementti sisältää yhden sanan ja neljä kulmapistettä normalisoituina koordinaatteina: (0, 0) on vasen yläkulma ja (1, 1) oikea alakulma. Koordinaatit voivat ulottua tämän välin ulkopuolelle, jolloin muoto rajautuu. Täsmällisen tekstiasettelun sanojen on noudatettava dokumentoituja merkkirajoituksia. Anna julisteeseen tai kanteen tarkka sanamuoto ja kuvaile hierarkia: mikä rivi johtaa, missä se sijaitsee ja miten kuva tukee sitä. Tarkista muodostettu oikeinkirjoitus ja välitys tulosta valitessasi. #### Tyyli, paletti ja taiteellinen suunta V3 sisältää kuratoituja valokuva-, kuvitus- ja tunnustyylejä sekä erillisen vektorityylikirjaston. Recraft V3 Raw on rasterimallin oletustyyli; Vector art on vektorimuunnelman oletus. Photorealism tavoittelee valokuvamaista ulkonäköä, kun taas Illustration soveltuu tyyliteltyihin tekstuureihin, varjostuksiin ja monimutkaisempiin värisiirtymiin. Vektorityylit suosivat muotoja, rajattuja paletteja ja tasaisia täyttöjä tai yksinkertaisia liukuvärejä. Omia tyylejä voi rakentaa viitekuvista, olemassa olevista yhteensopivista tyyleistä tai niiden yhdistelmästä. Ne antavat uudelleenkäytettävän visuaalisen suunnan kuvasarjaan. Dokumentoidut yhdistelyasetukset antavat viitteille ja lähdetyyleille erilliset painot; painojen lukumäärä vastaa lähteitä. PaletteMatch ja MaxWeight ovat kaksi lueteltua yhdistelykäytäntöä. Valmistaja sallii enintään 10 tyyliviitekuvaa ja käyttää V3:lle tavallista tyylivastaavuustilaa. Tallennettu oma tyyli ja suorat tyyliviitteet ovat vaihtoehtoisia syötteitä, ja oman tyylin on vastattava generointiin käytettyä mallia. Toivotut värit ja taustaväri ohjaavat palettia. Dokumentoituna on enintään 10 RGB-väriä, kunkin komponentin arvona 0–255. Valinnaiset suhteelliset painot ovat 0–1; ne on annettava joko jokaiselle värille tai ei yhdellekään, eikä niiden summa saa ylittää 1:tä. Taiteellisuuden taso vaihtelee staattisen siistin käsittelyn arvosta 0 dynaamisempien ja erikoisempien sommitelmien arvoon 5. Negatiivinen kehote kuvaa ei-toivotut elementit; erillinen no-text-asetus poistaa upotetut tekstiasettelut käytöstä. Satunnaissiemen on tarjolla toistettavuutta varten. Asetukset antavat eri säätökeinoja kohtaukseen, sen tyyliin ja visuaaliseen asetteluun. #### Rasterikuvat ja erillinen SVG-muunnelma Recraft dokumentoi kaksi V3-muunnelmaa. Rasterimalli tuottaa häviötöntä WebP:tä tai PNG:tä ja sopii valokuvayksityiskohtiin, varjostuksiin ja tekstuuriseen kuvitukseen. Recraft V3 Vector tuottaa SVG:tä: polkuja ja muotoja, jotka voivat skaalautua ilman kiinteää pikselitarkkuutta. Se sopii piktogrammeihin, logokonsepteihin, merkkeihin ja yksityiskohtaiseen vektoritaiteeseen. Rasterin muuttaminen vektoriksi on erillinen operaatio suoraan generoidusta vektoritaiteesta. Molemmilla muunnelmilla on oma identiteettinsä. Vektorimaiselta näyttävä kuva ja varsinainen SVG-tulos ovat eri valintoja. Valitse haluttu tulos suunnittelutyönkulkua valmistellessasi äläkä käsittele yhteistä V3-nimeä todisteena siitä, että jokainen operaatio palauttaa saman tiedostotyypin. #### Olemassa olevan kuvan muokkaus ja viimeistely Recraftin V3-dokumentaatio luettelee kuvasta kuvaksi -generoinnin, inpainting- ja outpainting-muokkauksen sekä taustan korvaamisen tai generoinnin. Kuvasta kuvaksi -työ yhdistää olemassa olevan kuvan uuteen ohjeeseen. Inpainting generoi valitun alueen uudelleen kuvan ja vastaavan maskin avulla; outpainting lisää sisältöä alkuperäisen ruudun ulkopuolelle. Taustaoperaatiot käsittelevät kohteen ympäristöä. Mukana oleva työkalujoukko sisältää myös pyyhkimisen, taustan poistamisen, vektoroinnin ja kaksi suurennusmenetelmää. Luova suurennus voi lisätä uusia yksityiskohtia; crisp-suurennus tavoittelee olemassa olevan sisällön terävämpää suurempaa esitystä. Nämä ovat erillisiä operaatioita omine syötteineen ja tuloksineen, eivät rasteri- tai vektorimallin nimen lisämerkityksiä. #### Kehotteen, koon ja lähdekuvan rajat Valmistajan V3-generointimääritys hyväksyy enintään 1000 merkin kehotteen ja 1–6 kuvaa pyyntöä kohti. Se tukee 14 kuvasuhdetta: 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9 ja 9:16. Dokumentoituja rasteriesimerkkejä ovat 1024x1024, 1820x1024 ja 1024x1820. Tarkkojen rasterimittojen on oltava tuetusta luettelosta; SVG käyttää kuvasuhteita ilman kiinteää pikselikokoa. Kun koko jätetään pois, valmistajan järjestelmä valitsee sen kehotteesta. Kuvasyöteoperaatioille valmistaja luettelee PNG:n, JPG:n ja WebP:n sekä SVG:n silloin, kun kyseinen operaatio sallii sen. Tiedostojen on oltava alle 20 MB, enintään 16 MP ja pidemmän sivun enintään 4096 pikseliä. Lyhyemmän sivun on oltava vähintään 256 pikseliä, crisp-suurennuksen 32 pikselin poikkeuksella. Maskit vastaavat kuvan kokoa ja käyttävät puhdasta mustaa ja valkoista; tyyliviitteiden yhteisraja on 64 MB. Muuta Ailoot API -projektin tehtävä rajatuksi kuvaohjeeksi: tarkka teksti, esinejärjestely, visuaalinen tyyli ja haluttu sommittelu. Juliste, tuotenäkymä ja kuvakesarja vaativat eri ohjeet; säilytä olennaiset V3-muunnelman ja operaatioiden erot päättäessäsi jokaisen tuloksen käyttötavasta. **Ailoot Ultra · Kuvat** `POST /v1/images/generations` `recraft/recraft-v3` [`recraft/recraft-v3`](https://ailoot.ai/models/fi/#m=recraft%2Frecraft-v3&route=Ultra&caller=recraft%2Frecraft-v3&fmt=images) Recraft /`recraft/recraft-v3` ### Aloitus Recraft V3 luo valokuvia, kuvituksia ja graafisia asetteluja tekstin huomioivalla sommittelulla ja tyyliasetuksilla. Sen erilliset rasteri- ja SVG-muunnelmat sopivat julisteisiin, brändättyihin kuvasarjoihin, kuvakkeisiin ja suunnitelmiin, joissa sanamuodon ja visuaalisen rakenteen on toimittava yhdessä. 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` Tulosteen muoto Kuvatiedosto | Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus | | --- | --- | --- | --- | --- | | Kenttä`model` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat recraft/recraft-v3 | Oletus— | | Kenttä`prompt` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat Vähimmäispituus: 1 | Oletus— | | Kenttä`n` | Tyyppi`integer` | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 6 | Oletus— | | Kenttä`aspect_ratio` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat 1:1, 4:3, 3:4, 16:9, 9:16, auto | Oletus— | | Kenttä`input_references` | Tyyppi`array` | VaatimusValinnainen | Arvot & rajat Kohteiden vähimmäismäärä: 0 Kohteiden enimmäismäärä: 1 | Oletus— | Syöteaineistojen yhdistelmät **Tekstistä kuvaksi** · Pakollinen: prompt Menetelmän parametrit ja elinkaari | Parametri | Sopimus | | --- | --- | | Parametri`content_type` | Sopimusapplication/json | | Parametri`required` | Sopimusmodel, prompt | | Parametri`material_types` | Sopimustext, image | | Parametri`optional_controls` | Sopimusaspect\_ratio, n, input\_references | | Parametri`exact_supported_parameters` | Sopimus{"aspect\_ratio":{"type":"enum","values":\["1:1","4:3","3:4","16:9","9:16","auto"\]},"n":{"type":"range","min":1,"max":6},"input\_references":{"type":"range","min":0,"max":1}} | | Parametri`reference_material_rule` | SopimusVain asiakkaan todelliset kuvaviitteet; niitä koskevat palveluntarjoajan rajapintapisteen ehdot. | Menetelmien aliakset: `/v1/images` 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}` Käytä täsmällistä mallia ja dokumentoituja syötekenttiä. Säilytä koko vastaus, jokainen todellinen tulos ja alkuperäiset palautetut tunnisteet. ### 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 | | AsetuksetUltra | Hinnasto— | Ennustettu määrä— | Laskutusyksikkötuloskuvaa kohden | Veloitus Tuloste · kuvatuloste · Arvio vain vertailua varten **$0.08** tuloskuvaa kohden | | AsetuksetArvioitu luontikustannus | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Laskutusyksikkö— | Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten **$0.08** 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/) #### Viitehinnaston tiedot Mallitason viitehinnastot eivät muuta menetelmän valintaa, hinta-arvioita tai veloituksia. Käytössä olevat veloitukset käyttävät valitun Ailoot-menetelmän hintoja. Kuvahinnoittelun kokoonpanot #### Hinnat asetusten mukaan | Asetukset | Laskutusehdot | Veloitus | | --- | --- | --- | | AsetuksetTuloskuva | LaskutusehdotHinnoitteluvaihtoehtoa ei ole määritelty. | Veloitus Tuloste · Kuvatuloste **$0.08** kuvaa kohden Vastaavat luettelomerkinnät kuvaavat samaa veloitusta; ne eivät lisää toista maksua. | ### Esimerkkipyynnöt #### Ailoot Ultra · Kuvat curlPython SDKNode.js SDK ```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-v3', '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"