Recraft V4 Pro is het rastermodel met hogere resolutie in de V4-familie van Recraft. V4 richt zich op visueel beoordelingsvermogen, evenwichtige compositie, samenhangende kleuren en zorgvuldige interpretatie van creatieve richting. De producent positioneert Pro voor fijnere details, realistischere complexe scènes en omvangrijke productiebeelden. Gebruik het voor een gedetailleerde illustratie, redactioneel beeld, posterconcept of ander materiaal dat baat heeft bij een groter rasterresultaat. Het blijft onderscheiden van het latere V4.1-model en van de SVG-uitvoer van V4 Pro Vector.
De specifieke producentencode is recraftv4_pro. De gedocumenteerde uitvoer is 2K-raster in verliesvrije WebP of PNG: 2048 × 2048 pixels voor vierkant, 2688 × 1536 voor 16:9 en 1664 × 2560 voor 2:3. Andere ondersteunde verhoudingen hebben eigen afmetingen. Kies een beeldverhouding voor de bedoelde lay-out of een exact toegestaan formaat; een willekeurig pixelformaat maakt geen deel uit van het gedocumenteerde generatiecontract. Standaard V4 heeft kleinere 1K-rasteruitvoer, terwijl vectormodellen geen vaste pixelresolutie hebben.
V4 kan een korte prompt voor verkenning of een gestructureerde prompt voor een gecontroleerd resultaat interpreteren. Voor een specifieke artdirection gaat de fabrikantengids van onderwerp en omgeving naar kadrering, kenmerken, ruimtelijke relaties, belichting, diepte en sfeer. Vraag voor een redactioneel productbeeld een dramatische verticale foto van een sculpturale stoel, oppervlakken van geborsteld metaal, zijlicht, een rustige donkere achtergrond en ruimte boven het object voor een titel. Die relaties benoemen maakt de bedoelde compositie duidelijker dan een algemeen verzoek om een hoogwaardig beeld.
Het creatieve bereik van de familie omvat verhalende illustratie, fotorealistische scènes en ruimtelijke beelden met materiaal- en lichtaanwijzingen. Een 3D-ogend resultaat blijft een afbeelding, geen bewerkbare 3D-scène. Specificeer voor een grafische poster de visuele lagen en hun interactie: achtergrond, illustratie of foto, kophiërarchie en ondersteunende tekst. V4 is gepositioneerd voor leesbare korte en middellange zinnen, maar controleer spelling en hiërarchie van het eindresultaat in plaats van ze uit de modelnaam af te leiden.
De huidige generatiedocumentatie staat prompts tot 10.000 tekens, één tot zes afbeeldingen, een willekeurige seed en instellingen voor voorkeurskleuren en achtergrondkleur toe. Optionele aangepaste stijlen of compatibele referentiebeelden kunnen het uiterlijk sturen met flexibele of precieze matching. Het model accepteert de oudere V3-instellingen negative_prompt, gecureerde stijlen, text_layout, artistic_level en no_text niet. Beschrijf het gewenste eindbeeld in de positieve prompt en hou vereisten voor onderwerp, lay-out en kleur expliciet. Gebruik voor generatie met stijlreferenties één tot tien PNG-, JPG- of WebP-afbeeldingen, samen maximaal 64 MB en elk kleiner dan 20 MB. Elke referentie moet een korte zijde van minstens 256 pixels, een lange zijde van maximaal 4.096 pixels en een resolutie van maximaal 16 megapixels hebben. Gebruik die referenties of een compatibele opgeslagen stijl, niet beide.
Recraft documenteert een afzonderlijke afbeelding-naar-afbeeldingbewerking voor V4. Die combineert een bestaand beeld en een prompt met sterkte van 0 tot 1 om de mate van verandering te sturen en accepteert daarin geen instellingen voor aangepaste V4-stijlen. Bereid de bron binnen de beeldinvoerlimieten van de producent voor en geef aan welke kenmerken in het nieuwe resultaat moeten doorwerken. Controleer voor een groter eindbeeld fijne details, uitsnede en letters op de bedoelde grootte. Het extra rasterdetail van Pro ondersteunt die controle, terwijl het beeld een gegenereerde interpretatie van de aangeleverde creatieve briefing blijft. Lever voor afbeelding-naar-afbeelding PNG, JPG, WebP of SVG aan, kleiner dan 20 MB, maximaal 16 megapixels, met beide zijden tussen 256 en 4.096 pixels.
", "aboutText": "Recraft V4 Pro is het rastermodel met hogere resolutie in de V4-familie van Recraft. V4 richt zich op visueel beoordelingsvermogen, evenwichtige compositie, samenhangende kleuren en zorgvuldige interpretatie van creatieve richting. De producent positioneert Pro voor fijnere details, realistischere complexe scènes en omvangrijke productiebeelden. Gebruik het voor een gedetailleerde illustratie, redactioneel beeld, posterconcept of ander materiaal dat baat heeft bij een groter rasterresultaat. Het blijft onderscheiden van het latere V4.1-model en van de SVG-uitvoer van V4 Pro Vector.\n\nDe specifieke producentencode is recraftv4_pro. De gedocumenteerde uitvoer is 2K-raster in verliesvrije WebP of PNG: 2048 × 2048 pixels voor vierkant, 2688 × 1536 voor 16:9 en 1664 × 2560 voor 2:3. Andere ondersteunde verhoudingen hebben eigen afmetingen. Kies een beeldverhouding voor de bedoelde lay-out of een exact toegestaan formaat; een willekeurig pixelformaat maakt geen deel uit van het gedocumenteerde generatiecontract. Standaard V4 heeft kleinere 1K-rasteruitvoer, terwijl vectormodellen geen vaste pixelresolutie hebben.\n\nV4 kan een korte prompt voor verkenning of een gestructureerde prompt voor een gecontroleerd resultaat interpreteren. Voor een specifieke artdirection gaat de fabrikantengids van onderwerp en omgeving naar kadrering, kenmerken, ruimtelijke relaties, belichting, diepte en sfeer. Vraag voor een redactioneel productbeeld een dramatische verticale foto van een sculpturale stoel, oppervlakken van geborsteld metaal, zijlicht, een rustige donkere achtergrond en ruimte boven het object voor een titel. Die relaties benoemen maakt de bedoelde compositie duidelijker dan een algemeen verzoek om een hoogwaardig beeld.\n\nHet creatieve bereik van de familie omvat verhalende illustratie, fotorealistische scènes en ruimtelijke beelden met materiaal- en lichtaanwijzingen. Een 3D-ogend resultaat blijft een afbeelding, geen bewerkbare 3D-scène. Specificeer voor een grafische poster de visuele lagen en hun interactie: achtergrond, illustratie of foto, kophiërarchie en ondersteunende tekst. V4 is gepositioneerd voor leesbare korte en middellange zinnen, maar controleer spelling en hiërarchie van het eindresultaat in plaats van ze uit de modelnaam af te leiden.\n\nDe huidige generatiedocumentatie staat prompts tot 10.000 tekens, één tot zes afbeeldingen, een willekeurige seed en instellingen voor voorkeurskleuren en achtergrondkleur toe. Optionele aangepaste stijlen of compatibele referentiebeelden kunnen het uiterlijk sturen met flexibele of precieze matching. Het model accepteert de oudere V3-instellingen negative_prompt, gecureerde stijlen, text_layout, artistic_level en no_text niet. Beschrijf het gewenste eindbeeld in de positieve prompt en hou vereisten voor onderwerp, lay-out en kleur expliciet. Gebruik voor generatie met stijlreferenties één tot tien PNG-, JPG- of WebP-afbeeldingen, samen maximaal 64 MB en elk kleiner dan 20 MB. Elke referentie moet een korte zijde van minstens 256 pixels, een lange zijde van maximaal 4.096 pixels en een resolutie van maximaal 16 megapixels hebben. Gebruik die referenties of een compatibele opgeslagen stijl, niet beide.\n\nRecraft documenteert een afzonderlijke afbeelding-naar-afbeeldingbewerking voor V4. Die combineert een bestaand beeld en een prompt met sterkte van 0 tot 1 om de mate van verandering te sturen en accepteert daarin geen instellingen voor aangepaste V4-stijlen. Bereid de bron binnen de beeldinvoerlimieten van de producent voor en geef aan welke kenmerken in het nieuwe resultaat moeten doorwerken. Controleer voor een groter eindbeeld fijne details, uitsnede en letters op de bedoelde grootte. Het extra rasterdetail van Pro ondersteunt die controle, terwijl het beeld een gegenereerde interpretatie van de aangeleverde creatieve briefing blijft. Lever voor afbeelding-naar-afbeelding PNG, JPG, WebP of SVG aan, kleiner dan 20 MB, maximaal 16 megapixels, met beide zijden tussen 256 en 4.096 pixels.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "014753fcefd925058adfbb26220b37f406adda94c79b2df44e7c9877459bb671", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nl-be", "methods": [ { "html": "recraft/recraft-v4-proRecraft V4 Pro genereert 2K-rasterafbeeldingen voor gedetailleerde composities, fotorealisme, illustratie en drukwerkgericht creatief werk. Het is de V4-editie met hogere resolutie, met tekstbriefings, optionele stijlinvoer en een afzonderlijke afbeelding-naar-afbeeldingworkflow.
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 Pro is het rastermodel met hogere resolutie in de V4-familie van Recraft. V4 richt zich op visueel beoordelingsvermogen, evenwichtige compositie, samenhangende kleuren en zorgvuldige interpretatie van creatieve richting. De producent positioneert Pro voor fijnere details, realistischere complexe scènes en omvangrijke productiebeelden. Gebruik het voor een gedetailleerde illustratie, redactioneel beeld, posterconcept of ander materiaal dat baat heeft bij een groter rasterresultaat. Het blijft onderscheiden van het latere V4.1-model en van de SVG-uitvoer van V4 Pro Vector.
De specifieke producentencode is recraftv4_pro. De gedocumenteerde uitvoer is 2K-raster in verliesvrije WebP of PNG: 2048 × 2048 pixels voor vierkant, 2688 × 1536 voor 16:9 en 1664 × 2560 voor 2:3. Andere ondersteunde verhoudingen hebben eigen afmetingen. Kies een beeldverhouding voor de bedoelde lay-out of een exact toegestaan formaat; een willekeurig pixelformaat maakt geen deel uit van het gedocumenteerde generatiecontract. Standaard V4 heeft kleinere 1K-rasteruitvoer, terwijl vectormodellen geen vaste pixelresolutie hebben.
V4 kan een korte prompt voor verkenning of een gestructureerde prompt voor een gecontroleerd resultaat interpreteren. Voor een specifieke artdirection gaat de fabrikantengids van onderwerp en omgeving naar kadrering, kenmerken, ruimtelijke relaties, belichting, diepte en sfeer. Vraag voor een redactioneel productbeeld een dramatische verticale foto van een sculpturale stoel, oppervlakken van geborsteld metaal, zijlicht, een rustige donkere achtergrond en ruimte boven het object voor een titel. Die relaties benoemen maakt de bedoelde compositie duidelijker dan een algemeen verzoek om een hoogwaardig beeld.
Het creatieve bereik van de familie omvat verhalende illustratie, fotorealistische scènes en ruimtelijke beelden met materiaal- en lichtaanwijzingen. Een 3D-ogend resultaat blijft een afbeelding, geen bewerkbare 3D-scène. Specificeer voor een grafische poster de visuele lagen en hun interactie: achtergrond, illustratie of foto, kophiërarchie en ondersteunende tekst. V4 is gepositioneerd voor leesbare korte en middellange zinnen, maar controleer spelling en hiërarchie van het eindresultaat in plaats van ze uit de modelnaam af te leiden.
De huidige generatiedocumentatie staat prompts tot 10.000 tekens, één tot zes afbeeldingen, een willekeurige seed en instellingen voor voorkeurskleuren en achtergrondkleur toe. Optionele aangepaste stijlen of compatibele referentiebeelden kunnen het uiterlijk sturen met flexibele of precieze matching. Het model accepteert de oudere V3-instellingen negative_prompt, gecureerde stijlen, text_layout, artistic_level en no_text niet. Beschrijf het gewenste eindbeeld in de positieve prompt en hou vereisten voor onderwerp, lay-out en kleur expliciet. Gebruik voor generatie met stijlreferenties één tot tien PNG-, JPG- of WebP-afbeeldingen, samen maximaal 64 MB en elk kleiner dan 20 MB. Elke referentie moet een korte zijde van minstens 256 pixels, een lange zijde van maximaal 4.096 pixels en een resolutie van maximaal 16 megapixels hebben. Gebruik die referenties of een compatibele opgeslagen stijl, niet beide.
Recraft documenteert een afzonderlijke afbeelding-naar-afbeeldingbewerking voor V4. Die combineert een bestaand beeld en een prompt met sterkte van 0 tot 1 om de mate van verandering te sturen en accepteert daarin geen instellingen voor aangepaste V4-stijlen. Bereid de bron binnen de beeldinvoerlimieten van de producent voor en geef aan welke kenmerken in het nieuwe resultaat moeten doorwerken. Controleer voor een groter eindbeeld fijne details, uitsnede en letters op de bedoelde grootte. Het extra rasterdetail van Pro ondersteunt die controle, terwijl het beeld een gegenereerde interpretatie van de aangeleverde creatieve briefing blijft. Lever voor afbeelding-naar-afbeelding PNG, JPG, WebP of SVG aan, kleiner dan 20 MB, maximaal 16 megapixels, met beide zijden tussen 256 en 4.096 pixels.
POST /v1/images/generationstext, imageimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten recraft/recraft-v4-pro | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 6 | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 1:1, 4:3, 3:4, 16:9, 9:16, auto | Standaard— |
Veldinput_references | Typearray | VereisteOptioneel | Waarden en limieten Minimumaantal items: 0 Maximumaantal items: 1 | Standaard— |
Tekst naar afbeelding · Vereist: prompt
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parametermaterial_types | Contracttext, image |
Parameteroptional_controls | Contractaspect_ratio, n, input_references |
Parameterexact_supported_parameters | Contract{"aspect_ratio":{"type":"enum","values":["1:1","4:3","3:4","16:9","9:16","auto"]},"n":{"type":"range","min":1,"max":6},"input_references":{"type":"range","min":0,"max":1}} |
Parameterreference_material_rule | ContractAlleen werkelijke referentieafbeeldingen van de klant; de voorwaarden van het eindpunt van de aanbieder zijn hierop van toepassing. |
Methodealiasnamen: /v1/images
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}
Gebruik het exacte model en de gedocumenteerde invoervelden.
Bewaar het volledige antwoord, alle werkelijke uitvoer en de oorspronkelijke teruggestuurde ID's.
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.
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Rekeneenheid | Kosten |
|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Rekeneenheid— | 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 |
| ConfiguratieUltra | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper uitvoerafbeelding | Kosten Uitvoer · afbeeldingsuitvoer · Schatting uitsluitend ter vergelijking $0.5 per uitvoerafbeelding |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.5 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 →
Referentiestaffels op modelniveau veranderen de methodeselectie, kostenramingen of afschrijvingen niet. Voor de actieve kostenberekening gelden de tarieven van de geselecteerde Ailoot-methode.
| Configuratie | Factureringsvoorwaarden | Kosten |
|---|---|---|
| ConfiguratieUitvoerafbeelding | FactureringsvoorwaardenEr is geen prijsvariant gedeclareerd. | Kosten Uitvoer · Uitvoerafbeelding $0.5 per afbeelding Gelijkwaardige vermeldingen beschrijven dezelfde aanrekening; ze voegen geen tweede kost toe. |
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={'model': 'recraft/recraft-v4-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\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\nfrom 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-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\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])\nimport 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-pro", "prompt": "a red panda astronaut floating in space, studio lighting"};\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");\nDownload 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}Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Bewaar elk gegevensitem en het volledige verbruik; zorg dat alle werkelijk teruggestuurde afbeeldingen als eigen assets worden opgeslagen. Geen verzonnen URL's of ID's.
Als het resultaat van een afbeeldingsgeneratie of -bewerking gecontroleerd moet worden, bewaar dan de oorspronkelijke operation_id/X-Client-Request-ID en de teruggegeven resultaatinformatie. Haal bestaande eigen resultaten terug via de mediabibliotheek met daadwerkelijk teruggegeven task_id- of asset_id-waarden. Dien de generatie- of bewerkingsaanvraag niet opnieuw in en stel geen polling-URL samen op basis van operation_id.
| Veld | Type |
|---|---|
Veldcreated | Typeinteger |
Velddata[].url | Typestring |
Velddata[].b64_json | Typebase64 string |
Veldusage | Typeobject |
Ailoot Ultra recraft/recraft-v4-pro
/v1/images