Recraft V4.1 Pro is de rastereditie met hogere resolutie van de expressieve V4.1-generatiefamilie van Recraft. De fabrikant benadrukt natuurlijk fotorealisme, doordachte compositie en illustratiestijlen die vanuit een korte creatieve richting kunnen worden ontwikkeld. Pro is bedoeld voor werk waarbij fijner detail en een groter rasterresultaat tellen, zoals omvangrijke marketingbeelden en drukwerkgerichte lay-outs. Het staat los van de eenvoudiger presentatie van Utility Pro en de bewerkbare SVG-uitvoer van Pro Vector.
Het specifieke model is recraftv4_1_pro. De producentendocumentatie vermeldt 2K-uitvoer in verliesvrije WebP of PNG. Het vierkante formaat is 2048 × 2048 pixels; 16:9 is 2688 × 1536 en 3:4 is 1792 × 2432, met andere toegestane verhoudingen gekoppeld aan eigen afmetingen. Gebruik een beeldverhouding voor de bedoelde lay-out of een exact formaat uit de tabel van de producent. 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 leveren. Dat is nuttig om een redactionele foto, gestileerde illustratie of ruimtelijk beeld met reflecterende materialen te verkennen. Een gerenderde 3D-uitstraling blijft een afbeelding, 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 zoals bedoeld oplost.
Vraag voor een redactionele foto een close-up van een lamp van geborsteld metaal in zacht raamlicht, een warm doorleefd 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. Geef het bedoelde gebruik en de onderscheidende onderwerpsdetails op en controleer daarna de grotere uitvoer op materiaal, anatomie en compositie. Het resultaat is een door de briefing gestuurd creatief beeld, geen waarneming van een echte scène.
Generatie accepteert prompts tot 10.000 tekens, voorkeurskleuren, een gewenste achtergrondkleur, een willekeurige seed en één tot zes afbeeldingen. Optionele stijlreferenties of compatibele opgeslagen stijlen kunnen een herhaalde visuele uitwerking leveren, met flexibele of precieze matching. Gebruik samenhangende, duidelijke referenties en specificeer de inhoud in de prompt; exacte kleurmatching vanuit een referentie is niet gegarandeerd. V4.1 sluit negative_prompt, namen van gecureerde stijlen, text_layout, artistic_level en no_text uit, dus neem die instellingen niet over uit oudere edities. Gebruik voor generatie met stijlreferenties één tot tien PNG-, JPG- of WebP-afbeeldingen, samen maximaal 64 MB en elk kleiner dan 20 MB. Elke referentie moet een korte zijde van minstens 256 pixels, een lange zijde van maximaal 4.096 pixels en een resolutie van maximaal 16 megapixels hebben. Gebruik die referenties of een compatibele opgeslagen stijl, niet beide.
De afzonderlijke afbeelding-naar-afbeeldingbewerking van Recraft ondersteunt de V4.1-familie met een bestaand beeld, een prompt en sterkte van 0 tot 1. Ze kan aspecten van de bron behouden en andere wijzigen; lagere sterkte blijft dichterbij en hogere sterkte laat meer verandering toe. Die bewerking accepteert geen instellingen voor aangepaste V4.1-stijlen. Bereid het bronbeeld binnen de gedocumenteerde beeldlimieten voor en benoem zowel de gewenste wijziging als de kenmerken die richting moeten geven aan het nieuwe resultaat. Controleer voor een eindbeeld de uitvoer in de daadwerkelijke compositie, vooral fijne details, letters en uitsnede. Lever voor afbeelding-naar-afbeelding PNG, JPG, WebP of SVG aan, kleiner dan 20 MB, maximaal 16 megapixels, met beide zijden tussen 256 en 4.096 pixels.
", "aboutText": "Recraft V4.1 Pro is de rastereditie met hogere resolutie van de expressieve V4.1-generatiefamilie van Recraft. De fabrikant benadrukt natuurlijk fotorealisme, doordachte compositie en illustratiestijlen die vanuit een korte creatieve richting kunnen worden ontwikkeld. Pro is bedoeld voor werk waarbij fijner detail en een groter rasterresultaat tellen, zoals omvangrijke marketingbeelden en drukwerkgerichte lay-outs. Het staat los van de eenvoudiger presentatie van Utility Pro en de bewerkbare SVG-uitvoer van Pro Vector.\n\nHet specifieke model is recraftv4_1_pro. De producentendocumentatie vermeldt 2K-uitvoer in verliesvrije WebP of PNG. Het vierkante formaat is 2048 × 2048 pixels; 16:9 is 2688 × 1536 en 3:4 is 1792 × 2432, met andere toegestane verhoudingen gekoppeld aan eigen afmetingen. Gebruik een beeldverhouding voor de bedoelde lay-out of een exact formaat uit de tabel van de producent. 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 leveren. Dat is nuttig om een redactionele foto, gestileerde illustratie of ruimtelijk beeld met reflecterende materialen te verkennen. Een gerenderde 3D-uitstraling blijft een afbeelding, 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 zoals bedoeld oplost.\n\nVraag voor een redactionele foto een close-up van een lamp van geborsteld metaal in zacht raamlicht, een warm doorleefd 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. Geef het bedoelde gebruik en de onderscheidende onderwerpsdetails op en controleer daarna de grotere uitvoer op materiaal, anatomie en compositie. Het resultaat is een door de briefing gestuurd creatief beeld, geen waarneming van een echte scène.\n\nGeneratie accepteert prompts tot 10.000 tekens, voorkeurskleuren, een gewenste achtergrondkleur, een willekeurige seed en één tot zes afbeeldingen. Optionele stijlreferenties of compatibele opgeslagen stijlen kunnen een herhaalde visuele uitwerking leveren, met flexibele of precieze matching. Gebruik samenhangende, duidelijke referenties en specificeer de inhoud in de prompt; exacte kleurmatching vanuit een referentie is niet gegarandeerd. V4.1 sluit negative_prompt, namen van gecureerde stijlen, text_layout, artistic_level en no_text uit, dus neem die instellingen niet over uit oudere edities. Gebruik voor generatie met stijlreferenties één tot tien PNG-, JPG- of WebP-afbeeldingen, samen maximaal 64 MB en elk kleiner dan 20 MB. Elke referentie moet een korte zijde van minstens 256 pixels, een lange zijde van maximaal 4.096 pixels en een resolutie van maximaal 16 megapixels hebben. Gebruik die referenties of een compatibele opgeslagen stijl, niet beide.\n\nDe afzonderlijke afbeelding-naar-afbeeldingbewerking van Recraft ondersteunt de V4.1-familie met een bestaand beeld, een prompt en sterkte van 0 tot 1. Ze kan aspecten van de bron behouden en andere wijzigen; lagere sterkte blijft dichterbij en hogere sterkte laat meer verandering toe. Die bewerking accepteert geen instellingen voor aangepaste V4.1-stijlen. Bereid het bronbeeld binnen de gedocumenteerde beeldlimieten voor en benoem zowel de gewenste wijziging als de kenmerken die richting moeten geven aan het nieuwe resultaat. Controleer voor een eindbeeld de uitvoer in de daadwerkelijke compositie, vooral fijne details, letters en uitsnede. Lever voor afbeelding-naar-afbeelding PNG, JPG, WebP of SVG aan, kleiner dan 20 MB, maximaal 16 megapixels, met beide zijden tussen 256 en 4.096 pixels.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "0469d2c0892c9fdd995cd615b2d0503fa922bf20dd69d1d0f2f94f2f247d0459", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nl-be", "methods": [ { "html": "recraft/recraft-v4.1-proRecraft V4.1 Pro genereert gedetailleerde 2K-rasterafbeeldingen voor expressieve fotografie, illustratie en grotere creatieve beelden. Het combineert het natuurlijke fotorealisme en de interpretatie van korte prompts van V4.1 met optionele stijlreferenties en afbeelding-naar-afbeeldingworkflows.
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 van de expressieve V4.1-generatiefamilie van Recraft. De fabrikant benadrukt natuurlijk fotorealisme, doordachte compositie en illustratiestijlen die vanuit een korte creatieve richting kunnen worden ontwikkeld. Pro is bedoeld voor werk waarbij fijner detail en een groter rasterresultaat tellen, zoals omvangrijke marketingbeelden en drukwerkgerichte lay-outs. Het staat los van de eenvoudiger presentatie van Utility Pro en de bewerkbare SVG-uitvoer van Pro Vector.
Het specifieke model is recraftv4_1_pro. De producentendocumentatie vermeldt 2K-uitvoer in verliesvrije WebP of PNG. Het vierkante formaat is 2048 × 2048 pixels; 16:9 is 2688 × 1536 en 3:4 is 1792 × 2432, met andere toegestane verhoudingen gekoppeld aan eigen afmetingen. Gebruik een beeldverhouding voor de bedoelde lay-out of een exact formaat uit de tabel van de producent. 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 leveren. Dat is nuttig om een redactionele foto, gestileerde illustratie of ruimtelijk beeld met reflecterende materialen te verkennen. Een gerenderde 3D-uitstraling blijft een afbeelding, 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 zoals bedoeld oplost.
Vraag voor een redactionele foto een close-up van een lamp van geborsteld metaal in zacht raamlicht, een warm doorleefd 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. Geef het bedoelde gebruik en de onderscheidende onderwerpsdetails op en controleer daarna de grotere uitvoer op materiaal, anatomie en compositie. Het resultaat is een door de briefing gestuurd creatief beeld, geen waarneming van een echte scène.
Generatie accepteert prompts tot 10.000 tekens, voorkeurskleuren, een gewenste achtergrondkleur, een willekeurige seed en één tot zes afbeeldingen. Optionele stijlreferenties of compatibele opgeslagen stijlen kunnen een herhaalde visuele uitwerking leveren, met flexibele of precieze matching. Gebruik samenhangende, duidelijke referenties en specificeer de inhoud in de prompt; exacte kleurmatching vanuit een referentie is niet gegarandeerd. V4.1 sluit negative_prompt, namen van gecureerde stijlen, text_layout, artistic_level en no_text uit, dus neem die instellingen niet over uit oudere edities. Gebruik voor generatie met stijlreferenties één tot tien PNG-, JPG- of WebP-afbeeldingen, samen maximaal 64 MB en elk kleiner dan 20 MB. Elke referentie moet een korte zijde van minstens 256 pixels, een lange zijde van maximaal 4.096 pixels en een resolutie van maximaal 16 megapixels hebben. Gebruik die referenties of een compatibele opgeslagen stijl, niet beide.
De afzonderlijke afbeelding-naar-afbeeldingbewerking van Recraft ondersteunt de V4.1-familie met een bestaand beeld, een prompt en sterkte van 0 tot 1. Ze kan aspecten van de bron behouden en andere wijzigen; lagere sterkte blijft dichterbij en hogere sterkte laat meer verandering toe. Die bewerking accepteert geen instellingen voor aangepaste V4.1-stijlen. Bereid het bronbeeld binnen de gedocumenteerde beeldlimieten voor en benoem zowel de gewenste wijziging als de kenmerken die richting moeten geven aan het nieuwe resultaat. Controleer voor een eindbeeld de uitvoer in de daadwerkelijke compositie, vooral fijne details, letters en uitsnede. Lever voor afbeelding-naar-afbeelding PNG, JPG, WebP of SVG aan, kleiner dan 20 MB, maximaal 16 megapixels, met beide zijden tussen 256 en 4.096 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} · daadwerkelijk teruggegeven task_id of record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
De getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen 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 raming is geen extra kost 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 de volledige respons en headers, iedere daadwerkelijke uitvoer, de oorspronkelijk teruggegeven identificatoren en alle verbruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Bewaar de teruggegeven X-Client-Request-ID voor de reconciliatie. Lees uitsluitend daadwerkelijk teruggegeven 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