Recraft: Recraft V4.1
Recraft V4.1 ustvarja rastrske slike 1K z naravnim fotorealizmom, izrazno ilustracijo in premišljeno kompozicijo. Lahko razvije kratko ustvarjalno usmeritev ali sledi podrobnemu opisu, z izbirnimi slikovnimi vhodi in slogi po meri.
O modelu
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
Recraft V4.1 je glavni rastrski model v družini Recraft V4.1. Namenjen je izraznemu ustvarjanju slik, vključno z naravnimi fotografijami, ilustracijami in prostorskimi vizualnimi koncepti. Proizvajalec ga predstavlja kot model, ki lahko iz kratkega poziva sam sprejme estetske odločitve, hkrati pa se odziva na podrobnejšo ustvarjalno usmeritev. Uporabite ga za raziskovanje, snovanje konceptov in slike, pri katerih so vzdušje, osvetlitev in kompozicija del rezultata, namesto da bi bile omejene na preprost čelni pogled na izdelek.
Natančna proizvajalčeva oznaka je recraftv4_1. Vrača rastrske slike 1K v formatu WebP brez izgub ali PNG; kvadratni izhod meri 1024 × 1024 slikovnih pik, izhod 16:9 pa 1344 × 768. Druga podprta razmerja uporabljajo svoje dimenzije. V4.1 Pro je ločena rastrska izdaja 2K, Vector vrača SVG, ki ga je mogoče urejati, Utility pa daje prednost preprostejši osvetlitvi in prizorom. Te veje služijo različnim končnim izdelkom, zato njihovih izhodnih lastnosti ne združujte v en sam nabor.
Proizvajalec izpostavlja naravnejše fotografske prizore, mirnejše ozadje, bolj gladke prelive in širok razpon ilustracij. Njegovi primeri vključujejo izrazne napise, ploskovno ilustracijo likov in narisan referenčni list lika. Kratek poziv lahko dopušča modelovo interpretacijo; podroben opis lahko določi motiv, pozo, material, ozadje in kompozicijo. Pri prostorski podobi določite obdelavo površin in osvetlitve, pri tem pa upoštevajte, da je rezultat slika, ne mreža ali projekt 3D, ki bi ga bilo mogoče urejati.
Za koncept bralnega prostora zahtevajte intimno fotografijo majhnega bralnega kotička, toplo dnevno svetlobo, knjige in en keramičen predmet, z naravno, sproščeno postavitvijo namesto razstavnega videza. Nadzorovan ilustracijski opis pa lahko določi grafični motiv, barvna razmerja in obdelavo linij. Navedite predvideno razmerje stranic in najpomembnejše vizualne odločitve. Tako boste lažje presodili, ali je nepričakovana podrobnost uporabna ustvarjalna interpretacija ali nekaj, kar je treba pri naslednjem opisu spremeniti.
Dokumentacija za ustvarjanje dovoljuje pozive do 10.000 znakov, naključno seme, želene barve in želeno barvo ozadja ter od enega do šest izhodov. Izbirne referenčne slike ali združljivi shranjeni slogi lahko vzpostavijo vizualni jezik s prilagodljivim ali natančnim ujemanjem. Za glavno izdajo V4.1 niso obvezni. Izberite jasne reference, ki se med seboj ujemajo, in s pozivom opišite novo vsebino; reprodukcija referenčnih barv ni zagotovljena. Za ustvarjanje po referenčnem slogu uporabite od ene do deset slik PNG, JPG ali WebP, skupaj največ 64 MB in vsako manjšo od 20 MB. Najkrajša stranica vsake reference mora meriti vsaj 256 slikovnih pik, najdaljša največ 4.096 slikovnih pik, ločljivost pa največ 16 milijonov slikovnih pik. Uporabite bodisi te reference bodisi združljiv shranjeni slog, ne obojega.
V4.1 podpira tudi ločen postopek pretvorbe slike v sliko z obstoječo sliko, besedilom in močjo od 0 do 1. Moč določa, kako tesno se nova slika drži izvirnika, postopek pa ne sprejema nastavitev slogov po meri za V4.1. Trenutna dokumentacija modela za ustvarjanje izključuje negative_prompt, predpripravljene sloge, text_layout, artistic_level in no_text. Predvideni prizor opišite neposredno in dobljeno gradivo preglejte v ciljni postavitvi, skupaj s podrobnostmi, izrezom in morebitnimi napisi, preden se odločite, katero vizualno usmeritev boste ohranili. Za pretvorbo slike v sliko pošljite PNG, JPG, WebP ali SVG, manjši od 20 MB, z največ 16 milijoni slikovnih pik in obema stranicama med 256 in 4.096 slikovnimi pikami.
Ailoot Ultra · Slike POST /v1/images/generations recraft/recraft-v4.1
recraft/recraft-v4.1Začetek
Recraft V4.1 ustvarja rastrske slike 1K z naravnim fotorealizmom, izrazno ilustracijo in premišljeno kompozicijo. Lahko razvije kratko ustvarjalno usmeritev ali sledi podrobnemu opisu, z izbirnimi slikovnimi vhodi in slogi po meri.
- Dovoljeni vhodi
- Besedilo · Slike
- Rezultati
- Slike
Na voljo v Ailoot · vhodi in metode
Ailoot Ultra · Slike POST /v1/images/generations
- Vhod
text,image- Izhod
image
| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve recraft/recraft-v4.1 | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Najmanjša dolžina: 1 | Privzeto— |
Poljeaspect_ratio | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 1:1, 4:3, 3:4, 16:9, 9:16, auto | Privzeto— |
Poljen | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Največ: 6 | Privzeto— |
Poljeinput_references | Vrstaarray | ZahtevaIzbirno | Vrednosti in omejitve Najmanjše število elementov: 0 Največ elementov: 1 | Privzeto— |
Poljeprovider | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Parametri in življenjski cikel metode
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, prompt |
Parametermaterial_types | Specifikacijatext, image |
Življenjski cikel: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Dejansko vrnjeni task_id ali zapis v medijski knjižnici
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Cenik
Kako se izračuna končni strošek
Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.
Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.
- Hitri način
- Ni navedeno Ko je izbran hitri način
- Način flex
- Ni navedeno Ko je izbran način flex
- Najvišja raven razmišljanja
- Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)
Ocenjene cene za primerjavo
Cene po nastavitvah
Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.
| Nastavitev | Cenovna lestvica | Predvidena količina | Obračunska enota | Strošek |
|---|---|---|---|---|
| NastavitevOsnovne cene žetonov | Cenovna lestvicaOsnovna cena | Predvidena količina— | Obračunska enota— | Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov |
| Nastavitevizhodna slika | Cenovna lestvica— | Predvidena količina— | Obračunska enotana izhodno sliko | Strošek Izhod · izhodna slika · Ocena samo za primerjavo $0.07 na izhodno sliko |
| NastavitevOcenjeni strošek ustvarjanja | Cenovna lestvica— | Predvidena količinaocena za eno generiranje | Obračunska enota— | Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $0.07 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje. |
Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →
Primeri zahtev
Ailoot Ultra · Slike
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
Prejmi in shrani rezultate
Ailoot Ultra · Slike
Prenesite vsako vrnjeno sliko ali shranite njeno vsebino Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Branje druge vsebine
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.
Ohrani vse dokončane rezultate
Shranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.
Shranite celoten odgovor in glave, vse dejanske izhode, izvirne vrnjene identifikatorje in vsa polja s podatki o porabi. Pridobite podatke izvirne operacije brez ponovnega pošiljanja zahteve za ustvarjanje.
Če je treba preveriti izvirni odgovor
Shranite vrnjeni X-Client-Request-ID za uskladitev evidenc. Berite samo dejansko vrnjene vrednosti task_id/asset_id ali svojo medijsko knjižnico; iz ID operacije nikoli ne sestavite URL opravila in zahteve za ustvarjanje nikoli ne pošljite znova.
Polja odgovora
| Polje | Vrsta |
|---|---|
Poljecreated | Vrsta |
Poljedata[].url | Vrsta |
Poljedata[].b64_json | Vrsta |
Poljeusage | Vrsta |
Druga imena
Druga imena modelov
Ailoot Ultra recraft/recraft-v4.1
Druga imena poti metod
/v1/images
Povezani ID-ji za klic
FAQ · Recraft: Recraft V4.1
- Kateri vhodi in rezultati so na voljo?
POST /v1/images/generations·recraft/recraft-v4.1:text,image→image- Katera polja uporablja zahteva?
POST /v1/images/generations·recraft/recraft-v4.1:model,prompt,aspect_ratio,n,input_references,provider- Katere omejitve veljajo?
POST /v1/images/generations·recraft/recraft-v4.1:n.minimum:1;n.maximum:6