Recraft: Recraft V4 Styles Pro

Recraft V4 Styles Pro genereert 2K-rasterafbeeldingen in een visuele stijl die door referenties wordt bepaald. Het is ontworpen voor gedetailleerde campagnebeelden en afbeeldingssets waarvan textuur, weergave, palet en totale uitstraling consistent moeten blijven terwijl het onderwerp verandert.

Ailoot Ultra · Afbeeldingen POST /v1/images/generations recraft/recraft-v4-styles-pro

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 Styles Pro is het rastermodel met hogere resolutie in Recrafts speciale V4 Styles-familie. Het maakt een nieuwe afbeelding vanuit een tekstbriefing en een visuele stijl die via referentieafbeeldingen of een opgeslagen stijl wordt aangeleverd. Het model is bedoeld voor campagnes, merkillustratie en andere afbeeldingssets waarin weergave, textuur en compositiekarakter van het ene beeld naar het volgende moeten doorwerken. Het staat los van Recraft V4 Pro en V4.1 Pro, waarbij stijlinvoer optioneel is in plaats van de bepalende modelvereiste.

Styles Pro produceert 2K-rasteruitvoer in verliesloos WebP of PNG. Een vierkante uitvoer in de formaattabel van de producent is 2048 × 2048 pixels, terwijl 16:9-uitvoer 2688 × 1536 is; andere ondersteunde verhoudingen hebben eigen afmetingen. De grotere Pro-uitvoer kan nuttig zijn voor gedetailleerde campagnebeelden en grotere lay-outs. De vectorvarianten produceren daarentegen SVG en hebben geen vaste pixelafmeting; kies deze raster-Pro-editie dus niet wanneer het gewenste resultaat een bewerkbaar vectorbestand is.

Elke generatie in de Styles-familie vereist een stijl. Lever één tot tien PNG-, JPG- of WebP-referentieafbeeldingen aan of hergebruik een compatibele opgeslagen stijl; een stijl-ID en nieuwe referenties zijn alternatieve invoeren en geen combinatie. De producentprocedure staat samen maximaal 64 MB aan referenties toe, met elk bestand kleiner dan 20 MB. Stijlcreatie vereist geen door de gebruiker uitgevoerde trainingsstap. Eén duidelijke referentie kan een samenhangende richting bepalen en meerdere referenties helpen wanneer ze al dezelfde visuele taal delen in plaats van concurrerende stijlen. Elke referentie moet een kortste zijde van minimaal 256 pixels, een langste zijde van maximaal 4096 pixels en een totale resolutie van maximaal 16 megapixels hebben.

Flexible style matching is standaard en staat een vrijere referentie-interpretatie toe. Precise matching volgt weergave, palet, compositie en belichting nauwer. De referentie bepaalt de visuele taal; de tekstbriefing moet nog steeds het nieuwe onderwerp, de handeling, scène en kadrering beschrijven. Specificeer voor een gedetailleerde productcampagne een glazen fles op een licht stenen oppervlak, een driekwarthoek, zacht zijlicht en duidelijke ruimte voor een kop, terwijl de aangeleverde referentie de fotografische behandeling draagt.

Het model accepteert prompts tot 10000 tekens, ondersteunt voorkeurskleuren en een gewenste achtergrondkleur en kan een willekeurige seed gebruiken. De gedocumenteerde generatieprocedure kan één tot zes afbeeldingen retourneren. De bruikbare instellingen verschillen van oudere Recraft-edities: voorgeselecteerde stijlnamen, negative_prompt en text_layout worden niet ondersteund en de Styles-familie biedt geen afbeelding naar afbeelding of inpainting. Een referentie is een stijlbron en geen masker of instructie om een bestaande foto pixel voor pixel te behouden.

Bereid duidelijke referentiebeelden met voldoende detail voor en hergebruik dezelfde stijl bij het ontwikkelen van een set. Verander onderwerp, houding, camerahoek of scène in de tekstbriefing wanneer uitvoer zich gaat herhalen, in plaats van een ongerelateerde referentie toe te voegen. Een exacte kleurovereenkomst tussen referentie en uitvoer is niet gegarandeerd; voorkeurskleurinstellingen drukken een richting uit en geen kleurproefresultaat. Beoordeel het definitieve campagnebeeld op het beoogde weergave- of drukformaat en controleer of onderwerp, bruikbare lege ruimte en visuele behandeling bij de briefing passen.

