Recraft V4.1 Utility är standardmodellen för rasterbilder i Utility-grenen av Recrafts V4.1-familj. Den föredrar enkla scener, jämn belysning och framåtvänd komposition framför huvudmodellens mer uttrycksfulla val av vinkel, ljus och stämning. Dess praktiska roll är en tydlig produktbild eller mockup där föremålet och nödvändiga detaljer ska dominera. Den specifika utgåvan Utility är separat från Utility Pro, huvudmodellen V4.1 och de vektorvarianter som producerar SVG.
Tillverkarens modellkod är recraftv4_1_utility. Den returnerar rasterbilder i 1K som förlustfri WebP eller PNG, med storlekar valda från stödda bildförhållanden. En kvadratisk bild är 1024 × 1024 pixlar och en 4:3-bild är 1216 × 896. Utgåvan Utility Pro använder större 2K-dimensioner, så dessa utdatastorlekar ska inte tillskrivas vanliga Utility. Välj formen för avsedd produktannons eller mockup innan scenen beskrivs.
En användbar instruktion anger produkt, synvinkel, material, underlag, bakgrund och belysning i enkla termer. För en produktannons begär du en framåtvänd termosflaska mot en ljus bakgrund, jämnt belyst, med hela silhuetten synlig och utan störande scenelement. Om en produkt har faktiska mått eller särskiljande delar anger du dem uttryckligen. Utilitys preferens för enkel presentation fastställer inte fakta om en verklig produkt som saknades i instruktionen.
Generering stöder prompter på upp till 10 000 tecken, kontroller för önskade färger och bakgrundsfärg, ett slumpseed och en till sex utdata. Valfria kompatibla egna stilar eller referensbilder kan styra en katalogs visuella språk. Använd referensmaterial som är enhetligt i ljus och rendering och behåll samma kompatibla stil för efterföljande produktinstruktioner. Exakt färgmatchning mellan referens och utdata garanteras inte, så jämför slutbilden med den nödvändiga paletten. För generering med referensstil använder du en till tio PNG-, JPG- eller WebP-bilder, högst 64 MB sammanlagt och under 20 MB per bild. Varje referens behöver en kortsida på minst 256 pixlar, en långsida på högst 4 096 pixlar och upplösning på högst 16 megapixlar. Använd antingen dessa referenser eller en kompatibel sparad stil, inte båda. Vid generering med referensstil tillåter flexibel matchning en friare tolkning, medan precis matchning följer rendering, palett, komposition och ljus närmare.
Det separata bild-till-bild-flödet använder en befintlig bild och en prompt, med styrka från 0 till 1 som styr ändringens omfattning. Lägre styrka håller resultatet närmare källan; högre styrka tillåter större avvikelser. Indata kan vara PNG, JPG, WebP eller SVG under 20 MB, upp till 16 MP, med sidor mellan 256 och 4096 pixlar. Egna V4.1-stilar accepteras inte i den omvandlingsoperationen, som är separat från att koppla en stilreferens till en ny generering.
V4.1 Utility tar inte emot kurerade stilnamn eller kontrollerna negative_prompt, text_layout, artistic_level eller no_text. Ange önskad färdig scen direkt i den positiva prompten. För en serie produktbilder håller du instruktioner för utsnitt och bakgrund stabila och jämför sedan varje bild med inskickad produktform, material och detaljer innan den används i en layout. Vanliga Utility är ett fokuserat rasterverktyg för återhållsam presentation; välj specifikt utdataformat och utgåva efter uppgiften.
", "aboutText": "Recraft V4.1 Utility är standardmodellen för rasterbilder i Utility-grenen av Recrafts V4.1-familj. Den föredrar enkla scener, jämn belysning och framåtvänd komposition framför huvudmodellens mer uttrycksfulla val av vinkel, ljus och stämning. Dess praktiska roll är en tydlig produktbild eller mockup där föremålet och nödvändiga detaljer ska dominera. Den specifika utgåvan Utility är separat från Utility Pro, huvudmodellen V4.1 och de vektorvarianter som producerar SVG.\n\nTillverkarens modellkod är recraftv4_1_utility. Den returnerar rasterbilder i 1K som förlustfri WebP eller PNG, med storlekar valda från stödda bildförhållanden. En kvadratisk bild är 1024 × 1024 pixlar och en 4:3-bild är 1216 × 896. Utgåvan Utility Pro använder större 2K-dimensioner, så dessa utdatastorlekar ska inte tillskrivas vanliga Utility. Välj formen för avsedd produktannons eller mockup innan scenen beskrivs.\n\nEn användbar instruktion anger produkt, synvinkel, material, underlag, bakgrund och belysning i enkla termer. För en produktannons begär du en framåtvänd termosflaska mot en ljus bakgrund, jämnt belyst, med hela silhuetten synlig och utan störande scenelement. Om en produkt har faktiska mått eller särskiljande delar anger du dem uttryckligen. Utilitys preferens för enkel presentation fastställer inte fakta om en verklig produkt som saknades i instruktionen.\n\nGenerering stöder prompter på upp till 10 000 tecken, kontroller för önskade färger och bakgrundsfärg, ett slumpseed och en till sex utdata. Valfria kompatibla egna stilar eller referensbilder kan styra en katalogs visuella språk. Använd referensmaterial som är enhetligt i ljus och rendering och behåll samma kompatibla stil för efterföljande produktinstruktioner. Exakt färgmatchning mellan referens och utdata garanteras inte, så jämför slutbilden med den nödvändiga paletten. För generering med referensstil använder du en till tio PNG-, JPG- eller WebP-bilder, högst 64 MB sammanlagt och under 20 MB per bild. Varje referens behöver en kortsida på minst 256 pixlar, en långsida på högst 4 096 pixlar och upplösning på högst 16 megapixlar. Använd antingen dessa referenser eller en kompatibel sparad stil, inte båda. Vid generering med referensstil tillåter flexibel matchning en friare tolkning, medan precis matchning följer rendering, palett, komposition och ljus närmare.\n\nDet separata bild-till-bild-flödet använder en befintlig bild och en prompt, med styrka från 0 till 1 som styr ändringens omfattning. Lägre styrka håller resultatet närmare källan; högre styrka tillåter större avvikelser. Indata kan vara PNG, JPG, WebP eller SVG under 20 MB, upp till 16 MP, med sidor mellan 256 och 4096 pixlar. Egna V4.1-stilar accepteras inte i den omvandlingsoperationen, som är separat från att koppla en stilreferens till en ny generering.\n\nV4.1 Utility tar inte emot kurerade stilnamn eller kontrollerna negative_prompt, text_layout, artistic_level eller no_text. Ange önskad färdig scen direkt i den positiva prompten. För en serie produktbilder håller du instruktioner för utsnitt och bakgrund stabila och jämför sedan varje bild med inskickad produktform, material och detaljer innan den används i en layout. Vanliga Utility är ett fokuserat rasterverktyg för återhållsam presentation; välj specifikt utdataformat och utgåva efter uppgiften.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "29ee16ca3b9d803be3bf503e045815a7a7ab83bca6b7ed21fa7acdc58ef314ca", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sv", "methods": [ { "html": "recraft/recraft-v4.1-utilityRecraft V4.1 Utility genererar rasterbilder i 1K för enkla produkttagningar, mockuper och okomplicerade scener. Den föredrar jämn belysning och framåtvänd komposition, med textprompter och valfria bild- eller stilindata för en förutsägbar visuell inriktning.
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
Recraft V4.1 Utility är standardmodellen för rasterbilder i Utility-grenen av Recrafts V4.1-familj. Den föredrar enkla scener, jämn belysning och framåtvänd komposition framför huvudmodellens mer uttrycksfulla val av vinkel, ljus och stämning. Dess praktiska roll är en tydlig produktbild eller mockup där föremålet och nödvändiga detaljer ska dominera. Den specifika utgåvan Utility är separat från Utility Pro, huvudmodellen V4.1 och de vektorvarianter som producerar SVG.
Tillverkarens modellkod är recraftv4_1_utility. Den returnerar rasterbilder i 1K som förlustfri WebP eller PNG, med storlekar valda från stödda bildförhållanden. En kvadratisk bild är 1024 × 1024 pixlar och en 4:3-bild är 1216 × 896. Utgåvan Utility Pro använder större 2K-dimensioner, så dessa utdatastorlekar ska inte tillskrivas vanliga Utility. Välj formen för avsedd produktannons eller mockup innan scenen beskrivs.
En användbar instruktion anger produkt, synvinkel, material, underlag, bakgrund och belysning i enkla termer. För en produktannons begär du en framåtvänd termosflaska mot en ljus bakgrund, jämnt belyst, med hela silhuetten synlig och utan störande scenelement. Om en produkt har faktiska mått eller särskiljande delar anger du dem uttryckligen. Utilitys preferens för enkel presentation fastställer inte fakta om en verklig produkt som saknades i instruktionen.
Generering stöder prompter på upp till 10 000 tecken, kontroller för önskade färger och bakgrundsfärg, ett slumpseed och en till sex utdata. Valfria kompatibla egna stilar eller referensbilder kan styra en katalogs visuella språk. Använd referensmaterial som är enhetligt i ljus och rendering och behåll samma kompatibla stil för efterföljande produktinstruktioner. Exakt färgmatchning mellan referens och utdata garanteras inte, så jämför slutbilden med den nödvändiga paletten. För generering med referensstil använder du en till tio PNG-, JPG- eller WebP-bilder, högst 64 MB sammanlagt och under 20 MB per bild. Varje referens behöver en kortsida på minst 256 pixlar, en långsida på högst 4 096 pixlar och upplösning på högst 16 megapixlar. Använd antingen dessa referenser eller en kompatibel sparad stil, inte båda. Vid generering med referensstil tillåter flexibel matchning en friare tolkning, medan precis matchning följer rendering, palett, komposition och ljus närmare.
Det separata bild-till-bild-flödet använder en befintlig bild och en prompt, med styrka från 0 till 1 som styr ändringens omfattning. Lägre styrka håller resultatet närmare källan; högre styrka tillåter större avvikelser. Indata kan vara PNG, JPG, WebP eller SVG under 20 MB, upp till 16 MP, med sidor mellan 256 och 4096 pixlar. Egna V4.1-stilar accepteras inte i den omvandlingsoperationen, som är separat från att koppla en stilreferens till en ny generering.
V4.1 Utility tar inte emot kurerade stilnamn eller kontrollerna negative_prompt, text_layout, artistic_level eller no_text. Ange önskad färdig scen direkt i den positiva prompten. För en serie produktbilder håller du instruktioner för utsnitt och bakgrund stabila och jämför sedan varje bild med inskickad produktform, material och detaljer innan den används i en layout. Vanliga Utility är ett fokuserat rasterverktyg för återhållsam presentation; välj specifikt utdataformat och utgåva efter uppgiften.
POST /v1/images/generationstext, imageimage| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser recraft/recraft-v4.1-utility | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser Minsta längd: 1 | Standard— |
Fältaspect_ratio | Typstring | KravValfritt | Värden & gränser 1:1, 4:3, 3:4, 16:9, 9:16, auto | Standard— |
Fältn | Typinteger | KravValfritt | Värden & gränser Minimum: 1 Maximum: 6 | Standard— |
Fältinput_references | Typarray | KravValfritt | Värden & gränser Minsta antal objekt: 0 Maximalt antal objekt: 1 | Standard— |
Fältprovider | Typobject | KravValfritt | Värden & gränser | Standard— |
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, prompt |
Parametermaterial_types | Avtaltext, image |
Livscykel: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Det task_id som faktiskt returnerades eller en post i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Prognostiserad mängd | Debiteringsenhet | Avgift |
|---|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad mängd— | Debiteringsenhet— | Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token |
| Konfigurationutdatabild | Prislista— | Prognostiserad mängd— | Debiteringsenhetper utdatabild | Avgift Utdata · utdatabild · Uppskattning endast för jämförelse $0.07 per utdatabild |
| KonfigurationUppskattad genereringskostnad | Prislista— | Prognostiserad mängduppskattning för en generering | Debiteringsenhet— | Avgift Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.07 uppskattning före generering Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen. |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
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\nLadda ned varje returnerad bild eller spara dess Base64-innehåll
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.\nSpara varje färdig bild; hämta varje returnerad URL eller avkoda dess Base64-innehåll.
Spara hela svaret med headers, samtliga faktiska resultat, de ursprungliga returnerade identifierarna och alla användningsfält. Hämta den ursprungliga operationen utan att skicka skapandeförfrågan igen.
Behåll det returnerade värdet för X-Client-Request-ID för avstämning. Läs endast av resultat via de task_id/asset_id-värden som faktiskt returnerades eller via det mediebibliotek som tillhör dig. Bygg aldrig en uppgifts-URL från operations-ID:t och skicka aldrig skapandeförfrågan igen.
| Fält | Typ |
|---|---|
Fältcreated | Typ |
Fältdata[].url | Typ |
Fältdata[].b64_json | Typ |
Fältusage | Typ |
Ailoot Ultra recraft/recraft-v4.1-utility
/v1/images