Recraft: Recraft V4 Styles Pro

Recraft V4 Styles Pro genereert 2K-rasterafbeeldingen in een visuele stijl die door referenties is bepaald. Het is ontworpen voor gedetailleerd campagnemateriaal en beeldsets waarvan textuur, weergave, palet en algemene 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 de specifieke V4 Styles-familie van Recraft. Het maakt een nieuw beeld vanuit een tekstbriefing en een visuele stijl die via referentiebeelden of een opgeslagen stijl wordt aangeleverd. Het model is bedoeld voor campagnes, merkillustratie en andere beeldsets waarbij weergave, textuur en compositiekarakter van het ene beeld naar het volgende moeten doorlopen. 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 verliesvrije WebP of PNG. Een vierkante uitvoer in de formaattabel van de producent is 2048 × 2048 pixels en een 16:9-uitvoer is 2688 × 1536; andere ondersteunde verhoudingen hebben eigen afmetingen. De grotere uitvoer van Pro kan nuttig zijn voor gedetailleerde campagnebeelden en grotere lay-outs. De vectorvarianten produceren daarentegen SVG en hebben geen vaste pixelgrootte, dus kies deze Pro-rastereditie niet wanneer de bedoelde levering een bewerkbaar vectorbestand is.

Elke generatie in de Styles-familie vereist een stijl. Lever één tot tien PNG-, JPG- of WebP-referentiebeelden aan of hergebruik een compatibele opgeslagen stijl; een stijlidentificatie en nieuwe referenties zijn alternatieve invoeren, geen paar om te combineren. De producentenworkflow staat maximaal 64 MB aan referenties toe, met elk bestand kleiner dan 20 MB. Stijlcreatie vereist geen trainingsstap door de gebruiker. Eén duidelijke referentie kan een samenhangende richting vastleggen; meerdere referenties helpen wanneer ze al dezelfde visuele taal delen in plaats van concurrerende stijlen. Elke referentie moet een korte zijde van minstens 256 pixels, een lange zijde van maximaal 4.096 pixels en een totale resolutie van maximaal 16 megapixels hebben.

Flexibele stijlmatching is de standaard en laat een vrijere interpretatie van de referentie toe. Precieze matching volgt weergave, palet, compositie en belichting nauwer. De referentie bepaalt de visuele taal; de tekstbriefing moet nog steeds nieuw onderwerp, actie, scène en kadrering beschrijven. Specificeer voor een gedetailleerde productcampagne een glazen fles op een bleek stenen oppervlak, een driekwartaanzicht, zacht zijlicht en vrije ruimte voor een kop, terwijl de aangeleverde referentie de fotografische uitwerking draagt.

Het model accepteert prompts tot 10.000 tekens, ondersteunt voorkeurskleuren en een gewenste achtergrondkleur en kan een willekeurige seed gebruiken. De gedocumenteerde generatieworkflow kan één tot zes afbeeldingen teruggeven. De bruikbare bediening verschilt van oudere Recraft-edities: namen van gecureerde stijlen, negative_prompt en text_layout worden niet ondersteund en de Styles-familie biedt geen afbeelding-naar-afbeelding of inpainting. Een referentie is een stijlbron, geen masker of opdracht om een bestaande foto pixel voor pixel te behouden.

Bereid duidelijke, voldoende gedetailleerde referenties voor en hergebruik dezelfde stijl bij de ontwikkeling van een set. Als uitvoer repetitief wordt, verander onderwerp, houding, camerahoek of scène in de tekstbriefing in plaats van een ongerelateerde referentie toe te voegen. Exacte kleurmatching tussen referentie en uitvoer is niet gegarandeerd; instellingen voor voorkeurskleuren drukken een richting uit, geen kleurproefresultaat. Beoordeel het uiteindelijke campagnebeeld op de bedoelde weergave- of drukgrootte en controleer of onderwerp, bruikbare lege ruimte en visuele uitwerking 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

Invoer: text, image
Uitvoer: 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} · 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	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	FactureringsvoorwaardenAanmaak van een stijl bij generatie met stijlreferenties; eenmaal per aanvraag, bovenop de prijs van de uitvoerafbeelding.	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 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

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