Ailoot Ultra · Afbeeldingen POST /v1/images/generations recraft/recraft-v4-styles-pro

recraft/recraft-v4-styles-pro

Recraft /recraft/recraft-v4-styles-pro

Aan de slag

Toegestane invoer: Tekst · Afbeeldingen
Resultaten: Afbeeldingen

Beschikbaar in Ailoot · invoer en methoden

Ailoot Ultra · Afbeeldingen POST /v1/images/generations

Invoertypen: text, image
Uitvoertypen: image

Veld	Type	Vereiste	Waarden en limieten	Standaard
Veld`model`	Type`string`	VereisteVereist	Waarden en limieten recraft/recraft-v4-styles-pro	Standaard—
Veld`prompt`	Type`string`	VereisteVereist	Waarden en limieten Minimumlengte: 1	Standaard—
Veld`aspect_ratio`	Type`string`	VereisteOptioneel	Waarden en limieten 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto	Standaard—
Veld`n`	Type`integer`	VereisteOptioneel	Waarden en limieten Minimum: 1 Maximum: 6	Standaard—
Veld`input_references`	Type`array`	VereisteOptioneel	Waarden en limieten Minimumaantal items: 1 Maximumaantal items: 10	Standaard—
Veld`provider`	Type`object`	VereisteOptioneel	Waarden en limieten	Standaard—

Methodeparameters en levenscyclus

Parameter	Contract
Parameter`content_type`	Contractapplication/json
Parameter`required`	Contractmodel, prompt
Parameter`material_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}

Tarieven

Zo worden de uiteindelijke kosten berekend

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.

Snelle modus: Niet opgegeven Wanneer de snelle modus is geselecteerd
Flexmodus: Niet opgegeven Wanneer de modus flex is geselecteerd
Maximale redeneerinspanning: Niet opgegeven Wanneer bij 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	Factureringsvoorwaarden	Kosten
ConfiguratieBasistarieven voor tokens	TariefstaffelBasistarief	Verwachte hoeveelheid—	Rekeneenheid—	Factureringsvoorwaarden—	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
ConfiguratieInvoerreferentie	Tariefstaffel—	Verwachte hoeveelheid—	Rekeneenheidper verzoek	FactureringsvoorwaardenStijlcreatie bij genereren met stijlreferenties; eenmaal per verzoek, boven op de prijs voor uitvoerafbeeldingen.	Kosten Invoer · Invoerreferentie · Schatting uitsluitend ter vergelijking $0.01 per verzoek
Configuratieuitvoerafbeelding	Tariefstaffel—	Verwachte hoeveelheid—	Rekeneenheidper uitvoerafbeelding	Factureringsvoorwaarden—	Kosten Uitvoer · uitvoerafbeelding · Schatting uitsluitend ter vergelijking $0.2 per uitvoerafbeelding
ConfiguratieGeschatte generatiekosten	Tariefstaffel—	Verwachte hoeveelheidschatting voor één generatie	Rekeneenheid—	Factureringsvoorwaarden—	Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.2 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 →

Voorbeeldverzoeken

Ailoot Ultra · Afbeeldingen

curl

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-styles-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}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Lezen van andere inhoud

Bestaande eigen bestanden ophalen

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 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.

Als het oorspronkelijke antwoord moet worden gecontroleerd

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.

Antwoordvelden

Veld	Type
Veld`created`	Type
Veld`data[].url`	Type
Veld`data[].b64_json`	Type
Veld`usage`	Type

Aliasnamen

Modelaliasnamen

Ailoot Ultra recraft/recraft-v4-styles-pro

Aliasnamen voor methodepaden

/v1/images

Gerelateerde aanroeper-ID’s

recraft/recraft-v4-styles-pro

FAQ · Recraft: Recraft V4 Styles Pro

Welke invoer en resultaten zijn beschikbaar?: POST /v1/images/generations · recraft/recraft-v4-styles-pro: text, image → image
Welke velden gebruikt het verzoek?: POST /v1/images/generations · recraft/recraft-v4-styles-pro: model, prompt, aspect_ratio, n, input_references, provider
Welke limieten gelden?: POST /v1/images/generations · recraft/recraft-v4-styles-pro: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4 Styles Pro