Recraft: Recraft V4.1 Pro
Recraft 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.
Over het model
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.
Ailoot Ultra · Afbeeldingen POST /v1/images/generations recraft/recraft-v4.1-pro
recraft/recraft-v4.1-proAan de slag
Recraft 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.
- Toegestane invoer
- Tekst · Afbeeldingen
- Resultaten
- Afbeeldingen
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Afbeeldingen POST /v1/images/generations
- Invoer
text,image- Uitvoer
image
| 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— |
Methodeparameters en levenscyclus
| 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}
Tarieven
Zo worden de uiteindelijke kosten berekend
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.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus geselecteerd is
- Flex-modus
- Niet opgegeven Wanneer de flex-modus geselecteerd is
- Maximale redeneerinspanning
- Niet opgegeven Wanneer voor maximale redeneerinspanning de default-aanpassing wordt gebruikt
Geschatte tarieven ter vergelijking
Prijzen per configuratie
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 →
Voorbeeldverzoeken
Ailoot Ultra · Afbeeldingen
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'recraft/recraft-v4.1-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
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"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
Resultaten ophalen en opslaan
Ailoot Ultra · Afbeeldingen
Download 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}
Lezen van andere inhoud
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Alle voltooide resultaten bewaren
Sla 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.
Als het oorspronkelijke antwoord moet worden gecontroleerd
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.
Antwoordvelden
| Veld | Type |
|---|---|
Veldcreated | Type |
Velddata[].url | Type |
Velddata[].b64_json | Type |
Veldusage | Type |
Aliasnamen
Modelaliasnamen
Ailoot Ultra recraft/recraft-v4.1-pro
Aliasnamen voor methodepaden
/v1/images
Gerelateerde aanroeper-ID’s
FAQ · Recraft: Recraft V4.1 Pro
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/images/generations·recraft/recraft-v4.1-pro:text,image→image- Welke velden gebruikt het verzoek?
POST /v1/images/generations·recraft/recraft-v4.1-pro:model,prompt,aspect_ratio,n,input_references,provider- Welke limieten gelden?
POST /v1/images/generations·recraft/recraft-v4.1-pro:n.minimum:1;n.maximum:6