Recraft: Recraft V4 Styles
Recraft V4 Styles genereert 1K-rasterafbeeldingen in een visuele stijl die door referenties is bepaald. Het is ontworpen voor dagelijks merk- en campagnewerk waarbij elk nieuw onderwerp dezelfde weergave, textuur en algemene uitstraling moet behouden.
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 is de standaardrastereditie van de specifieke stijlvast genererende familie van Recraft. Het maakt een nieuw beeld vanuit een tekstprompt en volgt daarbij een stijl die door referentiemateriaal is vastgelegd. Het model is nuttig voor reeksen illustraties, banners of productscènes die een herkenbare visuele uitwerking moeten delen. De referentie draagt weergave, textuur en kleurlogica; de prompt introduceert onderwerp en scène voor elk nieuw beeld.
De producent vermeldt 1K-rasteruitvoer in verliesvrije WebP of PNG. Het vierkante formaat is 1024 × 1024 pixels en het gedocumenteerde 16:9-formaat is 1344 × 768; staande en andere ondersteunde verhoudingen gebruiken eigen formaten. Deze editie verschilt van de 2K-rasteruitvoer van Styles Pro en van de Vector-modellen die SVG produceren. Kies de beeldverhouding voor de uiteindelijke lay-out in plaats van te verwachten dat het label 1K voor elk beeld dezelfde breedte en hoogte betekent.
Een stijl is verplicht. Gebruik één tot tien PNG-, JPG- of WebP-referenties of een compatibele stijl die bij eerdere stijlcreatie is opgeslagen. De gedocumenteerde workflow accepteert geen opgeslagen stijlidentificatie en nieuwe referenties samen. Referenties mogen bestaand merk- of campagnemateriaal zijn in plaats van beelden die oorspronkelijk door Recraft zijn gegenereerd. Ze moeten kleiner dan 20 MB per bestand zijn en samen maximaal 64 MB. Er is geen afzonderlijke trainingstaak door de gebruiker nodig voordat je de stijl kan gebruiken. 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.
Begin met één sterke referentie of meerdere referenties die al dezelfde visuele taal delen. Consistente referenties helpen de stijl op meer dan één object of houding toe te passen; een ongerelateerd moodboard kan concurrerende motieven introduceren. Flexibele matching is de standaard en laat meer interpretatieruimte; precieze matching volgt weergave, palet, compositie en belichting van de referentie nauwer. Exacte kleurreproductie blijft niet gegarandeerd.
Beschrijf voor een bannerreeks een koerier die een pakje op een drempel plaatst, een rustige horizontale compositie en open ruimte aan één kant voor latere tekst. Volgende briefings kunnen de gebeurtenis of camerahoek veranderen met behoud van dezelfde stijl. De producent staat prompts tot 10.000 tekens, voorkeurskleuren, een gewenste achtergrondkleur, een willekeurige seed en één tot zes afbeeldingen toe. Het ondersteunt geen negative_prompt, namen van gecureerde stijlen of text_layout, dus beschrijf onderwerp en lay-out rechtstreeks in de briefing.
De Styles-lijn biedt geen afbeelding-naar-afbeelding of inpainting. Een stijlreferentie stuurt een nieuw gegenereerd beeld in plaats van het behoud van referentieobjecten of -pixels te garanderen. Herzie houding, actie, kadrering of scènedetails als de set repetitief oogt, in plaats van een tegenstrijdige referentie toe te voegen. Beoordeel elk resultaat in de bedoelde lay-out op helderheid van het onderwerp, bruikbare ruimte en samenhangende weergave en behoud daarna dezelfde compatibele stijl voor het volgende beeld. Dat maakt het model praktisch voor een herhaalbare visuele taal met veranderende inhoud.
Ailoot Ultra · Afbeeldingen POST /v1/images/generations recraft/recraft-v4-styles
recraft/recraft-v4-stylesAan de slag
Recraft V4 Styles genereert 1K-rasterafbeeldingen in een visuele stijl die door referenties is bepaald. Het is ontworpen voor dagelijks merk- en campagnewerk waarbij elk nieuw onderwerp dezelfde weergave, textuur en algemene uitstraling moet behouden.
- 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-styles | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldaspect_ratio | Typestring | 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— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 6 | Standaard— |
Veldinput_references | Typearray | VereisteOptioneel | Waarden en limieten Minimumaantal items: 1 Maximumaantal items: 10 | 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 | 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.07 per uitvoerafbeelding |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Factureringsvoorwaarden— | 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-styles', '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-styles
Aliasnamen voor methodepaden
/v1/images
Gerelateerde aanroeper-ID’s
FAQ · Recraft: Recraft V4 Styles
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/images/generations·recraft/recraft-v4-styles:text,image→image- Welke velden gebruikt het verzoek?
POST /v1/images/generations·recraft/recraft-v4-styles:model,prompt,aspect_ratio,n,input_references,provider- Welke limieten gelden?
POST /v1/images/generations·recraft/recraft-v4-styles:n.minimum:1;n.maximum:6