Recraft V4.1 Utility er standardmodellen for rasterbilder i Utility-grenen av Recrafts V4.1-familie. Den favoriserer enkle scener, flat belysning og frontvendt komposisjon, fremfor de mer uttrykksfulle valgene av vinkel, lys og stemning i hovedmodellen V4.1. Den praktiske rollen er et tydelig produktopptak eller en mockup der objektet og nødvendige detaljer skal dominere. Den spesifikke Utility-utgaven er atskilt fra Utility Pro, hovedmodellen V4.1 og vektorvariantene som produserer SVG.
Produsentens modellkode er recraftv4_1_utility. Den returnerer rasterbilder i 1K som tapsfri WebP eller PNG, med størrelser valgt blant de støttede sideforholdene. Et kvadratisk bilde er 1024 × 1024 piksler, og et 4:3-bilde er 1216 × 896. Pro Utility-utgaven bruker større 2K-dimensjoner, så disse utdatastørrelsene skal ikke tilordnes standardutgaven Utility. Velg formatet til den tiltenkte produktoppføringen eller mockupen før du beskriver scenen.
En nyttig beskrivelse navngir produkt, synsvinkel, materiale, overflate, bakgrunn og lyssetting med enkle ord. For en produktoppføring kan du be om en frontvendt isolert flaske mot en lys bakgrunn, jevnt belyst, med hele silhuetten synlig og uten distraherende sceneelementer. Hvis et produkt har faktiske dimensjoner eller særegne deler, oppgir du disse detaljene uttrykkelig. Utilitys preferanse for enkel presentasjon fastslår ikke fakta om et virkelig produkt som manglet i beskrivelsen.
Generering støtter prompter på opptil 10 000 tegn, kontroller for foretrukne farger og bakgrunnsfarge, en tilfeldig seed og ett til seks resultater. Valgfrie kompatible egendefinerte stiler eller referansebilder kan styre katalogens visuelle språk. Bruk referansemateriale som samsvarer i lyssetting og gjengivelse, og behold samme kompatible stil for senere produktbeskrivelser. Nøyaktig fargesamsvar mellom referanse og resultat er ikke garantert, så sammenlign sluttbildet med den nødvendige paletten. For generering med referansestil bruker du ett til ti PNG-, JPG- eller WebP-bilder, høyst 64 MB til sammen og under 20 MB hver. Hver referanse trenger en kortside på minst 256 piksler, en langside på høyst 4 096 piksler og en oppløsning på høyst 16 megapiksler. Bruk enten disse referansene eller en kompatibel lagret stil, fremfor begge deler. Ved generering med referansestil tillater flexible matching en friere tolkning, mens precise matching følger gjengivelse, palett, komposisjon og lyssetting tettere.
Den separate bilde-til-bilde-arbeidsflyten bruker et eksisterende bilde og en prompt, med styrke fra 0 til 1 som styrer omfanget av endringen. Lavere styrke holder resultatet nærmere kilden; høyere styrke lar det bevege seg lenger unna. Inndata kan være PNG, JPG, WebP eller SVG under 20 MB, opptil 16 MP, med sider mellom 256 og 4096 piksler. Egendefinerte V4.1-stiler godtas ikke i denne transformasjonsoperasjonen, som er atskilt fra å knytte en stilreferanse til en ny generering.
V4.1 Utility godtar ikke kuraterte stilnavn eller kontrollene negative_prompt, text_layout, artistic_level og no_text. Angi den ønskede ferdige scenen direkte i den positive prompten. For en serie produktbilder holder du utsnitts- og bakgrunnsinstruksjonene stabile, og sammenligner deretter hvert bilde med produktets innsendte form, materiale og detaljer før det brukes i en layout. Standardutgaven Utility er et avgrenset rasterverktøy for en behersket presentasjon; velg det konkrete utdataformatet og utgaven etter oppgaven.
", "aboutText": "Recraft V4.1 Utility er standardmodellen for rasterbilder i Utility-grenen av Recrafts V4.1-familie. Den favoriserer enkle scener, flat belysning og frontvendt komposisjon, fremfor de mer uttrykksfulle valgene av vinkel, lys og stemning i hovedmodellen V4.1. Den praktiske rollen er et tydelig produktopptak eller en mockup der objektet og nødvendige detaljer skal dominere. Den spesifikke Utility-utgaven er atskilt fra Utility Pro, hovedmodellen V4.1 og vektorvariantene som produserer SVG.\n\nProdusentens modellkode er recraftv4_1_utility. Den returnerer rasterbilder i 1K som tapsfri WebP eller PNG, med størrelser valgt blant de støttede sideforholdene. Et kvadratisk bilde er 1024 × 1024 piksler, og et 4:3-bilde er 1216 × 896. Pro Utility-utgaven bruker større 2K-dimensjoner, så disse utdatastørrelsene skal ikke tilordnes standardutgaven Utility. Velg formatet til den tiltenkte produktoppføringen eller mockupen før du beskriver scenen.\n\nEn nyttig beskrivelse navngir produkt, synsvinkel, materiale, overflate, bakgrunn og lyssetting med enkle ord. For en produktoppføring kan du be om en frontvendt isolert flaske mot en lys bakgrunn, jevnt belyst, med hele silhuetten synlig og uten distraherende sceneelementer. Hvis et produkt har faktiske dimensjoner eller særegne deler, oppgir du disse detaljene uttrykkelig. Utilitys preferanse for enkel presentasjon fastslår ikke fakta om et virkelig produkt som manglet i beskrivelsen.\n\nGenerering støtter prompter på opptil 10 000 tegn, kontroller for foretrukne farger og bakgrunnsfarge, en tilfeldig seed og ett til seks resultater. Valgfrie kompatible egendefinerte stiler eller referansebilder kan styre katalogens visuelle språk. Bruk referansemateriale som samsvarer i lyssetting og gjengivelse, og behold samme kompatible stil for senere produktbeskrivelser. Nøyaktig fargesamsvar mellom referanse og resultat er ikke garantert, så sammenlign sluttbildet med den nødvendige paletten. For generering med referansestil bruker du ett til ti PNG-, JPG- eller WebP-bilder, høyst 64 MB til sammen og under 20 MB hver. Hver referanse trenger en kortside på minst 256 piksler, en langside på høyst 4 096 piksler og en oppløsning på høyst 16 megapiksler. Bruk enten disse referansene eller en kompatibel lagret stil, fremfor begge deler. Ved generering med referansestil tillater flexible matching en friere tolkning, mens precise matching følger gjengivelse, palett, komposisjon og lyssetting tettere.\n\nDen separate bilde-til-bilde-arbeidsflyten bruker et eksisterende bilde og en prompt, med styrke fra 0 til 1 som styrer omfanget av endringen. Lavere styrke holder resultatet nærmere kilden; høyere styrke lar det bevege seg lenger unna. Inndata kan være PNG, JPG, WebP eller SVG under 20 MB, opptil 16 MP, med sider mellom 256 og 4096 piksler. Egendefinerte V4.1-stiler godtas ikke i denne transformasjonsoperasjonen, som er atskilt fra å knytte en stilreferanse til en ny generering.\n\nV4.1 Utility godtar ikke kuraterte stilnavn eller kontrollene negative_prompt, text_layout, artistic_level og no_text. Angi den ønskede ferdige scenen direkte i den positive prompten. For en serie produktbilder holder du utsnitts- og bakgrunnsinstruksjonene stabile, og sammenligner deretter hvert bilde med produktets innsendte form, materiale og detaljer før det brukes i en layout. Standardutgaven Utility er et avgrenset rasterverktøy for en behersket presentasjon; velg det konkrete utdataformatet og utgaven etter oppgaven.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "3c268626103a8d3d550548392084fd56be105d5079d3457b9c19e38911d8bc0a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nb", "methods": [ { "html": "recraft/recraft-v4.1-utilityRecraft V4.1 Utility genererer rasterbilder i 1K for enkle produktopptak, mockuper og ukompliserte scener. Den favoriserer flat belysning og frontvendt komposisjon, med tekstprompter og valgfrie bilde- eller stilinndata for en forutsigbar visuell retning.
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
Recraft V4.1 Utility er standardmodellen for rasterbilder i Utility-grenen av Recrafts V4.1-familie. Den favoriserer enkle scener, flat belysning og frontvendt komposisjon, fremfor de mer uttrykksfulle valgene av vinkel, lys og stemning i hovedmodellen V4.1. Den praktiske rollen er et tydelig produktopptak eller en mockup der objektet og nødvendige detaljer skal dominere. Den spesifikke Utility-utgaven er atskilt fra Utility Pro, hovedmodellen V4.1 og vektorvariantene som produserer SVG.
Produsentens modellkode er recraftv4_1_utility. Den returnerer rasterbilder i 1K som tapsfri WebP eller PNG, med størrelser valgt blant de støttede sideforholdene. Et kvadratisk bilde er 1024 × 1024 piksler, og et 4:3-bilde er 1216 × 896. Pro Utility-utgaven bruker større 2K-dimensjoner, så disse utdatastørrelsene skal ikke tilordnes standardutgaven Utility. Velg formatet til den tiltenkte produktoppføringen eller mockupen før du beskriver scenen.
En nyttig beskrivelse navngir produkt, synsvinkel, materiale, overflate, bakgrunn og lyssetting med enkle ord. For en produktoppføring kan du be om en frontvendt isolert flaske mot en lys bakgrunn, jevnt belyst, med hele silhuetten synlig og uten distraherende sceneelementer. Hvis et produkt har faktiske dimensjoner eller særegne deler, oppgir du disse detaljene uttrykkelig. Utilitys preferanse for enkel presentasjon fastslår ikke fakta om et virkelig produkt som manglet i beskrivelsen.
Generering støtter prompter på opptil 10 000 tegn, kontroller for foretrukne farger og bakgrunnsfarge, en tilfeldig seed og ett til seks resultater. Valgfrie kompatible egendefinerte stiler eller referansebilder kan styre katalogens visuelle språk. Bruk referansemateriale som samsvarer i lyssetting og gjengivelse, og behold samme kompatible stil for senere produktbeskrivelser. Nøyaktig fargesamsvar mellom referanse og resultat er ikke garantert, så sammenlign sluttbildet med den nødvendige paletten. For generering med referansestil bruker du ett til ti PNG-, JPG- eller WebP-bilder, høyst 64 MB til sammen og under 20 MB hver. Hver referanse trenger en kortside på minst 256 piksler, en langside på høyst 4 096 piksler og en oppløsning på høyst 16 megapiksler. Bruk enten disse referansene eller en kompatibel lagret stil, fremfor begge deler. Ved generering med referansestil tillater flexible matching en friere tolkning, mens precise matching følger gjengivelse, palett, komposisjon og lyssetting tettere.
Den separate bilde-til-bilde-arbeidsflyten bruker et eksisterende bilde og en prompt, med styrke fra 0 til 1 som styrer omfanget av endringen. Lavere styrke holder resultatet nærmere kilden; høyere styrke lar det bevege seg lenger unna. Inndata kan være PNG, JPG, WebP eller SVG under 20 MB, opptil 16 MP, med sider mellom 256 og 4096 piksler. Egendefinerte V4.1-stiler godtas ikke i denne transformasjonsoperasjonen, som er atskilt fra å knytte en stilreferanse til en ny generering.
V4.1 Utility godtar ikke kuraterte stilnavn eller kontrollene negative_prompt, text_layout, artistic_level og no_text. Angi den ønskede ferdige scenen direkte i den positive prompten. For en serie produktbilder holder du utsnitts- og bakgrunnsinstruksjonene stabile, og sammenligner deretter hvert bilde med produktets innsendte form, materiale og detaljer før det brukes i en layout. Standardutgaven Utility er et avgrenset rasterverktøy for en behersket presentasjon; velg det konkrete utdataformatet og utgaven etter oppgaven.
POST /v1/images/generationstext, imageimage| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser recraft/recraft-v4.1-utility | Standard— |
Feltprompt | Typestring | KravPåkrevd | Verdier & grenser Minste lengde: 1 | Standard— |
Feltaspect_ratio | Typestring | KravValgfritt | Verdier & grenser 1:1, 4:3, 3:4, 16:9, 9:16, auto | Standard— |
Feltn | Typeinteger | KravValgfritt | Verdier & grenser Minimum: 1 Maksimum: 6 | Standard— |
Feltinput_references | Typearray | KravValgfritt | Verdier & grenser Minste antall elementer: 0 Maksimalt antall elementer: 1 | Standard— |
Feltprovider | Typeobject | KravValgfritt | Verdier & grenser | Standard— |
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, prompt |
Parametermaterial_types | Avtaletext, image |
Livssyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · faktisk returnert task_id eller oppføring i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Forventet mengde | Faktureringsenhet | Kostnad |
|---|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Forventet mengde— | Faktureringsenhet— | Kostnad Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener |
| Konfigurasjonutdatabilde | Prisplan— | Forventet mengde— | Faktureringsenhetper utdatabilde | Kostnad Utdata · utdatabilde · Estimat kun for sammenligning $0.07 per utdatabilde |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Faktureringsenhet— | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $0.07 estimat før generering Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen. |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
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.1-utility', '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\nLast ned hvert returnerte bilde eller lagre Base64-innholdet
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nLagre hvert ferdige bilde; hent hver returnerte URL eller dekod Base64-innholdet.
Bevar hele svaret og svarhodene, alle faktiske utdata, de opprinnelige returnerte identifikatorene og alle bruksfeltene. Hent den opprinnelige operasjonen igjen uten å sende opprettelsesforespørselen på nytt.
Bevar returnert X-Client-Request-ID for avstemming. Les bare faktisk returnerte task_id/asset_id-verdier eller egne oppføringer i mediebiblioteket; bygg aldri en oppgave-URL fra operasjons-ID-en, og send aldri opprettelsesforespørselen på nytt.
| Felt | Type |
|---|---|
Feltcreated | Type |
Feltdata[].url | Type |
Feltdata[].b64_json | Type |
Feltusage | Type |
Ailoot Ultra recraft/recraft-v4.1-utility
/v1/images