Recraft: Recraft V4.1 Pro
Recraft V4.1 Pro genererer detaljerede rasterbilleder i 2K til udtryksfuld fotografering, illustration og større kreative materialer. Den kombinerer V4.1's naturlige fotorealisme og fortolkning af korte prompts med valgfrie stilreferencer og billede-til-billede-arbejdsgange.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
Recraft V4.1 Pro er rasterudgaven med højere opløsning i Recrafts udtryksfulde V4.1-genereringsfamilie. Producenten fremhæver naturlig fotorealisme, bevidst komposition og illustrationsstilarter, der kan udvikles fra en kort kreativ anvisning. Pro er beregnet til arbejde, hvor finere detaljer og et større rasterresultat betyder noget, herunder større markedsføringsbilleder og layouts til tryk. Den er adskilt fra Utility Pros enklere præsentation og Pro Vectors redigerbare SVG-output.
Den konkrete model er recraftv4_1_pro. Producentens reference angiver 2K-output som tabsfri WebP eller PNG. Den kvadratiske størrelse er 2048 × 2048 pixels; 16:9 er 2688 × 1536, og 3:4 er 1792 × 2432, mens andre tilladte billedformater knyttes til deres egne dimensioner. Brug et billedformat til det ønskede layout eller en præcis størrelse fra producentens tabel. Pro-navnet gør ikke enhver komposition kvadratisk og omdanner ikke et rasterbillede til vektorgeometri.
V4.1 kan fortolke en kort anvisning og samtidig træffe valg om lys, stemning og komposition. Dette er nyttigt til at udforske et redaktionelt fotografi, en stiliseret illustration eller et rumligt billede med reflekterende materialer. Et gengivet 3D-udtryk er stadig et billede frem for en redigerbar tredimensionel scene. Når en specifik visuel retning er nødvendig, skal du beskrive motiv og scene, indramning, materialeadfærd, lysretning, baggrund og visuelt hierarki frem for at forvente, at en åben prompt løser hver detalje som ønsket.
Til et redaktionelt fotografi kan du bede om et nærbillede af en lampe i børstet metal i blødt vindueslys, et varmt, beboet interiør og en rolig komposition med plads til en billedtekst. En mere illustrativ beskrivelse kan angive brede farveflader, en livlig figurpositur og en behersket baggrund. Angiv den ønskede anvendelse og de detaljer, der adskiller motivet, og undersøg derefter det større output for materiale, anatomi og komposition. Resultatet er et kreativt materiale styret af beskrivelsen, ikke en observation af en virkelig scene.
Generering accepterer prompts på op til 10.000 tegn, foretrukne farver, en ønsket baggrundsfarve, et tilfældigt seed og ét til seks output. Valgfrie stilreferencer eller kompatible gemte stilarter kan give en gentagen visuel behandling med fleksibel eller præcis matchning. Brug sammenhængende, tydelige referencer, og angiv indholdet i prompten; præcist farvematch fra en reference er ikke garanteret. V4.1 udelukker negative_prompt, kuraterede stilnavne, text_layout, artistic_level og no_text, så disse kontroller bør ikke overføres fra ældre udgaver. Ved generering med referencestil skal du bruge ét til ti PNG-, JPG- eller WebP-billeder, højst 64 MB i alt og under 20 MB hver. Hver reference skal have en korteste side på mindst 256 pixels, en længste side på højst 4.096 pixels og en opløsning på højst 16 megapixels. Brug enten disse referencer eller en kompatibel gemt stil frem for begge dele.
Recrafts separate billede-til-billede-operation understøtter V4.1-familien med et eksisterende billede, en prompt og en styrke fra 0 til 1. Den kan bevare nogle aspekter af kilden og ændre andre; lavere styrke forbliver tættere på kilden, og højere styrke tillader mere ændring. Denne operation tager ikke brugerdefinerede V4.1-stilkontroller. Forbered kildebilledet inden for de dokumenterede billedgrænser, og angiv både den ønskede ændring og de egenskaber, der skal præge det nye resultat. Ved et færdigt visuelt materiale skal du undersøge output i den faktiske komposition, især fine detaljer, tekst og beskæring. Til billede-til-billede skal du medsende PNG, JPG, WebP eller SVG under 20 MB, højst 16 megapixels og med begge sider mellem 256 og 4.096 pixels.
Ailoot Ultra · Billeder POST /v1/images/generations recraft/recraft-v4.1-pro
recraft/recraft-v4.1-proStart
Recraft V4.1 Pro genererer detaljerede rasterbilleder i 2K til udtryksfuld fotografering, illustration og større kreative materialer. Den kombinerer V4.1's naturlige fotorealisme og fortolkning af korte prompts med valgfrie stilreferencer og billede-til-billede-arbejdsgange.
- Accepterede input
- Tekst · Billeder
- Resultater
- Billeder
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · Billeder POST /v1/images/generations
- Inputtyper
text,image- Outputtyper
image
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser recraft/recraft-v4.1-pro | Standard— |
Feltprompt | Typestring | KravPåkrævet | Værdier og grænser Minimumslængde: 1 | Standard— |
Feltaspect_ratio | Typestring | KravValgfrit | Værdier og grænser 1:1, 4:3, 3:4, 16:9, 9:16, auto | Standard— |
Feltn | Typeinteger | KravValgfrit | Værdier og grænser Minimum: 1 Maksimum: 6 | Standard— |
Feltinput_references | Typearray | KravValgfrit | Værdier og grænser Minimumsantal elementer: 0 Maksimalt antal elementer: 1 | Standard— |
Feltprovider | Typeobject | KravValgfrit | Værdier og grænser | Standard— |
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, prompt |
Parametermaterial_types | Kontrakttext, image |
Livscyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · det faktisk returnerede task_id eller posten i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Sådan beregnes det endelige beløb
De viste satser bruges til at anslå omkostningen før genereringen. Det endelige beløb beregnes ud fra den registrerede omkostning for den oprindelige generering. Den målte varighed af outputtet og de anslåede mængder er ikke den endelige fakturerbare mængde.
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
- Hurtig tilstand
- Ikke angivet Når hurtig tilstand er valgt
- flex-tilstand
- Ikke angivet Når flex-tilstanden er valgt
- Maksimal ræsonneringsindsats
- Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats
Estimerede takster til sammenligning
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Forventet mængde | Afregningsenhed | Beløb |
|---|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Forventet mængde— | Afregningsenhed— | Beløb Input · Inputtokens · Estimat kun til sammenligning — / 1K tokens Output · Outputtokens · Estimat kun til sammenligning — / 1K tokens Input · Cachelæsning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning, 1 time · Estimat kun til sammenligning — / 1K tokens |
| Konfigurationoutputbillede | Takstplan— | Forventet mængde— | Afregningsenhedpr. outputbillede | Beløb Output · outputbillede · Estimat kun til sammenligning $0.42 pr. outputbillede |
| KonfigurationAnslået genereringsomkostning | Takstplan— | Forventet mængdeestimat for én generering | Afregningsenhed— | Beløb Output · Anslået genereringsomkostning · Estimat kun til sammenligning $0.42 estimat før generering Dette estimat er hverken et ekstra gebyr eller en fast pris for den færdige generering. |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
Eksempelanmodninger
Ailoot Ultra · Billeder
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
Hent og gem resultater
Ailoot Ultra · Billeder
Hent hvert returneret billede, eller gem dets Base64-indhold
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Læsning af andet indhold
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.
Behold alle færdige resultater
Gem hvert færdigt billede; hent hver returneret URL eller afkod dets Base64-indhold.
Gem hele svaret og alle headere, alle faktisk returnerede output, de oprindeligt returnerede identifikatorer og alle felter med forbrugsdata. Gendan den oprindelige operation uden at sende oprettelsesanmodningen igen.
Hvis det oprindelige svar skal kontrolleres
Gem det returnerede X-Client-Request-ID til afstemning. Brug kun faktisk returnerede task_id/asset_id-værdier eller dit eget mediebibliotek til læseanmodninger; opbyg aldrig en opgave-URL ud fra operations-ID’et, og send aldrig oprettelsesanmodningen igen.
Svarfelter
| Felt | Type |
|---|---|
Feltcreated | Type |
Feltdata[].url | Type |
Feltdata[].b64_json | Type |
Feltusage | Type |
Aliaser
Modelaliaser
Ailoot Ultra recraft/recraft-v4.1-pro
Aliaser for metodestier
/v1/images
Relaterede kalder-ID’er
FAQ · Recraft: Recraft V4.1 Pro
- Hvilke input og resultater er tilgængelige?
POST /v1/images/generations·recraft/recraft-v4.1-pro:text,image→image- Hvilke felter bruger anmodningen?
POST /v1/images/generations·recraft/recraft-v4.1-pro:model,prompt,aspect_ratio,n,input_references,provider- Hvilke grænser gælder?
POST /v1/images/generations·recraft/recraft-v4.1-pro:n.minimum:1;n.maximum:6