Recraft V4.1 är huvudmodellen för rasterbilder i Recrafts V4.1-familj. Den är byggd för uttrycksfullt bildskapande, inklusive naturliga fotografier, illustration och visuella koncept med rumsligt djup. Tillverkaren presenterar den som en modell som kan bidra med estetiska beslut från en kort prompt och samtidigt svara på mer detaljerad kreativ styrning. Använd den för utforskande, konceptarbete och bilder där stämning, belysning och komposition ingår i resultatet i stället för att reduceras till en enkel framåtvänd produktvy.
Tillverkarens specifika kod är recraftv4_1. Den returnerar rasterbilder i 1K som förlustfri WebP eller PNG, med kvadratiska utdata på 1024 × 1024 pixlar och 16:9 på 1344 × 768. Andra stödda förhållanden använder egna dimensioner. V4.1 Pro är den separata rasterutgåvan i 2K, Vector returnerar redigerbar SVG och Utility föredrar enklare ljus och scener. Grenarna tjänar olika leveranser och ska inte sammanföras till en enda uppsättning utdataegenskaper.
Tillverkaren framhäver mer naturliga fotografiska scener, lugnare bakgrund, mjukare toningar och ett brett illustrationsregister. Exemplen omfattar uttrycksfulla bokstäver, platt karaktärsillustration och ett ritat karaktärsreferensblad. En kort prompt kan lämna utrymme för modellens tolkning; en detaljerad instruktion kan fastställa motiv, pose, material, bakgrund och komposition. För en bild med rumsligt djup anger du yt- och ljusbehandling och minns att resultatet är en bild, inte ett mesh eller ett redigerbart 3D-projekt.
För ett läshörnskoncept begär du ett intimt fotografi av en liten läshörna, varmt dagsljus, böcker och ett keramikföremål, med avslappnat arrangemang snarare än utställningskänsla. En kontrollerad illustrationsinstruktion kan i stället namnge det grafiska motivet, färgrelationer och linjebehandling. Ange avsett bildförhållande och de viktigaste visuella besluten. Detta gör det lättare att avgöra om en oväntad detalj är användbar kreativ tolkning eller något som bör ändras i nästa instruktion.
Genereringsreferensen tillåter prompter på upp till 10 000 tecken, ett slumpseed, önskade färger och önskad bakgrundsfärg, med en till sex utdata. Valfria referensbilder eller kompatibla sparade stilar kan fastställa ett visuellt språk med flexibel eller precis matchning. De krävs inte för huvudutgåvan V4.1. Välj tydliga referenser som stämmer överens och använd prompten för det nya innehållet; återgivning av referensfärger garanteras inte. 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.
V4.1 stöder också ett separat bild-till-bild-flöde med en befintlig bild, text och styrka från 0 till 1. Operationen använder styrka för att styra hur nära den nya bilden håller sig till källan och tar inte emot kontroller för egna V4.1-stilar. Modellens nuvarande genereringsreferens utesluter negative_prompt, kurerade stilar, text_layout, artistic_level och no_text. Beskriv avsedd scen direkt och granska materialet i mållayouten, inklusive detaljer, beskärning och eventuella bokstäver, innan du avgör vilken visuell inriktning som ska behållas. För bild-till-bild anger du PNG, JPG, WebP eller SVG under 20 MB, högst 16 megapixlar, med båda sidor mellan 256 och 4 096 pixlar.
", "aboutText": "Recraft V4.1 är huvudmodellen för rasterbilder i Recrafts V4.1-familj. Den är byggd för uttrycksfullt bildskapande, inklusive naturliga fotografier, illustration och visuella koncept med rumsligt djup. Tillverkaren presenterar den som en modell som kan bidra med estetiska beslut från en kort prompt och samtidigt svara på mer detaljerad kreativ styrning. Använd den för utforskande, konceptarbete och bilder där stämning, belysning och komposition ingår i resultatet i stället för att reduceras till en enkel framåtvänd produktvy.\n\nTillverkarens specifika kod är recraftv4_1. Den returnerar rasterbilder i 1K som förlustfri WebP eller PNG, med kvadratiska utdata på 1024 × 1024 pixlar och 16:9 på 1344 × 768. Andra stödda förhållanden använder egna dimensioner. V4.1 Pro är den separata rasterutgåvan i 2K, Vector returnerar redigerbar SVG och Utility föredrar enklare ljus och scener. Grenarna tjänar olika leveranser och ska inte sammanföras till en enda uppsättning utdataegenskaper.\n\nTillverkaren framhäver mer naturliga fotografiska scener, lugnare bakgrund, mjukare toningar och ett brett illustrationsregister. Exemplen omfattar uttrycksfulla bokstäver, platt karaktärsillustration och ett ritat karaktärsreferensblad. En kort prompt kan lämna utrymme för modellens tolkning; en detaljerad instruktion kan fastställa motiv, pose, material, bakgrund och komposition. För en bild med rumsligt djup anger du yt- och ljusbehandling och minns att resultatet är en bild, inte ett mesh eller ett redigerbart 3D-projekt.\n\nFör ett läshörnskoncept begär du ett intimt fotografi av en liten läshörna, varmt dagsljus, böcker och ett keramikföremål, med avslappnat arrangemang snarare än utställningskänsla. En kontrollerad illustrationsinstruktion kan i stället namnge det grafiska motivet, färgrelationer och linjebehandling. Ange avsett bildförhållande och de viktigaste visuella besluten. Detta gör det lättare att avgöra om en oväntad detalj är användbar kreativ tolkning eller något som bör ändras i nästa instruktion.\n\nGenereringsreferensen tillåter prompter på upp till 10 000 tecken, ett slumpseed, önskade färger och önskad bakgrundsfärg, med en till sex utdata. Valfria referensbilder eller kompatibla sparade stilar kan fastställa ett visuellt språk med flexibel eller precis matchning. De krävs inte för huvudutgåvan V4.1. Välj tydliga referenser som stämmer överens och använd prompten för det nya innehållet; återgivning av referensfärger garanteras inte. 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.\n\nV4.1 stöder också ett separat bild-till-bild-flöde med en befintlig bild, text och styrka från 0 till 1. Operationen använder styrka för att styra hur nära den nya bilden håller sig till källan och tar inte emot kontroller för egna V4.1-stilar. Modellens nuvarande genereringsreferens utesluter negative_prompt, kurerade stilar, text_layout, artistic_level och no_text. Beskriv avsedd scen direkt och granska materialet i mållayouten, inklusive detaljer, beskärning och eventuella bokstäver, innan du avgör vilken visuell inriktning som ska behållas. För bild-till-bild anger du PNG, JPG, WebP eller SVG under 20 MB, högst 16 megapixlar, med båda sidor mellan 256 och 4 096 pixlar.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "96b6adbcae4c6d8e012e98dc545ec00a670e4bbd4156e76b445c7621d8fc16df", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sv", "methods": [ { "html": "recraft/recraft-v4.1Recraft V4.1 skapar rasterbilder i 1K med naturlig fotorealism, uttrycksfull illustration och genomtänkt komposition. Den kan utveckla en kort kreativ inriktning eller följa en detaljerad instruktion, med valfria bild- och egna stilindata.
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 är huvudmodellen för rasterbilder i Recrafts V4.1-familj. Den är byggd för uttrycksfullt bildskapande, inklusive naturliga fotografier, illustration och visuella koncept med rumsligt djup. Tillverkaren presenterar den som en modell som kan bidra med estetiska beslut från en kort prompt och samtidigt svara på mer detaljerad kreativ styrning. Använd den för utforskande, konceptarbete och bilder där stämning, belysning och komposition ingår i resultatet i stället för att reduceras till en enkel framåtvänd produktvy.
Tillverkarens specifika kod är recraftv4_1. Den returnerar rasterbilder i 1K som förlustfri WebP eller PNG, med kvadratiska utdata på 1024 × 1024 pixlar och 16:9 på 1344 × 768. Andra stödda förhållanden använder egna dimensioner. V4.1 Pro är den separata rasterutgåvan i 2K, Vector returnerar redigerbar SVG och Utility föredrar enklare ljus och scener. Grenarna tjänar olika leveranser och ska inte sammanföras till en enda uppsättning utdataegenskaper.
Tillverkaren framhäver mer naturliga fotografiska scener, lugnare bakgrund, mjukare toningar och ett brett illustrationsregister. Exemplen omfattar uttrycksfulla bokstäver, platt karaktärsillustration och ett ritat karaktärsreferensblad. En kort prompt kan lämna utrymme för modellens tolkning; en detaljerad instruktion kan fastställa motiv, pose, material, bakgrund och komposition. För en bild med rumsligt djup anger du yt- och ljusbehandling och minns att resultatet är en bild, inte ett mesh eller ett redigerbart 3D-projekt.
För ett läshörnskoncept begär du ett intimt fotografi av en liten läshörna, varmt dagsljus, böcker och ett keramikföremål, med avslappnat arrangemang snarare än utställningskänsla. En kontrollerad illustrationsinstruktion kan i stället namnge det grafiska motivet, färgrelationer och linjebehandling. Ange avsett bildförhållande och de viktigaste visuella besluten. Detta gör det lättare att avgöra om en oväntad detalj är användbar kreativ tolkning eller något som bör ändras i nästa instruktion.
Genereringsreferensen tillåter prompter på upp till 10 000 tecken, ett slumpseed, önskade färger och önskad bakgrundsfärg, med en till sex utdata. Valfria referensbilder eller kompatibla sparade stilar kan fastställa ett visuellt språk med flexibel eller precis matchning. De krävs inte för huvudutgåvan V4.1. Välj tydliga referenser som stämmer överens och använd prompten för det nya innehållet; återgivning av referensfärger garanteras inte. 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.
V4.1 stöder också ett separat bild-till-bild-flöde med en befintlig bild, text och styrka från 0 till 1. Operationen använder styrka för att styra hur nära den nya bilden håller sig till källan och tar inte emot kontroller för egna V4.1-stilar. Modellens nuvarande genereringsreferens utesluter negative_prompt, kurerade stilar, text_layout, artistic_level och no_text. Beskriv avsedd scen direkt och granska materialet i mållayouten, inklusive detaljer, beskärning och eventuella bokstäver, innan du avgör vilken visuell inriktning som ska behållas. För bild-till-bild anger du PNG, JPG, WebP eller SVG under 20 MB, högst 16 megapixlar, med båda sidor mellan 256 och 4 096 pixlar.
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 | 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', '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
/v1/images