{ "aboutHtml": "

Recraft V4.1 Flash je Recraftov model za pretvorbo besedila v sliko, namenjen hitremu iteriranju in obsežnemu vizualnemu delu. Proizvajalec med njegova močna področja uvršča fotografijo, portrete, vzdušje, kompleksne prizore, mešane tehnike in zamisli za logotipe. Pisni opis postane rastrska slika, ki jo lahko primerjate z drugimi ustvarjalnimi usmeritvami, preden razvijete končno gradivo. Flash je določen član družine V4.1 s svojo izhodno velikostjo in podprtimi nastavitvami.

Izvirni izhod spada v Recraftov razred rastrskih slik 1K. Platno izberite glede na predvideno mesto uporabe: vodoravno ilustracijo za glavo strani, navpičen portret ali kvadratno podobo za manjšo kartico. Izhodna formata sta WebP brez izgub in PNG.

Opis začnite z glavnim motivom in vizualnim namenom, nato opišite kadriranje, okolje, osvetlitev in tehniko. Za koncept izdelka je uporabno navodilo: »Majhen radio kremne barve na orehovi mizi, pogled od spredaj pod kotom treh četrtin, mehka svetloba okna, umirjena uredniška fotografija, veliko praznega prostora na levi.« Pri ilustraciji določite jezik oblik, paleto in razmerja med elementi. Izrecno navedite podrobnosti, ki opredeljujejo idejo, namesto da dodajate nepovezane pridevnike. Dokumentirana dovoljena dolžina poziva za Flash je do 10.000 znakov, zato lahko po potrebi prizor opišete podrobno.

Proizvajalčeve nastavitve vključujejo želene barve in želeno barvo ozadja. Za ponovljivost rezultatov lahko podate seme, vmesnik za ustvarjanje pa dokumentira od ene do šest slik v zahtevi. Te nastavitve podpirajo uporabno primerjanje: motiv in kompozicijo ohranite enaka, spremenite eno vizualno usmeritev in dobljene slike preglejte glede na predvideno postavitev. Barvne želje opisujejo zahtevani rezultat; pomembne barve blagovne znamke primerjajte s končnim gradivom, preden ga združite z obstoječim oblikovnim sistemom.

Flash ustvarja rastrsko grafiko. Zamisel za logotip lahko pomaga izbrati silhueto, vzdušje ali razporeditev, medtem ko poti, ki jih je mogoče urejati, pripadajo ločeno poimenovanim modelom Vector. Flash tudi nima različice Pro. Celotna linija V4.1 ponuja te ločene možnosti, kadar sta vektorsko urejanje ali višja ločljivost ključna za končni izdelek. Proizvajalec opisuje poznejši korak dodelave, ki izbrani osnutek pripelje bližje podrobnejši sliki; ta korak je ločen postopek in ne druga izvirna izhodna velikost modela Flash.

Ta izdaja ne podpira slikovnega vhoda za pretvorbo slike v sliko, slogov po meri, identifikatorjev slogov, slogovnega ujemanja ali referenčnih slik za slog. Dokumentirani vmesnik prav tako ne vključuje negativnih pozivov in izrecnih nastavitev postavitve besedila. Želeni videz in kompozicijo vključite v pozitivni opis. Če koncept vsebuje napise, navedite želeno besedilo v narekovajih in preverite upodobljene črke; kadar sta natančna tipografija in postavitev ključni, uporabite ločen korak postavitve.

Praktični rezultat modela Flash je izbrana vizualna usmeritev z jasnim opisom, ustreznim razmerjem stranic in uporabno rastrsko datoteko. Motiv, kadriranje, ozadje in pomembne podrobnosti primerjajte pri velikosti, v kateri bo slika prikazana. Uspešni poziv in izbrano datoteko hranite skupaj, da bo naslednji ustvarjalni korak sledil izbrani usmeritvi. Hitro iteriranje pomaga raziskovati oblikovanje; izvirni vektorski izhod, ujemanje z referenčnim slogom in ločljivost druge izdaje V4.1 ostajajo ločene možnosti izbire modela.

", "aboutText": "Recraft V4.1 Flash je Recraftov model za pretvorbo besedila v sliko, namenjen hitremu iteriranju in obsežnemu vizualnemu delu. Proizvajalec med njegova močna področja uvršča fotografijo, portrete, vzdušje, kompleksne prizore, mešane tehnike in zamisli za logotipe. Pisni opis postane rastrska slika, ki jo lahko primerjate z drugimi ustvarjalnimi usmeritvami, preden razvijete končno gradivo. Flash je določen član družine V4.1 s svojo izhodno velikostjo in podprtimi nastavitvami.\n\nIzvirni izhod spada v Recraftov razred rastrskih slik 1K. Platno izberite glede na predvideno mesto uporabe: vodoravno ilustracijo za glavo strani, navpičen portret ali kvadratno podobo za manjšo kartico. Izhodna formata sta WebP brez izgub in PNG.\n\nOpis začnite z glavnim motivom in vizualnim namenom, nato opišite kadriranje, okolje, osvetlitev in tehniko. Za koncept izdelka je uporabno navodilo: »Majhen radio kremne barve na orehovi mizi, pogled od spredaj pod kotom treh četrtin, mehka svetloba okna, umirjena uredniška fotografija, veliko praznega prostora na levi.« Pri ilustraciji določite jezik oblik, paleto in razmerja med elementi. Izrecno navedite podrobnosti, ki opredeljujejo idejo, namesto da dodajate nepovezane pridevnike. Dokumentirana dovoljena dolžina poziva za Flash je do 10.000 znakov, zato lahko po potrebi prizor opišete podrobno.\n\nProizvajalčeve nastavitve vključujejo želene barve in želeno barvo ozadja. Za ponovljivost rezultatov lahko podate seme, vmesnik za ustvarjanje pa dokumentira od ene do šest slik v zahtevi. Te nastavitve podpirajo uporabno primerjanje: motiv in kompozicijo ohranite enaka, spremenite eno vizualno usmeritev in dobljene slike preglejte glede na predvideno postavitev. Barvne želje opisujejo zahtevani rezultat; pomembne barve blagovne znamke primerjajte s končnim gradivom, preden ga združite z obstoječim oblikovnim sistemom.\n\nFlash ustvarja rastrsko grafiko. Zamisel za logotip lahko pomaga izbrati silhueto, vzdušje ali razporeditev, medtem ko poti, ki jih je mogoče urejati, pripadajo ločeno poimenovanim modelom Vector. Flash tudi nima različice Pro. Celotna linija V4.1 ponuja te ločene možnosti, kadar sta vektorsko urejanje ali višja ločljivost ključna za končni izdelek. Proizvajalec opisuje poznejši korak dodelave, ki izbrani osnutek pripelje bližje podrobnejši sliki; ta korak je ločen postopek in ne druga izvirna izhodna velikost modela Flash.\n\nTa izdaja ne podpira slikovnega vhoda za pretvorbo slike v sliko, slogov po meri, identifikatorjev slogov, slogovnega ujemanja ali referenčnih slik za slog. Dokumentirani vmesnik prav tako ne vključuje negativnih pozivov in izrecnih nastavitev postavitve besedila. Želeni videz in kompozicijo vključite v pozitivni opis. Če koncept vsebuje napise, navedite želeno besedilo v narekovajih in preverite upodobljene črke; kadar sta natančna tipografija in postavitev ključni, uporabite ločen korak postavitve.\n\nPraktični rezultat modela Flash je izbrana vizualna usmeritev z jasnim opisom, ustreznim razmerjem stranic in uporabno rastrsko datoteko. Motiv, kadriranje, ozadje in pomembne podrobnosti primerjajte pri velikosti, v kateri bo slika prikazana. Uspešni poziv in izbrano datoteko hranite skupaj, da bo naslednji ustvarjalni korak sledil izbrani usmeritvi. Hitro iteriranje pomaga raziskovati oblikovanje; izvirni vektorski izhod, ujemanje z referenčnim slogom in ločljivost druge izdaje V4.1 ostajajo ločene možnosti izbire modela.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "a966c846dfd03edc50cd33cb2ba3739dd55afbadffa0ed565926b14e1c0488f0", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sl", "methods": [ { "html": "

•

Recraft: Recraft V4.1 Flash

Recraft /recraft/recraft-v4.1-flash

Začetek

Recraft V4.1 Flash iz besedila ustvarja rastrske slike 1K za hitro vizualno iteriranje. Podpira fotografijo, portrete, kompleksne prizore in zamisli za logotipe, z izhodom PNG ali WebP brez izgub ter izrecno določenimi barvnimi željami.

Dovoljeni vhodi: Besedilo
Rezultati: Slike

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 Flash je Recraftov model za pretvorbo besedila v sliko, namenjen hitremu iteriranju in obsežnemu vizualnemu delu. Proizvajalec med njegova močna področja uvršča fotografijo, portrete, vzdušje, kompleksne prizore, mešane tehnike in zamisli za logotipe. Pisni opis postane rastrska slika, ki jo lahko primerjate z drugimi ustvarjalnimi usmeritvami, preden razvijete končno gradivo. Flash je določen član družine V4.1 s svojo izhodno velikostjo in podprtimi nastavitvami.

Izvirni izhod spada v Recraftov razred rastrskih slik 1K. Platno izberite glede na predvideno mesto uporabe: vodoravno ilustracijo za glavo strani, navpičen portret ali kvadratno podobo za manjšo kartico. Izhodna formata sta WebP brez izgub in PNG.

Opis začnite z glavnim motivom in vizualnim namenom, nato opišite kadriranje, okolje, osvetlitev in tehniko. Za koncept izdelka je uporabno navodilo: »Majhen radio kremne barve na orehovi mizi, pogled od spredaj pod kotom treh četrtin, mehka svetloba okna, umirjena uredniška fotografija, veliko praznega prostora na levi.« Pri ilustraciji določite jezik oblik, paleto in razmerja med elementi. Izrecno navedite podrobnosti, ki opredeljujejo idejo, namesto da dodajate nepovezane pridevnike. Dokumentirana dovoljena dolžina poziva za Flash je do 10.000 znakov, zato lahko po potrebi prizor opišete podrobno.

Proizvajalčeve nastavitve vključujejo želene barve in želeno barvo ozadja. Za ponovljivost rezultatov lahko podate seme, vmesnik za ustvarjanje pa dokumentira od ene do šest slik v zahtevi. Te nastavitve podpirajo uporabno primerjanje: motiv in kompozicijo ohranite enaka, spremenite eno vizualno usmeritev in dobljene slike preglejte glede na predvideno postavitev. Barvne želje opisujejo zahtevani rezultat; pomembne barve blagovne znamke primerjajte s končnim gradivom, preden ga združite z obstoječim oblikovnim sistemom.

Flash ustvarja rastrsko grafiko. Zamisel za logotip lahko pomaga izbrati silhueto, vzdušje ali razporeditev, medtem ko poti, ki jih je mogoče urejati, pripadajo ločeno poimenovanim modelom Vector. Flash tudi nima različice Pro. Celotna linija V4.1 ponuja te ločene možnosti, kadar sta vektorsko urejanje ali višja ločljivost ključna za končni izdelek. Proizvajalec opisuje poznejši korak dodelave, ki izbrani osnutek pripelje bližje podrobnejši sliki; ta korak je ločen postopek in ne druga izvirna izhodna velikost modela Flash.

Ta izdaja ne podpira slikovnega vhoda za pretvorbo slike v sliko, slogov po meri, identifikatorjev slogov, slogovnega ujemanja ali referenčnih slik za slog. Dokumentirani vmesnik prav tako ne vključuje negativnih pozivov in izrecnih nastavitev postavitve besedila. Želeni videz in kompozicijo vključite v pozitivni opis. Če koncept vsebuje napise, navedite želeno besedilo v narekovajih in preverite upodobljene črke; kadar sta natančna tipografija in postavitev ključni, uporabite ločen korak postavitve.

Praktični rezultat modela Flash je izbrana vizualna usmeritev z jasnim opisom, ustreznim razmerjem stranic in uporabno rastrsko datoteko. Motiv, kadriranje, ozadje in pomembne podrobnosti primerjajte pri velikosti, v kateri bo slika prikazana. Uspešni poziv in izbrano datoteko hranite skupaj, da bo naslednji ustvarjalni korak sledil izbrani usmeritvi. Hitro iteriranje pomaga raziskovati oblikovanje; izvirni vektorski izhod, ujemanje z referenčnim slogom in ločljivost druge izdaje V4.1 ostajajo ločene možnosti izbire modela.

Na voljo v Ailoot · vhodi in metode

Ailoot Ultra · Slike POST /v1/images/generations

Vhod: text
Izhod: image
Izhodni format: Slikovna datoteka
Število izhodov: 1 izhod

Polje	Vrsta	Zahteva	Vrednosti in omejitve	Privzeto
Polje`model`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve recraft/recraft-v4.1-flash	Privzeto—
Polje`prompt`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve Najmanjša dolžina: 1 Pogoji: Neprazen poziv UTF8. Splošne omejitve števila znakov za vse modele proizvajalca ne določamo.	Privzeto—
Polje`n`	Vrsta`integer`	ZahtevaIzbirno	Vrednosti in omejitve 1	Privzeto1
Polje`response_format`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve url, b64_json	Privzeto—
Polje`stream`	Vrsta`boolean`	ZahtevaIzbirno	Vrednosti in omejitve false	Privzetofalse

Kombinacije vhodnih gradiv

Iz besedila v sliko · Obvezno: prompt

Parametri in življenjski cikel metode

Parameter	Specifikacija
Parameter`content_type`	Specifikacijaapplication/json
Parameter`required`	Specifikacijamodel, prompt
Parameter`material_types`	Specifikacijatext
Parameter`optional`	Specifikacijan, response_format, stream
Parameter`n`	Specifikacija1
Parameter`stream`	Specifikacijafalse
Parameter`response_format`	Specifikacijaurl, b64_json
Parameter`reference_images`	Specifikacijafalse
Parameter`edit`	Specifikacijafalse
Parameter`output_format_optional`	Specifikacija
Parameter`resolution_control`	Specifikacijanull
Parameter`aspect_ratio_control`	Specifikacijanull
Parameter`other_fields`	Specifikacijazavrnjeno, razen za natančno pripeto notranje usmerjanje ponudnika

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

Ustvarite eno sliko iz poziva.

Shranite vsak element data; url/b64_json sta kodiranji rezultatov.

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
NastavitevUltra	Cenovna lestvica—	Predvidena količina—	Obračunska enotana izhodno sliko	Strošek Izhod · izhod slike · Ocena samo za primerjavo $0.014 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.014 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 →

Podrobnosti referenčne tarife

Referenčne lestvice modela ne spreminjajo izbire metode, ocen cen ali stroškov. Veljavni stroški uporabljajo cene izbrane metode Ailoot.

Konfiguracije cen slik

Cene po nastavitvah

Nastavitev	Obračunski pogoji	Strošek
NastavitevIzhodna slika	Obračunski pogojiRazličica cen ni deklarirana.	Strošek Izhod · Izhodna slika $0.014 na sliko Enakovredne navedbe opisujejo isti zaračunani znesek; ne dodajajo druge pristojbine.

Primeri zahtev

Ailoot Ultra · Slike

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "recraft/recraft-v4.1-flash", "prompt": "A lighthouse on a cliff, watercolor", "n": 1, "response_format": "b64_json"}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n    if not items: raise SystemExit("No completed images; retain the full response")\n    for index, item in enumerate(items):\n        encoded=item.get("b64_json")\n        uri=item.get("url", "")\n        if not encoded and uri.startswith("data:image/"):\n            header, separator, encoded=uri.partition(",")\n            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n        if encoded:\n            raw=base64.b64decode(encoded,validate=True)\n        elif uri:\n            uri=urljoin("https://api.ailoot.ai",uri)\n            parsed=urlsplit(uri)\n            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n                raise SystemExit("Invalid returned image URL")\n            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n            args=["curl","--fail-with-body","--silent","--show-error",uri]\n            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n            temporary=Path(f"image-{index}.bin")\n            subprocess.run(args+["-o",str(temporary)],check=True)\n            raw=temporary.read_bytes()\n            temporary.unlink()\n        else: raise SystemExit("Image has neither bytes nor URL")\n        if not raw: raise SystemExit("Empty image result")\n        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"\n        Path(f"image-{index}.{ext}").write_bytes(raw)\n    print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\n

from openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n    if not items: raise SystemExit("No completed images; retain the full response")\n    for index, item in enumerate(items):\n        encoded=item.get("b64_json")\n        uri=item.get("url", "")\n        if not encoded and uri.startswith("data:image/"):\n            header, separator, encoded=uri.partition(",")\n            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n        if encoded:\n            raw=base64.b64decode(encoded,validate=True)\n        elif uri:\n            uri=urljoin("https://api.ailoot.ai",uri)\n            parsed=urlsplit(uri)\n            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n                raise SystemExit("Invalid returned image URL")\n            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n            args=["curl","--fail-with-body","--silent","--show-error",uri]\n            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n            temporary=Path(f"image-{index}.bin")\n            subprocess.run(args+["-o",str(temporary)],check=True)\n            raw=temporary.read_bytes()\n            temporary.unlink()\n        else: raise SystemExit("Image has neither bytes nor URL")\n        if not raw: raise SystemExit("Empty image result")\n        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"\n        Path(f"image-{index}.{ext}").write_bytes(raw)\n    print("Every returned image saved; complete response metadata retained")\n\nrequest={'model': 'recraft/recraft-v4.1-flash', 'prompt': 'A lighthouse on a cliff, watercolor', 'n': 1, 'response_format': 'b64_json'}\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\n

import OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "recraft/recraft-v4.1-flash", "prompt": "A lighthouse on a cliff, watercolor", "n": 1, "response_format": "b64_json"};\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n  const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n  if(!encoded && uri.startsWith("data:image/")) {\n    const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n    encoded=uri.slice(comma+1);\n  }\n  if(encoded) {\n    if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n    raw=Buffer.from(encoded,"base64");\n  } else if(uri) {\n    const u=new URL(uri,"https://api.ailoot.ai");\n    if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n    const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n    const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n    if(!response.ok) throw new Error("Image content download failed: "+response.status);\n    raw=Buffer.from(await response.arrayBuffer());\n  } else throw new Error("Image has neither bytes nor URL");\n  if(!raw.length) throw new Error("Empty image result");\n  const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n  writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\n

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

Ohrani vse dokončane rezultate

Shranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.

Shranite vsak podatkovni element. Dekodirajte vsak b64_json ali pridobite vsebino z vsakega vrnjenega podpisanega URL. Končnico imena datoteke izberite glede na dejanski tip MIME oziroma bajte.

Če je treba preveriti izvirni odgovor

Če je treba preveriti rezultat generiranja ali urejanja slike, shranite izvirni operation_id/X-Client-Request-ID in vrnjene podatke o rezultatu. Obstoječe rezultate, ki vam pripadajo, pridobite prek medijske knjižnice z dejanskimi vrednostmi task_id ali asset_id. Zahteve za generiranje/urejanje ne pošiljajte znova in iz operation_id ne sestavljajte URL za periodično preverjanje stanja.

