Recraft V4.1 Pro is de rastereditie met hogere resolutie binnen Recrafts expressieve V4.1-generatiefamilie. De fabrikant benadrukt natuurlijk fotorealisme, bewuste compositie en illustratiestijlen die vanuit een korte creatieve richting kunnen worden ontwikkeld. Pro is bedoeld voor werk waarin fijnere details en een groter rasterresultaat belangrijk zijn, waaronder omvangrijke marketingbeelden en drukwerkgerichte lay-outs. Het verschilt van de eenvoudigere presentatie van Utility Pro en van de bewerkbare SVG-uitvoer van Pro Vector.
Het specifieke model is recraftv4_1_pro. De producentreferentie vermeldt 2K-uitvoer in verliesloos WebP of PNG. Het vierkante formaat is 2048 × 2048 pixels; 16:9 is 2688 × 1536 en 3:4 is 1792 × 2432, terwijl andere toegestane verhoudingen hun eigen afmetingen hebben. Gebruik een beeldverhouding voor de beoogde lay-out of een exact formaat uit de producenttabel. De naam Pro maakt niet elke compositie vierkant en verandert een rasterafbeelding niet in vectorgeometrie.
V4.1 kan een korte aanwijzing interpreteren en daarbij keuzes voor licht, sfeer en compositie maken. Dit is nuttig om een redactionele foto, gestileerde illustratie of ruimtelijk beeld met reflecterende materialen te verkennen. Een gerenderde 3D-look blijft een afbeelding en geen bewerkbare driedimensionale scène. Beschrijf bij een specifieke artdirection onderwerp en scène, kadrering, materiaalgedrag, lichtrichting, achtergrond en visuele hiërarchie, in plaats van te verwachten dat een open prompt elk detail op de gewenste manier oplost.
Vraag voor een redactionele foto om een close-up van een lamp van geborsteld metaal in zacht raamlicht, een warm bewoond interieur en een rustige compositie met ruimte voor een bijschrift. Een meer illustratieve briefing kan brede kleurvlakken, een levendige personagehouding en een ingetogen achtergrond specificeren. Lever het beoogde gebruik en de onderscheidende onderwerpdetails aan en controleer daarna materiaal, anatomie en compositie in de grotere uitvoer. Het resultaat is creatief beeldmateriaal dat door de briefing wordt gestuurd en geen waarneming van een echte scène.
Generatie accepteert prompts tot 10000 tekens, voorkeurskleuren, een gewenste achtergrondkleur, een willekeurige seed en één tot zes uitvoerafbeeldingen. Optionele stijlreferenties of compatibele opgeslagen stijlen kunnen een terugkerende visuele behandeling geven, met flexible of precise matching. Gebruik samenhangende, duidelijke referenties en specificeer de inhoud in de prompt; exacte kleurovereenkomst met een referentie is niet gegarandeerd. V4.1 sluit negative_prompt, voorgeselecteerde stijlnamen, text_layout, artistic_level en no_text uit; die instellingen mogen dus niet uit oudere edities worden overgenomen. Gebruik voor generatie met een referentiestijl één tot tien PNG-, JPG- of WebP-afbeeldingen, samen maximaal 64 MB en elk kleiner dan 20 MB. Elke referentie vereist een kortste zijde van minimaal 256 pixels, een langste zijde van maximaal 4096 pixels en een resolutie van maximaal 16 megapixels. Gebruik deze referenties óf een compatibele opgeslagen stijl, niet beide.
Recrafts afzonderlijke afbeelding-naar-afbeeldingoperatie ondersteunt de V4.1-familie met een bestaande afbeelding, een prompt en sterkte van 0 tot 1. Deze kan aspecten van de bron behouden en andere veranderen; lagere sterkte blijft dichter bij de bron en hogere sterkte staat meer verandering toe. Die operatie accepteert geen instellingen voor aangepaste V4.1-stijlen. Bereid de bronafbeelding binnen de gedocumenteerde afbeeldingslimieten voor en benoem zowel de gewenste verandering als de eigenschappen die het nieuwe resultaat moeten sturen. Controleer een definitief beeld in de daadwerkelijke compositie, vooral fijne details, letters en uitsnede. Lever voor afbeelding naar afbeelding PNG, JPG, WebP of SVG kleiner dan 20 MB aan, maximaal 16 megapixels, met beide zijden tussen 256 en 4096 pixels.
", "aboutText": "Recraft V4.1 Pro is de rastereditie met hogere resolutie binnen Recrafts expressieve V4.1-generatiefamilie. De fabrikant benadrukt natuurlijk fotorealisme, bewuste compositie en illustratiestijlen die vanuit een korte creatieve richting kunnen worden ontwikkeld. Pro is bedoeld voor werk waarin fijnere details en een groter rasterresultaat belangrijk zijn, waaronder omvangrijke marketingbeelden en drukwerkgerichte lay-outs. Het verschilt van de eenvoudigere presentatie van Utility Pro en van de bewerkbare SVG-uitvoer van Pro Vector.\n\nHet specifieke model is recraftv4_1_pro. De producentreferentie vermeldt 2K-uitvoer in verliesloos WebP of PNG. Het vierkante formaat is 2048 × 2048 pixels; 16:9 is 2688 × 1536 en 3:4 is 1792 × 2432, terwijl andere toegestane verhoudingen hun eigen afmetingen hebben. Gebruik een beeldverhouding voor de beoogde lay-out of een exact formaat uit de producenttabel. De naam Pro maakt niet elke compositie vierkant en verandert een rasterafbeelding niet in vectorgeometrie.\n\nV4.1 kan een korte aanwijzing interpreteren en daarbij keuzes voor licht, sfeer en compositie maken. Dit is nuttig om een redactionele foto, gestileerde illustratie of ruimtelijk beeld met reflecterende materialen te verkennen. Een gerenderde 3D-look blijft een afbeelding en geen bewerkbare driedimensionale scène. Beschrijf bij een specifieke artdirection onderwerp en scène, kadrering, materiaalgedrag, lichtrichting, achtergrond en visuele hiërarchie, in plaats van te verwachten dat een open prompt elk detail op de gewenste manier oplost.\n\nVraag voor een redactionele foto om een close-up van een lamp van geborsteld metaal in zacht raamlicht, een warm bewoond interieur en een rustige compositie met ruimte voor een bijschrift. Een meer illustratieve briefing kan brede kleurvlakken, een levendige personagehouding en een ingetogen achtergrond specificeren. Lever het beoogde gebruik en de onderscheidende onderwerpdetails aan en controleer daarna materiaal, anatomie en compositie in de grotere uitvoer. Het resultaat is creatief beeldmateriaal dat door de briefing wordt gestuurd en geen waarneming van een echte scène.\n\nGeneratie accepteert prompts tot 10000 tekens, voorkeurskleuren, een gewenste achtergrondkleur, een willekeurige seed en één tot zes uitvoerafbeeldingen. Optionele stijlreferenties of compatibele opgeslagen stijlen kunnen een terugkerende visuele behandeling geven, met flexible of precise matching. Gebruik samenhangende, duidelijke referenties en specificeer de inhoud in de prompt; exacte kleurovereenkomst met een referentie is niet gegarandeerd. V4.1 sluit negative_prompt, voorgeselecteerde stijlnamen, text_layout, artistic_level en no_text uit; die instellingen mogen dus niet uit oudere edities worden overgenomen. Gebruik voor generatie met een referentiestijl één tot tien PNG-, JPG- of WebP-afbeeldingen, samen maximaal 64 MB en elk kleiner dan 20 MB. Elke referentie vereist een kortste zijde van minimaal 256 pixels, een langste zijde van maximaal 4096 pixels en een resolutie van maximaal 16 megapixels. Gebruik deze referenties óf een compatibele opgeslagen stijl, niet beide.\n\nRecrafts afzonderlijke afbeelding-naar-afbeeldingoperatie ondersteunt de V4.1-familie met een bestaande afbeelding, een prompt en sterkte van 0 tot 1. Deze kan aspecten van de bron behouden en andere veranderen; lagere sterkte blijft dichter bij de bron en hogere sterkte staat meer verandering toe. Die operatie accepteert geen instellingen voor aangepaste V4.1-stijlen. Bereid de bronafbeelding binnen de gedocumenteerde afbeeldingslimieten voor en benoem zowel de gewenste verandering als de eigenschappen die het nieuwe resultaat moeten sturen. Controleer een definitief beeld in de daadwerkelijke compositie, vooral fijne details, letters en uitsnede. Lever voor afbeelding naar afbeelding PNG, JPG, WebP of SVG kleiner dan 20 MB aan, maximaal 16 megapixels, met beide zijden tussen 256 en 4096 pixels.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "f2462a5b321b12a9c8d903d5f66cb60a895c605fcf01517f745d60e1c1a744f4", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nl", "methods": [ { "html": "recraft/recraft-v4.1-proRecraft V4.1 Pro genereert gedetailleerde 2K-rasterafbeeldingen voor expressieve fotografie, illustratie en groter creatief beeldmateriaal. Het combineert het natuurlijke fotorealisme en de interpretatie van korte prompts van V4.1 met optionele stijlreferenties en afbeelding-naar-afbeeldingprocedures.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Recraft V4.1 Pro is de rastereditie met hogere resolutie binnen Recrafts expressieve V4.1-generatiefamilie. De fabrikant benadrukt natuurlijk fotorealisme, bewuste compositie en illustratiestijlen die vanuit een korte creatieve richting kunnen worden ontwikkeld. Pro is bedoeld voor werk waarin fijnere details en een groter rasterresultaat belangrijk zijn, waaronder omvangrijke marketingbeelden en drukwerkgerichte lay-outs. Het verschilt van de eenvoudigere presentatie van Utility Pro en van de bewerkbare SVG-uitvoer van Pro Vector.
Het specifieke model is recraftv4_1_pro. De producentreferentie vermeldt 2K-uitvoer in verliesloos WebP of PNG. Het vierkante formaat is 2048 × 2048 pixels; 16:9 is 2688 × 1536 en 3:4 is 1792 × 2432, terwijl andere toegestane verhoudingen hun eigen afmetingen hebben. Gebruik een beeldverhouding voor de beoogde lay-out of een exact formaat uit de producenttabel. De naam Pro maakt niet elke compositie vierkant en verandert een rasterafbeelding niet in vectorgeometrie.
V4.1 kan een korte aanwijzing interpreteren en daarbij keuzes voor licht, sfeer en compositie maken. Dit is nuttig om een redactionele foto, gestileerde illustratie of ruimtelijk beeld met reflecterende materialen te verkennen. Een gerenderde 3D-look blijft een afbeelding en geen bewerkbare driedimensionale scène. Beschrijf bij een specifieke artdirection onderwerp en scène, kadrering, materiaalgedrag, lichtrichting, achtergrond en visuele hiërarchie, in plaats van te verwachten dat een open prompt elk detail op de gewenste manier oplost.
Vraag voor een redactionele foto om een close-up van een lamp van geborsteld metaal in zacht raamlicht, een warm bewoond interieur en een rustige compositie met ruimte voor een bijschrift. Een meer illustratieve briefing kan brede kleurvlakken, een levendige personagehouding en een ingetogen achtergrond specificeren. Lever het beoogde gebruik en de onderscheidende onderwerpdetails aan en controleer daarna materiaal, anatomie en compositie in de grotere uitvoer. Het resultaat is creatief beeldmateriaal dat door de briefing wordt gestuurd en geen waarneming van een echte scène.
Generatie accepteert prompts tot 10000 tekens, voorkeurskleuren, een gewenste achtergrondkleur, een willekeurige seed en één tot zes uitvoerafbeeldingen. Optionele stijlreferenties of compatibele opgeslagen stijlen kunnen een terugkerende visuele behandeling geven, met flexible of precise matching. Gebruik samenhangende, duidelijke referenties en specificeer de inhoud in de prompt; exacte kleurovereenkomst met een referentie is niet gegarandeerd. V4.1 sluit negative_prompt, voorgeselecteerde stijlnamen, text_layout, artistic_level en no_text uit; die instellingen mogen dus niet uit oudere edities worden overgenomen. Gebruik voor generatie met een referentiestijl één tot tien PNG-, JPG- of WebP-afbeeldingen, samen maximaal 64 MB en elk kleiner dan 20 MB. Elke referentie vereist een kortste zijde van minimaal 256 pixels, een langste zijde van maximaal 4096 pixels en een resolutie van maximaal 16 megapixels. Gebruik deze referenties óf een compatibele opgeslagen stijl, niet beide.
Recrafts afzonderlijke afbeelding-naar-afbeeldingoperatie ondersteunt de V4.1-familie met een bestaande afbeelding, een prompt en sterkte van 0 tot 1. Deze kan aspecten van de bron behouden en andere veranderen; lagere sterkte blijft dichter bij de bron en hogere sterkte staat meer verandering toe. Die operatie accepteert geen instellingen voor aangepaste V4.1-stijlen. Bereid de bronafbeelding binnen de gedocumenteerde afbeeldingslimieten voor en benoem zowel de gewenste verandering als de eigenschappen die het nieuwe resultaat moeten sturen. Controleer een definitief beeld in de daadwerkelijke compositie, vooral fijne details, letters en uitsnede. Lever voor afbeelding naar afbeelding PNG, JPG, WebP of SVG kleiner dan 20 MB aan, maximaal 16 megapixels, met beide zijden tussen 256 en 4096 pixels.
POST /v1/images/generationstext, imageimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten recraft/recraft-v4.1-pro | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 1:1, 4:3, 3:4, 16:9, 9:16, auto | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 6 | Standaard— |
Veldinput_references | Typearray | VereisteOptioneel | Waarden en limieten Minimumaantal items: 0 Maximumaantal items: 1 | Standaard— |
Veldprovider | Typeobject | VereisteOptioneel | Waarden en limieten | Standaard— |
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parametermaterial_types | Contracttext, image |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Rekeneenheid | Kosten |
|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Rekeneenheid— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| Configuratieuitvoerafbeelding | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper uitvoerafbeelding | Kosten Uitvoer · uitvoerafbeelding · Schatting uitsluitend ter vergelijking $0.42 per uitvoerafbeelding |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.42 schatting vóór generatie Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
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-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\nDownload elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
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.\nSla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Bewaar het volledige antwoord en de headers, alle daadwerkelijke uitvoer, de oorspronkelijk geretourneerde identificatoren en alle gebruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Bewaar de geretourneerde X-Client-Request-ID voor reconciliatie. Lees alleen daadwerkelijk geretourneerde task_id/asset_id-waarden of de eigen mediabibliotheek uit; bouw nooit een taak-URL op basis van de bewerkings-ID en dien de aanmaakaanvraag nooit opnieuw in.
| Veld | Type |
|---|---|
Veldcreated | Type |
Velddata[].url | Type |
Velddata[].b64_json | Type |
Veldusage | Type |
Ailoot Ultra recraft/recraft-v4.1-pro
/v1/images