Recraft V4 Pro on Recraftin V4-perheen korkeamman tarkkuuden rasterimalli. V4 keskittyy visuaaliseen harkintaan, tasapainoiseen sommitteluun, yhtenäisiin väreihin ja luovan ohjeen huolelliseen tulkintaan. Valmistaja asemoi Pron hienompiin yksityiskohtiin, realistisempiin monimutkaisiin kohtauksiin ja laajoihin tuotantokuviin. Käytä sitä yksityiskohtaiseen kuvitukseen, toimitukselliseen kuvaan, julistekonseptiin tai muuhun suuremmasta rasterituloksesta hyötyvään aineistoon. Se pysyy erillään myöhemmästä V4.1-mallista ja V4 Pro Vectorin SVG-tuloksesta.
Valmistajan nimenomainen koodi on recraftv4_pro. Dokumentoitu tulos on 2K-rasteri häviöttömänä WebP:nä tai PNG:nä: neliö 2048 × 2048 pikseliä, 16:9 2688 × 1536 ja 2:3 1664 × 2560. Muilla tuetuilla suhteilla on omat mittansa. Valitse halutun asettelun kuvasuhde tai tarkka sallittu koko; mielivaltainen pikselikoko ei kuulu dokumentoituun generointisopimukseen. Tavallisella V4:llä on pienempi 1K-rasteritulos, kun taas vektorimalleilla ei ole kiinteää pikselitarkkuutta.
V4 voi tulkita lyhyen kehotteen ideointiin tai rakenteisen kehotteen hallittuun tulokseen. Tiettyä taiteellista suuntaa varten valmistajan opas etenee kohteesta ja ympäristöstä rajaukseen, ominaisuuksiin, tilallisiin suhteisiin, valaistukseen, syvyyteen ja tunnelmaan. Pyydä toimitukselliseen tuotekuvaan dramaattinen pystyvalokuva veistoksellisesta tuolista, harjatut metallipinnat, sivuvalo, rauhallinen tumma tausta ja tilaa esineen yläpuolelle otsikolle. Näiden suhteiden nimeäminen selventää haluttua sommittelua enemmän kuin yleinen laadukkaan kuvan pyyntö.
Perheen luova alue sisältää kerronnallisen kuvituksen, fotorealistiset kohtaukset ja tilalliset kuvat materiaali- ja valaistusvihjeillä. 3D:n näköinen tulos on silti kuva, ei muokattava 3D-kohtaus. Määrittele graafiseen julisteeseen visuaaliset kerrokset ja niiden vuorovaikutus: tausta, kuvitus tai valokuva, otsikkohierarkia ja tukiteksti. V4 asemoidaan luettaviin lyhyisiin ja keskipitkiin ilmauksiin, mutta lopullinen oikeinkirjoitus ja hierarkia tulee tarkastaa eikä päätellä mallinimestä.
Nykyinen generointiviite sallii enintään 10 000 merkin kehotteet, yhdestä kuuteen tulosta, satunnaissiemenen sekä toivottujen värien ja taustavärin asetukset. Valinnaiset omat tyylit tai yhteensopivat viitekuvat voivat ohjata ulkonäköä joustavalla tai tarkalla vastaavuudella. Malli ei hyväksy vanhempia V3-asetuksia negative_prompt, kuratoituja tyylejä, text_layout, artistic_level tai no_text. Kuvaile haluttu lopullinen kuva myönteisessä kehotteessa ja määrittele kohde-, asettelu- ja värivaatimukset selvästi. 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.
Recraft dokumentoi erillisen kuvasta kuvaksi -operaation V4:lle. Se yhdistää olemassa olevan kuvan ja kehotteen sekä muutoksen astetta ohjaavan voimakkuuden 0–1 eikä hyväksy siinä V4:n omia tyyliasetuksia. Valmistele lähde valmistajan kuvasyöterajojen sisällä ja kerro uuteen tulokseen siirtyvät ominaisuudet. Tarkista suuremmasta lopullisesta kuvasta hienot yksityiskohdat, rajaus ja teksti tarkoitetussa koossa. Pron suuremmat rasteriyksityiskohdat tukevat tarkastusta, mutta kuva pysyy annetun luovan ohjeen generoituna tulkintana. Anna kuvasta kuvaksi -työhön PNG, JPG, WebP tai SVG alle 20 MB:n koossa, enintään 16 megapikseliä ja molemmat sivut 256–4 096 pikseliä.
", "aboutText": "Recraft V4 Pro on Recraftin V4-perheen korkeamman tarkkuuden rasterimalli. V4 keskittyy visuaaliseen harkintaan, tasapainoiseen sommitteluun, yhtenäisiin väreihin ja luovan ohjeen huolelliseen tulkintaan. Valmistaja asemoi Pron hienompiin yksityiskohtiin, realistisempiin monimutkaisiin kohtauksiin ja laajoihin tuotantokuviin. Käytä sitä yksityiskohtaiseen kuvitukseen, toimitukselliseen kuvaan, julistekonseptiin tai muuhun suuremmasta rasterituloksesta hyötyvään aineistoon. Se pysyy erillään myöhemmästä V4.1-mallista ja V4 Pro Vectorin SVG-tuloksesta.\n\nValmistajan nimenomainen koodi on recraftv4_pro. Dokumentoitu tulos on 2K-rasteri häviöttömänä WebP:nä tai PNG:nä: neliö 2048 × 2048 pikseliä, 16:9 2688 × 1536 ja 2:3 1664 × 2560. Muilla tuetuilla suhteilla on omat mittansa. Valitse halutun asettelun kuvasuhde tai tarkka sallittu koko; mielivaltainen pikselikoko ei kuulu dokumentoituun generointisopimukseen. Tavallisella V4:llä on pienempi 1K-rasteritulos, kun taas vektorimalleilla ei ole kiinteää pikselitarkkuutta.\n\nV4 voi tulkita lyhyen kehotteen ideointiin tai rakenteisen kehotteen hallittuun tulokseen. Tiettyä taiteellista suuntaa varten valmistajan opas etenee kohteesta ja ympäristöstä rajaukseen, ominaisuuksiin, tilallisiin suhteisiin, valaistukseen, syvyyteen ja tunnelmaan. Pyydä toimitukselliseen tuotekuvaan dramaattinen pystyvalokuva veistoksellisesta tuolista, harjatut metallipinnat, sivuvalo, rauhallinen tumma tausta ja tilaa esineen yläpuolelle otsikolle. Näiden suhteiden nimeäminen selventää haluttua sommittelua enemmän kuin yleinen laadukkaan kuvan pyyntö.\n\nPerheen luova alue sisältää kerronnallisen kuvituksen, fotorealistiset kohtaukset ja tilalliset kuvat materiaali- ja valaistusvihjeillä. 3D:n näköinen tulos on silti kuva, ei muokattava 3D-kohtaus. Määrittele graafiseen julisteeseen visuaaliset kerrokset ja niiden vuorovaikutus: tausta, kuvitus tai valokuva, otsikkohierarkia ja tukiteksti. V4 asemoidaan luettaviin lyhyisiin ja keskipitkiin ilmauksiin, mutta lopullinen oikeinkirjoitus ja hierarkia tulee tarkastaa eikä päätellä mallinimestä.\n\nNykyinen generointiviite sallii enintään 10 000 merkin kehotteet, yhdestä kuuteen tulosta, satunnaissiemenen sekä toivottujen värien ja taustavärin asetukset. Valinnaiset omat tyylit tai yhteensopivat viitekuvat voivat ohjata ulkonäköä joustavalla tai tarkalla vastaavuudella. Malli ei hyväksy vanhempia V3-asetuksia negative_prompt, kuratoituja tyylejä, text_layout, artistic_level tai no_text. Kuvaile haluttu lopullinen kuva myönteisessä kehotteessa ja määrittele kohde-, asettelu- ja värivaatimukset selvästi. 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.\n\nRecraft dokumentoi erillisen kuvasta kuvaksi -operaation V4:lle. Se yhdistää olemassa olevan kuvan ja kehotteen sekä muutoksen astetta ohjaavan voimakkuuden 0–1 eikä hyväksy siinä V4:n omia tyyliasetuksia. Valmistele lähde valmistajan kuvasyöterajojen sisällä ja kerro uuteen tulokseen siirtyvät ominaisuudet. Tarkista suuremmasta lopullisesta kuvasta hienot yksityiskohdat, rajaus ja teksti tarkoitetussa koossa. Pron suuremmat rasteriyksityiskohdat tukevat tarkastusta, mutta kuva pysyy annetun luovan ohjeen generoituna tulkintana. Anna kuvasta kuvaksi -työhön PNG, JPG, WebP tai SVG alle 20 MB:n koossa, enintään 16 megapikseliä ja molemmat sivut 256–4 096 pikseliä.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "c706621c028759d0777a3c672844fc60fa47151daf7d30c0091b9f857b03f615", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "recraft/recraft-v4-proRecraft V4 Pro generoi 2K-rasterikuvia yksityiskohtaisiin sommitelmiin, fotorealismiin, kuvitukseen ja painoon suunnattuun luovaan työhön. Se on korkeamman tarkkuuden V4-versio, jossa on tekstiohjeet, valinnaiset tyylisyötteet ja erillinen kuvasta kuvaksi -työnkulku.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
Recraft V4 Pro on Recraftin V4-perheen korkeamman tarkkuuden rasterimalli. V4 keskittyy visuaaliseen harkintaan, tasapainoiseen sommitteluun, yhtenäisiin väreihin ja luovan ohjeen huolelliseen tulkintaan. Valmistaja asemoi Pron hienompiin yksityiskohtiin, realistisempiin monimutkaisiin kohtauksiin ja laajoihin tuotantokuviin. Käytä sitä yksityiskohtaiseen kuvitukseen, toimitukselliseen kuvaan, julistekonseptiin tai muuhun suuremmasta rasterituloksesta hyötyvään aineistoon. Se pysyy erillään myöhemmästä V4.1-mallista ja V4 Pro Vectorin SVG-tuloksesta.
Valmistajan nimenomainen koodi on recraftv4_pro. Dokumentoitu tulos on 2K-rasteri häviöttömänä WebP:nä tai PNG:nä: neliö 2048 × 2048 pikseliä, 16:9 2688 × 1536 ja 2:3 1664 × 2560. Muilla tuetuilla suhteilla on omat mittansa. Valitse halutun asettelun kuvasuhde tai tarkka sallittu koko; mielivaltainen pikselikoko ei kuulu dokumentoituun generointisopimukseen. Tavallisella V4:llä on pienempi 1K-rasteritulos, kun taas vektorimalleilla ei ole kiinteää pikselitarkkuutta.
V4 voi tulkita lyhyen kehotteen ideointiin tai rakenteisen kehotteen hallittuun tulokseen. Tiettyä taiteellista suuntaa varten valmistajan opas etenee kohteesta ja ympäristöstä rajaukseen, ominaisuuksiin, tilallisiin suhteisiin, valaistukseen, syvyyteen ja tunnelmaan. Pyydä toimitukselliseen tuotekuvaan dramaattinen pystyvalokuva veistoksellisesta tuolista, harjatut metallipinnat, sivuvalo, rauhallinen tumma tausta ja tilaa esineen yläpuolelle otsikolle. Näiden suhteiden nimeäminen selventää haluttua sommittelua enemmän kuin yleinen laadukkaan kuvan pyyntö.
Perheen luova alue sisältää kerronnallisen kuvituksen, fotorealistiset kohtaukset ja tilalliset kuvat materiaali- ja valaistusvihjeillä. 3D:n näköinen tulos on silti kuva, ei muokattava 3D-kohtaus. Määrittele graafiseen julisteeseen visuaaliset kerrokset ja niiden vuorovaikutus: tausta, kuvitus tai valokuva, otsikkohierarkia ja tukiteksti. V4 asemoidaan luettaviin lyhyisiin ja keskipitkiin ilmauksiin, mutta lopullinen oikeinkirjoitus ja hierarkia tulee tarkastaa eikä päätellä mallinimestä.
Nykyinen generointiviite sallii enintään 10 000 merkin kehotteet, yhdestä kuuteen tulosta, satunnaissiemenen sekä toivottujen värien ja taustavärin asetukset. Valinnaiset omat tyylit tai yhteensopivat viitekuvat voivat ohjata ulkonäköä joustavalla tai tarkalla vastaavuudella. Malli ei hyväksy vanhempia V3-asetuksia negative_prompt, kuratoituja tyylejä, text_layout, artistic_level tai no_text. Kuvaile haluttu lopullinen kuva myönteisessä kehotteessa ja määrittele kohde-, asettelu- ja värivaatimukset selvästi. 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.
Recraft dokumentoi erillisen kuvasta kuvaksi -operaation V4:lle. Se yhdistää olemassa olevan kuvan ja kehotteen sekä muutoksen astetta ohjaavan voimakkuuden 0–1 eikä hyväksy siinä V4:n omia tyyliasetuksia. Valmistele lähde valmistajan kuvasyöterajojen sisällä ja kerro uuteen tulokseen siirtyvät ominaisuudet. Tarkista suuremmasta lopullisesta kuvasta hienot yksityiskohdat, rajaus ja teksti tarkoitetussa koossa. Pron suuremmat rasteriyksityiskohdat tukevat tarkastusta, mutta kuva pysyy annetun luovan ohjeen generoituna tulkintana. Anna kuvasta kuvaksi -työhön PNG, JPG, WebP tai SVG alle 20 MB:n koossa, enintään 16 megapikseliä ja molemmat sivut 256–4 096 pikseliä.
POST /v1/images/generationstext, imageimage| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat recraft/recraft-v4-pro | 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.5 tuloskuvaa kohden |
| AsetuksetArvioitu luontikustannus | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Laskutusyksikkö— | Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.5 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.5 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-v4-pro', '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-v4-pro', '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-v4-pro", "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-v4-pro
/v1/images