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.
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.
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.
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.
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ä.
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.
", "aboutText": "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.\n\n### Teksti osana sommittelua\n\nV3 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.\n\nAnna 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.\n\n### Tyyli, paletti ja taiteellinen suunta\n\nV3 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ä.\n\nOmia 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.\n\nToivotut 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.\n\n### Rasterikuvat ja erillinen SVG-muunnelma\n\nRecraft 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.\n\nMolemmilla 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.\n\n### Olemassa olevan kuvan muokkaus ja viimeistely\n\nRecraftin 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öä.\n\nMukana 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ä.\n\n### Kehotteen, koon ja lähdekuvan rajat\n\nValmistajan 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.\n\nKuvasyö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.\n\nMuuta 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.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "b38c9be220d6e8b28c2a1c8c8321bbab0db403f4a6dc502494b3e8a2ea65dffc", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "recraft/recraft-v3Recraft 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ä.
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.
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.
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.
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.
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ä.
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.
POST /v1/images/generationstext, imageimage| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat recraft/recraft-v3 | Oletus— |
Kenttäprompt | Tyyppistring | VaatimusPakollinen | Arvot & rajat Vähimmäispituus: 1 | Oletus— |
Kenttän | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 6 | Oletus— |
Kenttäaspect_ratio | Tyyppistring | VaatimusValinnainen | Arvot & rajat 1:1, 4:3, 3:4, 16:9, 9:16, auto | Oletus— |
Kenttäinput_references | Tyyppiarray | VaatimusValinnainen | Arvot & rajat Kohteiden vähimmäismäärä: 0 Kohteiden enimmäismäärä: 1 | Oletus— |
Tekstistä kuvaksi · Pakollinen: prompt
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, prompt |
Parametrimaterial_types | Sopimustext, image |
Parametrioptional_controls | Sopimusaspect_ratio, n, input_references |
Parametriexact_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}} |
Parametrireference_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.
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.
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 →
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.
| 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. |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'recraft/recraft-v3', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nfrom openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\n\nrequest={'model': 'recraft/recraft-v3', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "recraft/recraft-v3", "prompt": "a red panda astronaut floating in space, studio lighting"};\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\nLataa jokainen palautettu kuva tai tallenna sen Base64-sisältö
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Tallenna jokainen valmistunut kuva; nouda jokainen palautettu URL tai pura sen Base64-sisältö.
Säilytä jokainen data-alkio ja kaikki käyttötiedot; ota hallintaan ja tallenna kaikki todellisuudessa palautetut kuvat. Älä keksi osoitteita tai tunnisteita.
Jos kuvan generoinnin tai muokkauksen tulos edellyttää tarkistusta, säilytä alkuperäinen operation_id/X-Client-Request-ID ja palautetut tulostiedot. Hae olemassa olevat omistamasi tulokset mediakirjastosta käyttämällä todellisia task_id- tai asset_id-arvoja. Älä lähetä generointi- tai muokkauspyyntöä uudelleen äläkä muodosta tilakyselyn URL-osoitetta operation_id-arvosta.
| Kenttä | Tyyppi |
|---|---|
Kenttäcreated | Tyyppiinteger |
Kenttädata[].url | Tyyppistring |
Kenttädata[].b64_json | Tyyppibase64 string |
Kenttäusage | Tyyppiobject |
Ailoot Ultra recraft/recraft-v3
/v1/images