Recraft V4 je štandardný rastrový model generácie Recraft V4. Výrobca zdôrazňuje dizajnový úsudok: vyváženú kompozíciu, súdržné farebné vzťahy a detaily podporujúce vizuálny zámer. Môže pracovať so štylizovanou ilustráciou, fotografickými scénami a konceptmi grafického dizajnu. Použite ho, keď zadanie žiada obrázok spájajúci estetické voľby s presnosťou voči zadaniu, či už pri skúmaní nálady zo stručného smeru alebo pri podrobnom určovaní zámerného rozloženia.
Presný kód modelu je recraftv4. Referencia výrobcu uvádza rastrový výstup 1K v bezstratovom WebP alebo PNG. Štvorcový obrázok má 1024 × 1024 pixelov, 16:9 je 1344 × 768 a 2:3 je 832 × 1280; ďalšie podporované pomery používajú vlastné rozmery. V4 Pro je samostatná rastrová edícia 2K, kým V4 Vector a Pro Vector vracajú editovateľné SVG. Presný variant V4 vyberte podľa zamýšľaného výstupu namiesto kombinovania týchto odlišných výstupných vlastností.
Návod výrobcu rozlišuje stručné interpretačné zadania od štruktúrovaného tvorivého smerovania. Krátka fráza môže ponechať priestor na skúmanie formy, nálady a rámovania. Štruktúrované zadanie môže pomenovať subjekt, prostredie, pózu, materiál, druhotné prvky, osvetlenie a vizuálnu hierarchiu. Pri príbehovej ilustrácii opíšte cyklistu prechádzajúceho malým mostom, výrazné zjednodušené tvary, teplé tlmené farby a jasný pohyb zľava doprava. Tieto obsahové a kompozičné rozhodnutia sú vykonateľnejšie než dlhý zoznam nesúvisiacich štýlových prídavných mien.
Rozsah V4 zahŕňa ilustráciu, priestorové obrazy a fotorealistické vizuály. Návod odporúča opisovať logiku kresby pri ilustrácii a materiál, svetlo, kameru a hĺbku pri obrázku s 3D vzhľadom. Ten zostáva rastrovým vizuálom, nie editovateľnou sieťou geometrie. Pri plagáte alebo koncepte obalu určte hlavné slová, kam patria a ako obraz a typografia interagujú. Výrobca vyzdvihuje čitateľný krátky a stredne dlhý text; skutočné znenie a usporiadanie vo vrátenom obrázku pred použitím skontrolujte.
Generovanie podporuje zadania do 10 000 znakov, náhodný seed, jeden až šesť výstupov, preferované farby a požadovanú farbu pozadia. Voliteľné kompatibilné vlastné štýly a referenčné obrázky môžu usmerniť vizuálne spracovanie cez flexibilnú alebo presnú zhodu. Vyberte čistú referenciu alebo sadu patriacu do jedného vizuálneho sveta a nové subjekty a scénu nechajte opísať zadaniu. Farebná zhoda referencie s výstupom nie je zaručená, preto požadovanú paletu uveďte výslovne a porovnajte s ňou výsledok. Pri generovaní podľa referenčného štýlu použite jeden až desať obrázkov PNG, JPG alebo WebP, spolu najviac 64 MB a každý pod 20 MB. Každá referencia potrebuje kratšiu stranu aspoň 256 pixelov, dlhšiu najviac 4 096 pixelov a rozlíšenie najviac 16 megapixelov. Použite buď tieto referencie, alebo kompatibilný uložený štýl, nie obe možnosti.
Dokumentovaná operácia image-to-image spája existujúci obrázok a zadanie so silou od 0 do 1 určujúcou, ako ďaleko sa nový výstup odchýli od zdroja. V tejto operácii neprijíma štýlové ovládanie V4. Aktuálna referencia generovania vylučuje aj názvy kurátorovaných štýlov, negative_prompt, text_layout, artistic_level a no_text. Pripravte pozitívny opis požadovaného výsledku a vizuál vyhodnoťte v jeho cieľovej kompozícii. Štandardný V4 poskytuje sústredenú rastrovú interpretáciu dizajnu s konkrétnou edíciou, formátom a výstupnou veľkosťou. Pre image-to-image dodajte PNG, JPG, WebP alebo SVG pod 20 MB, najviac 16 megapixelov, s oboma stranami od 256 do 4 096 pixelov.
", "aboutText": "Recraft V4 je štandardný rastrový model generácie Recraft V4. Výrobca zdôrazňuje dizajnový úsudok: vyváženú kompozíciu, súdržné farebné vzťahy a detaily podporujúce vizuálny zámer. Môže pracovať so štylizovanou ilustráciou, fotografickými scénami a konceptmi grafického dizajnu. Použite ho, keď zadanie žiada obrázok spájajúci estetické voľby s presnosťou voči zadaniu, či už pri skúmaní nálady zo stručného smeru alebo pri podrobnom určovaní zámerného rozloženia.\n\nPresný kód modelu je recraftv4. Referencia výrobcu uvádza rastrový výstup 1K v bezstratovom WebP alebo PNG. Štvorcový obrázok má 1024 × 1024 pixelov, 16:9 je 1344 × 768 a 2:3 je 832 × 1280; ďalšie podporované pomery používajú vlastné rozmery. V4 Pro je samostatná rastrová edícia 2K, kým V4 Vector a Pro Vector vracajú editovateľné SVG. Presný variant V4 vyberte podľa zamýšľaného výstupu namiesto kombinovania týchto odlišných výstupných vlastností.\n\nNávod výrobcu rozlišuje stručné interpretačné zadania od štruktúrovaného tvorivého smerovania. Krátka fráza môže ponechať priestor na skúmanie formy, nálady a rámovania. Štruktúrované zadanie môže pomenovať subjekt, prostredie, pózu, materiál, druhotné prvky, osvetlenie a vizuálnu hierarchiu. Pri príbehovej ilustrácii opíšte cyklistu prechádzajúceho malým mostom, výrazné zjednodušené tvary, teplé tlmené farby a jasný pohyb zľava doprava. Tieto obsahové a kompozičné rozhodnutia sú vykonateľnejšie než dlhý zoznam nesúvisiacich štýlových prídavných mien.\n\nRozsah V4 zahŕňa ilustráciu, priestorové obrazy a fotorealistické vizuály. Návod odporúča opisovať logiku kresby pri ilustrácii a materiál, svetlo, kameru a hĺbku pri obrázku s 3D vzhľadom. Ten zostáva rastrovým vizuálom, nie editovateľnou sieťou geometrie. Pri plagáte alebo koncepte obalu určte hlavné slová, kam patria a ako obraz a typografia interagujú. Výrobca vyzdvihuje čitateľný krátky a stredne dlhý text; skutočné znenie a usporiadanie vo vrátenom obrázku pred použitím skontrolujte.\n\nGenerovanie podporuje zadania do 10 000 znakov, náhodný seed, jeden až šesť výstupov, preferované farby a požadovanú farbu pozadia. Voliteľné kompatibilné vlastné štýly a referenčné obrázky môžu usmerniť vizuálne spracovanie cez flexibilnú alebo presnú zhodu. Vyberte čistú referenciu alebo sadu patriacu do jedného vizuálneho sveta a nové subjekty a scénu nechajte opísať zadaniu. Farebná zhoda referencie s výstupom nie je zaručená, preto požadovanú paletu uveďte výslovne a porovnajte s ňou výsledok. Pri generovaní podľa referenčného štýlu použite jeden až desať obrázkov PNG, JPG alebo WebP, spolu najviac 64 MB a každý pod 20 MB. Každá referencia potrebuje kratšiu stranu aspoň 256 pixelov, dlhšiu najviac 4 096 pixelov a rozlíšenie najviac 16 megapixelov. Použite buď tieto referencie, alebo kompatibilný uložený štýl, nie obe možnosti.\n\nDokumentovaná operácia image-to-image spája existujúci obrázok a zadanie so silou od 0 do 1 určujúcou, ako ďaleko sa nový výstup odchýli od zdroja. V tejto operácii neprijíma štýlové ovládanie V4. Aktuálna referencia generovania vylučuje aj názvy kurátorovaných štýlov, negative_prompt, text_layout, artistic_level a no_text. Pripravte pozitívny opis požadovaného výsledku a vizuál vyhodnoťte v jeho cieľovej kompozícii. Štandardný V4 poskytuje sústredenú rastrovú interpretáciu dizajnu s konkrétnou edíciou, formátom a výstupnou veľkosťou. Pre image-to-image dodajte PNG, JPG, WebP alebo SVG pod 20 MB, najviac 16 megapixelov, s oboma stranami od 256 do 4 096 pixelov.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "2f19fe462c14278d39778254e599f959606c972d6c10bec6421960fa7b08b60a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sk", "methods": [ { "html": "recraft/recraft-v4Recraft V4 generuje rastrové obrázky 1K so zameraním na kompozíciu, farebné vzťahy a podrobné tvorivé smerovanie. Pokrýva ilustráciu, fotorealistické scény a koncepty grafického dizajnu s voliteľnými štýlovými vstupmi a samostatným postupom image-to-image.
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Recraft V4 je štandardný rastrový model generácie Recraft V4. Výrobca zdôrazňuje dizajnový úsudok: vyváženú kompozíciu, súdržné farebné vzťahy a detaily podporujúce vizuálny zámer. Môže pracovať so štylizovanou ilustráciou, fotografickými scénami a konceptmi grafického dizajnu. Použite ho, keď zadanie žiada obrázok spájajúci estetické voľby s presnosťou voči zadaniu, či už pri skúmaní nálady zo stručného smeru alebo pri podrobnom určovaní zámerného rozloženia.
Presný kód modelu je recraftv4. Referencia výrobcu uvádza rastrový výstup 1K v bezstratovom WebP alebo PNG. Štvorcový obrázok má 1024 × 1024 pixelov, 16:9 je 1344 × 768 a 2:3 je 832 × 1280; ďalšie podporované pomery používajú vlastné rozmery. V4 Pro je samostatná rastrová edícia 2K, kým V4 Vector a Pro Vector vracajú editovateľné SVG. Presný variant V4 vyberte podľa zamýšľaného výstupu namiesto kombinovania týchto odlišných výstupných vlastností.
Návod výrobcu rozlišuje stručné interpretačné zadania od štruktúrovaného tvorivého smerovania. Krátka fráza môže ponechať priestor na skúmanie formy, nálady a rámovania. Štruktúrované zadanie môže pomenovať subjekt, prostredie, pózu, materiál, druhotné prvky, osvetlenie a vizuálnu hierarchiu. Pri príbehovej ilustrácii opíšte cyklistu prechádzajúceho malým mostom, výrazné zjednodušené tvary, teplé tlmené farby a jasný pohyb zľava doprava. Tieto obsahové a kompozičné rozhodnutia sú vykonateľnejšie než dlhý zoznam nesúvisiacich štýlových prídavných mien.
Rozsah V4 zahŕňa ilustráciu, priestorové obrazy a fotorealistické vizuály. Návod odporúča opisovať logiku kresby pri ilustrácii a materiál, svetlo, kameru a hĺbku pri obrázku s 3D vzhľadom. Ten zostáva rastrovým vizuálom, nie editovateľnou sieťou geometrie. Pri plagáte alebo koncepte obalu určte hlavné slová, kam patria a ako obraz a typografia interagujú. Výrobca vyzdvihuje čitateľný krátky a stredne dlhý text; skutočné znenie a usporiadanie vo vrátenom obrázku pred použitím skontrolujte.
Generovanie podporuje zadania do 10 000 znakov, náhodný seed, jeden až šesť výstupov, preferované farby a požadovanú farbu pozadia. Voliteľné kompatibilné vlastné štýly a referenčné obrázky môžu usmerniť vizuálne spracovanie cez flexibilnú alebo presnú zhodu. Vyberte čistú referenciu alebo sadu patriacu do jedného vizuálneho sveta a nové subjekty a scénu nechajte opísať zadaniu. Farebná zhoda referencie s výstupom nie je zaručená, preto požadovanú paletu uveďte výslovne a porovnajte s ňou výsledok. Pri generovaní podľa referenčného štýlu použite jeden až desať obrázkov PNG, JPG alebo WebP, spolu najviac 64 MB a každý pod 20 MB. Každá referencia potrebuje kratšiu stranu aspoň 256 pixelov, dlhšiu najviac 4 096 pixelov a rozlíšenie najviac 16 megapixelov. Použite buď tieto referencie, alebo kompatibilný uložený štýl, nie obe možnosti.
Dokumentovaná operácia image-to-image spája existujúci obrázok a zadanie so silou od 0 do 1 určujúcou, ako ďaleko sa nový výstup odchýli od zdroja. V tejto operácii neprijíma štýlové ovládanie V4. Aktuálna referencia generovania vylučuje aj názvy kurátorovaných štýlov, negative_prompt, text_layout, artistic_level a no_text. Pripravte pozitívny opis požadovaného výsledku a vizuál vyhodnoťte v jeho cieľovej kompozícii. Štandardný V4 poskytuje sústredenú rastrovú interpretáciu dizajnu s konkrétnou edíciou, formátom a výstupnou veľkosťou. Pre image-to-image dodajte PNG, JPG, WebP alebo SVG pod 20 MB, najviac 16 megapixelov, s oboma stranami od 256 do 4 096 pixelov.
POST /v1/images/generationstext, imageimage| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity recraft/recraft-v4 | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Minimálna dĺžka: 1 | Predvolené— |
Polen | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 1 Maximum: 6 | Predvolené— |
Poleaspect_ratio | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 1:1, 4:3, 3:4, 16:9, 9:16, auto | Predvolené— |
Poleinput_references | Typarray | PožiadavkaVoliteľné | Hodnoty a limity Minimálny počet položiek: 0 Maximálny počet položiek: 1 | Predvolené— |
Z textu na obrázok · Povinné: prompt
reference_guided_image · Povinné: prompt, actual image reference
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt |
Parametermaterial_types | Špecifikáciatext, image |
Parameteroptional_controls | Špecifikácian, aspect_ratio, input_references |
Parametern | Špecifikácia{"minimum":1,"maximum":6} |
Parameterreference_images | Špecifikácia{"minimum":0,"maximum":1,"source":"skutočný materiál dodaný zákazníkom"} |
Parameterprovider_specific_options | ŠpecifikáciaIba presný uložený zoznam povolených hodnôt koncového bodu pre style/controls/text_layout; žiadne vymyslené štruktúry. |
Aliasy metódy: /v1/images
Životný cyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · skutočne vrátené task_id alebo záznam v knižnici médií
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Príklad obsahujúci iba zadanie zachováva oficiálnu štruktúru ImageGenerationRequest.
Zachovajte každý vrátený obrázok a úplnú odpoveď; počet výstupov zodpovedá výsledku, nie požadovanej hodnote n.
Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Odhadované množstvo | Účtovacia jednotka | Poplatok |
|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Účtovacia jednotka— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov |
| KonfiguráciaUltra | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza výstupný obrázok | Poplatok Výstup · výstupný obrázok · Odhad iba na porovnanie $0.08 za výstupný obrázok |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Účtovacia jednotka— | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.08 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie. |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Referenčné sadzobníky modelu nemenia výber metódy, cenové odhady ani poplatky. Aktívne poplatky používajú sadzby vybranej metódy Ailoot.
| Konfigurácia | Podmienky účtovania | Poplatok |
|---|---|---|
| KonfiguráciaVýstupný obrázok | Podmienky účtovaniaNie je deklarovaný žiadny cenový variant. | Poplatok Výstup · Výstupný obrázok $0.08 za obrázok Ekvivalentné položky opisujú rovnaký poplatok; nepridávajú druhý poplatok. |
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', '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', '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", "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");\nStiahnite každý vrátený obrázok alebo uložte jeho obsah Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Uložte každý dokončený obrázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.
Zachovajte každú dátovú položku a úplnú spotrebu; prevezmite do vlastníctva a uložte všetky skutočne vrátené obrázky. Žiadne vymyslené URL ani ID.
Ak je potrebné skontrolovať výsledok generovania alebo úpravy obrázka, uchovajte pôvodné operation_id/X-Client-Request-ID a vrátené informácie o výsledku. Existujúce vlastné výsledky obnovte cez knižnicu médií pomocou skutočných hodnôt task_id alebo asset_id. Požiadavku na generovanie/úpravu znova neodosielajte ani nevytvárajte URL na priebežné zisťovanie stavu z operation_id.
| Pole | Typ |
|---|---|
Polecreated | Typinteger |
Poledata[].url | Typstring |
Poledata[].b64_json | Typbase64 string |
Poleusage | Typobject |
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaNeplatné povinné polia, reprezentácia materiálu alebo hodnota parametra | Ďalší krokPred novou požiadavkou na vytvorenie opravte uvedené polia. |
Odpoveďserver_error | PodmienkaVrátená odpoveď uvádza, že operáciu alebo výsledok je potrebné skontrolovať | Ďalší krokUchovajte pôvodné vrátené ID operácie/úlohy, hlavičky požiadavky a odpoveď; naďalej čítajte údaje o tejto pôvodnej operácii podporovaným spôsobom. Požiadavku na vytvorenie znova neodosielajte. |
Ailoot Ultra recraft/recraft-v4
/v1/images