Recraft: Recraft V4.1
Recraft V4.1 maakt 1K-rasterafbeeldingen met natuurlijk fotorealisme, expressieve illustratie en doordachte compositie. Het kan een korte creatieve richting ontwikkelen of een gedetailleerde briefing volgen, met optionele beeld- en aangepaste stijlinvoer.
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 is het hoofdrastermodel in de V4.1-familie van Recraft. Het is gebouwd voor expressieve beeldcreatie, waaronder natuurlijk ogende foto's, illustratie en ruimtelijke visuele concepten. De fabrikant presenteert het als een model dat esthetische keuzes kan leveren vanuit een korte prompt en tegelijk op gedetailleerdere creatieve richting reageert. Gebruik het voor verkenning, conceptontwikkeling en beelden waarin sfeer, belichting en compositie deel van het resultaat vormen, in plaats van tot een eenvoudig frontaal productaanzicht te worden teruggebracht.
De specifieke producentencode is recraftv4_1. Het geeft 1K-rasterafbeeldingen terug in verliesvrije WebP of PNG, met vierkante uitvoer van 1024 × 1024 pixels en 16:9 van 1344 × 768. Andere ondersteunde verhoudingen gebruiken eigen afmetingen. V4.1 Pro is de afzonderlijke 2K-rastereditie, Vector geeft bewerkbare SVG terug en Utility geeft de voorkeur aan eenvoudigere belichting en scènes. Die takken dienen verschillende leveringen en mogen niet tot één set uitvoereigenschappen worden samengevoegd.
De fabrikant benadrukt natuurlijkere fotografische scènes, een rustigere achtergrond, vloeiendere kleurverlopen en een breed illustratiebereik. De voorbeelden omvatten expressieve letters, vlakke personage-illustratie en een getekend personagereferentieblad. Een korte prompt kan ruimte laten voor modelinterpretatie; een gedetailleerde briefing kan onderwerp, houding, materiaal, achtergrond en compositie vastleggen. Specificeer voor een ruimtelijk beeld de oppervlakte- en lichtuitwerking en onthou dat het resultaat een afbeelding is, geen mesh of bewerkbaar 3D-project.
Vraag voor een leesruimteconcept een intieme foto van een kleine leeshoek, warm daglicht, boeken en één keramisch object, met een ontspannen opstelling in plaats van een showroomuitstraling. Een gecontroleerde illustratiebriefing kan in plaats daarvan het grafische onderwerp, kleurrelaties en lijnuitwerking benoemen. Geef de gewenste beeldverhouding en de belangrijkste visuele keuzes aan. Zo wordt het eenvoudiger om te beslissen of een onverwacht detail nuttige creatieve interpretatie is of iets dat in de volgende briefing moet veranderen.
De generatiedocumentatie staat prompts tot 10.000 tekens, een willekeurige seed, voorkeurskleuren en een gewenste achtergrondkleur toe, met één tot zes afbeeldingen. Optionele referentiebeelden of compatibele opgeslagen stijlen kunnen een visuele taal vastleggen met flexibele of precieze matching. Ze zijn niet verplicht voor de hoofdeditie V4.1. Kies duidelijke referenties die onderling overeenkomen en gebruik de prompt voor de nieuwe inhoud; kleurreproductie uit referenties is niet gegarandeerd. 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.
V4.1 ondersteunt ook een afzonderlijke afbeelding-naar-afbeeldingworkflow met een bestaand beeld, tekst en sterkte van 0 tot 1. De bewerking gebruikt sterkte om te bepalen hoe dicht het nieuwe beeld bij de bron blijft en accepteert geen instellingen voor aangepaste V4.1-stijlen. De huidige generatiedocumentatie van het model sluit negative_prompt, gecureerde stijlen, text_layout, artistic_level en no_text uit. Beschrijf de bedoelde scène rechtstreeks en controleer het resulterende beeld in de doellay-out, inclusief details, uitsnede en letters, voordat je kiest welke visuele richting je behoudt. 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
recraft/recraft-v4.1Aan de slag
Recraft V4.1 maakt 1K-rasterafbeeldingen met natuurlijk fotorealisme, expressieve illustratie en doordachte compositie. Het kan een korte creatieve richting ontwikkelen of een gedetailleerde briefing volgen, met optionele beeld- en aangepaste stijlinvoer.
- 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 | 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.07 per uitvoerafbeelding |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.07 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', '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
Aliasnamen voor methodepaden
/v1/images
Gerelateerde aanroeper-ID’s
FAQ · Recraft: Recraft V4.1
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/images/generations·recraft/recraft-v4.1:text,image→image- Welke velden gebruikt het verzoek?
POST /v1/images/generations·recraft/recraft-v4.1:model,prompt,aspect_ratio,n,input_references,provider- Welke limieten gelden?
POST /v1/images/generations·recraft/recraft-v4.1:n.minimum:1;n.maximum:6