Polja odgovora

Polje	Vrsta
Polje`created`	Vrstainteger
Polje`data[].url`	Vrstastring
Polje`data[].b64_json`	Vrstabase64 string
Polje`usage`	Vrstaobject

Napake in naslednji koraki

Odgovor	Pogoj	Naslednji korak
Odgovor400 · `invalid_request_error`	PogojNeveljavna obvezna polja, predstavitev gradiva ali vrednost parametra	Naslednji korakPred novo zahtevo za ustvarjanje popravite navedena polja.
Odgovor`server_error`	PogojVrnjeni odgovor navaja, da je treba operacijo ali rezultat preveriti	Naslednji korakShranite izvirni vrnjeni ID operacije/opravila, glave zahteve in odgovor; nadaljujte s podprtimi branji te izvirne operacije. Zahteve za ustvarjanje ne pošiljajte znova.

Druga imena

Druga imena modelov

Ailoot Ultra recraft/recraft-v4.1-flash

Druga imena poti metod

Uporabite zgoraj navedene poti metod.

Povezani ID-ji za klic

recraft/recraft-v4.1-flash

", "method_identity": { "effective_request_model_id": "recraft/recraft-v4.1-flash", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "recraft/recraft-v4.1-flash", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|recraft%2Frecraft-v4.1-flash", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Save every data item. Decode each b64_json or fetch every returned signed URL. Select a filename extension from the actual MIME/bytes.", "errors": [ { "code": null, "condition": "Neveljavna obvezna polja, predstavitev gradiva ali vrednost parametra", "http_status": 400, "recovery": "Pred novo zahtevo za ustvarjanje popravite navedena polja.", "type": "invalid_request_error" }, { "code": null, "condition": "Vrnjeni odgovor navaja, da je treba operacijo ali rezultat preveriti", "http_status": null, "recovery": "Shranite izvirni vrnjeni ID operacije/opravila, glave zahteve in odgovor; nadaljujte s podprtimi branji te izvirne operacije. Zahteve za ustvarjanje ne pošiljajte znova.", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Če je treba preveriti rezultat generiranja ali urejanja slike, shranite izvirni operation_id/X-Client-Request-ID in vrnjene podatke o rezultatu. Obstoječe rezultate, ki vam pripadajo, pridobite prek medijske knjižnice z dejanskimi vrednostmi task_id ali asset_id. Zahteve za generiranje/urejanje ne pošiljajte znova in iz operation_id ne sestavljajte URL za periodično preverjanje stanja." }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_image", "reference_images": false, "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_image" ], "outputs": { "all_results": "Shranite vsak podatkovni element. Dekodirajte vsak b64_json ali pridobite vsebino z vsakega vrnjenega podpisanega URL. Končnico imena datoteke izberite glede na dejanski tip MIME oziroma bajte.", "count": 1, "family": "image", "fields": [ { "description": null, "name": "created", "type": "integer" }, { "description": null, "name": "data[].url", "type": "string" }, { "description": null, "name": "data[].b64_json", "type": "base64 string" }, { "description": null, "name": "usage", "type": "object" } ], "format": "actual validated raster MIME" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "recraft/recraft-v4.1-flash" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "conditions": "Neprazen poziv UTF8. Splošne omejitve števila znakov za vse modele proizvajalca ne določamo.", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": [ 1 ], "enum_known": true, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "url", "b64_json" ], "enum_known": true, "name": "response_format", "required": false, "type": "string" }, { "availability": "source_interface", "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "image edits/references", "resolution/size", "aspect_ratio", "stream=true", "n other than1", "other fields outside this exact facade profile", "output_format field must be omitted" ] }, "hints": [ "Ustvarite eno sliko iz poziva.", "Shranite vsak element data; url/b64_json sta kodiranji rezultatov." ], "input": { "aspect_ratio_control": null, "content_type": "application/json", "edit": false, "material_types": [ "text" ], "n": [ 1 ], "optional": [ "n", "response_format", "stream" ], "other_fields": "zavrnjeno, razen za natančno pripeto notranje usmerjanje ponudnika", "output_format_optional": [], "reference_images": false, "required": [ "model", "prompt" ], "resolution_control": null, "response_format": [ "url", "b64_json" ], "stream": [ false ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "Dejansko vrnjeni task_id ali zapis v medijski knjižnici", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "If an image generation or edit result requires a check, keep the original operation_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task_id or asset_id values. Do not resubmit the generation/edit request or construct a polling URL from operation_id." }, "manufacturer_capability": null, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "operation_modes": [ "text_to_image" ], "output": { "count": 1, "family": "image", "format": "validated raster MIME", "result": "actual owned URL or b64_json" } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per image output" }, "label": "Ultra", "units": [ { "amount": "0.014", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "image output", "native_amount_usd_per_unit": "0.014", "native_quantity": 1, "public_unit_label": "per image output", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Ocenjeni strošek ustvarjanja", "units": [ { "amount": "0.014", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.014", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{\"model\": \"recraft/recraft-v4.1-flash\", \"prompt\": \"A lighthouse on a cliff, watercolor\", \"n\": 1, \"response_format\": \"b64_json\"}')\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit(\"No completed images; retain the full response\")\n for index, item in enumerate(items):\n encoded=item.get(\"b64_json\")\n uri=item.get(\"url\", \"\")\n if not encoded and uri.startswith(\"data:image/\"):\n header, separator, encoded=uri.partition(\",\")\n if not separator or \";base64\" not in header: raise SystemExit(\"Unsupported image data URI\")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin(\"https://api.ailoot.ai\",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!=\"https\" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit(\"Invalid returned image URL\")\n owned=parsed.netloc==\"api.ailoot.ai\" and parsed.path.startswith(\"/v1/media/assets/\") and parsed.path.endswith(\"/content\")\n args=[\"curl\",\"--fail-with-body\",\"--silent\",\"--show-error\",uri]\n if owned: args += [\"-H\",\"Authorization: Bearer \"+os.environ[\"AILOOT_API_KEY\"]]\n temporary=Path(f\"image-{index}.bin\")\n subprocess.run(args+[\"-o\",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit(\"Image has neither bytes nor URL\")\n if not raw: raise SystemExit(\"Empty image result\")\n 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\"