Recraft V4 — Recraft’ning V4 avlodidagi standart rastr model. Ishlab chiqaruvchi dizayn tanlovini ta’kidlaydi: muvozanatli kompozitsiya, uyg‘un rang munosabatlari va vizual niyatga xizmat qiladigan detallar. U uslublashtirilgan illyustratsiya, fotografik sahnalar va grafik dizayn g‘oyalari bilan ishlay oladi. Qisqa yo‘nalishdan kayfiyat izlash yoki maqsadli maketni batafsil belgilashda, topshiriq estetik tanlovlarni aniqlik bilan birlashtirgan tasvir talab qilsa undan foydalaning.
Aniq model kodi recraftv4. Ishlab chiqaruvchi ma’lumotnomasi yo‘qotishsiz WebP yoki PNG shaklida 1K rastr natijani ko‘rsatadi. Kvadrat tasvir 1024 × 1024 piksel, 16:9 — 1344 × 768, 2:3 esa 832 × 1280; boshqa qo‘llanadigan nisbatlar o‘z o‘lchamlariga ega. V4 Pro alohida 2K rastr nashr, V4 Vector va Pro Vector esa tahrirlanadigan SVG qaytaradi. Turli chiqish xususiyatlarini birlashtirmasdan, kerakli natija uchun aniq V4 variantini tanlang.
Ishlab chiqaruvchi qo‘llanmasi qisqa talqinli topshiriqlarni tuzilmali ijodiy yo‘nalishdan ajratadi. Qisqa ibora shakl, kayfiyat va kadr kompozitsiyasini o‘rganishga joy qoldiradi. Tuzilmali topshiriq obyekt, muhit, poza, material, ikkinchi darajali elementlar, yoritish va vizual iyerarxiyani nomlashi mumkin. Hikoyaviy illyustratsiya uchun kichik ko‘prikdan o‘tayotgan velosipedchi, dadil soddalashtirilgan shakllar, iliq sokin ranglar va chapdan o‘ngga aniq harakatni tasvirlang. Bu mazmun va kompozitsiya qarorlari aloqasiz uslub sifatlarining uzun ro‘yxatidan amaliyroq.
V4 doirasiga illyustratsiya, hajmli tasvirlar va fotorealistik vizuallar kiradi. Qo‘llanma illyustratsiyada chizish mantig‘ini, 3D ko‘rinishdagi tasvirda esa material, yorug‘lik, kamera va chuqurlikni tasvirlashni tavsiya qiladi. Ikkinchisi tahrirlanadigan mesh emas, rastr vizual bo‘lib qoladi. Plakat yoki qadoqlash g‘oyasi uchun qaysi so‘zlar asosiy, qayerda turishi va tasvir hamda tipografiya qanday bog‘lanishini ayting. Ishlab chiqaruvchi o‘qiladigan qisqa va o‘rtacha uzunlikdagi matnni ta’kidlaydi; ishlatishdan avval qaytgan tasvirdagi haqiqiy so‘zlar va joylashuvni tekshiring.
Yaratish 10,000 belgigacha topshiriq, tasodifiy seed, birdan oltitagacha natija, afzal ranglar va kerakli fon rangini qo‘llaydi. Ixtiyoriy mos maxsus uslublar va namuna tasvirlari flexible yoki precise matching orqali vizual ishlovni yo‘naltirishi mumkin. Bitta toza namuna yoki umumiy vizual dunyoga mansub to‘plamni tanlang, yangi obyekt va sahnani esa topshiriq tasvirlasin. Namuna va natija orasida rang mosligi kafolatlanmaydi, shuning uchun kerakli palitrani aniq saqlang va natijani unga solishtiring. Namuna uslubida yaratish uchun birdan o‘ntagacha PNG, JPG yoki WebP, jami ko‘pi bilan 64 MB va har biri 20 MB dan kichik tasvir ishlating. Har bir namunaning eng qisqa tomoni kamida 256 piksel, eng uzuni ko‘pi bilan 4,096 piksel, aniqligi esa ko‘pi bilan 16 megapiksel bo‘lishi kerak. Shu namunalar yoki mos saqlangan uslubdan birini ishlating, ikkalasini birga emas.
Hujjatlashtirilgan tasvirdan tasvir amali mavjud tasvir va topshiriqni birlashtiradi; 0 dan 1 gacha strength yangi natija manbadan qanchalik uzoqlashishini belgilaydi. Ushbu amalda V4 uslub boshqaruvlari qabul qilinmaydi. Hozirgi yaratish ma’lumotnomasi tayyor tanlangan uslub nomlari, negative_prompt, text_layout, artistic_level va no_text ni ham istisno qiladi. Kerakli natijaning ijobiy tavsifini tayyorlang va materialni maqsad kompozitsiyasi ichida baholang. Standart V4 aniq nashr, format va chiqish o‘lchamiga ega yo‘naltirilgan rastr dizayn talqinini beradi. Tasvirdan tasvir uchun 20 MB dan kichik, ko‘pi bilan 16 megapikselli, ikkala tomoni 256–4,096 piksel oralig‘idagi PNG, JPG, WebP yoki SVG bering.
", "aboutText": "Recraft V4 — Recraft’ning V4 avlodidagi standart rastr model. Ishlab chiqaruvchi dizayn tanlovini ta’kidlaydi: muvozanatli kompozitsiya, uyg‘un rang munosabatlari va vizual niyatga xizmat qiladigan detallar. U uslublashtirilgan illyustratsiya, fotografik sahnalar va grafik dizayn g‘oyalari bilan ishlay oladi. Qisqa yo‘nalishdan kayfiyat izlash yoki maqsadli maketni batafsil belgilashda, topshiriq estetik tanlovlarni aniqlik bilan birlashtirgan tasvir talab qilsa undan foydalaning.\n\nAniq model kodi recraftv4. Ishlab chiqaruvchi ma’lumotnomasi yo‘qotishsiz WebP yoki PNG shaklida 1K rastr natijani ko‘rsatadi. Kvadrat tasvir 1024 × 1024 piksel, 16:9 — 1344 × 768, 2:3 esa 832 × 1280; boshqa qo‘llanadigan nisbatlar o‘z o‘lchamlariga ega. V4 Pro alohida 2K rastr nashr, V4 Vector va Pro Vector esa tahrirlanadigan SVG qaytaradi. Turli chiqish xususiyatlarini birlashtirmasdan, kerakli natija uchun aniq V4 variantini tanlang.\n\nIshlab chiqaruvchi qo‘llanmasi qisqa talqinli topshiriqlarni tuzilmali ijodiy yo‘nalishdan ajratadi. Qisqa ibora shakl, kayfiyat va kadr kompozitsiyasini o‘rganishga joy qoldiradi. Tuzilmali topshiriq obyekt, muhit, poza, material, ikkinchi darajali elementlar, yoritish va vizual iyerarxiyani nomlashi mumkin. Hikoyaviy illyustratsiya uchun kichik ko‘prikdan o‘tayotgan velosipedchi, dadil soddalashtirilgan shakllar, iliq sokin ranglar va chapdan o‘ngga aniq harakatni tasvirlang. Bu mazmun va kompozitsiya qarorlari aloqasiz uslub sifatlarining uzun ro‘yxatidan amaliyroq.\n\nV4 doirasiga illyustratsiya, hajmli tasvirlar va fotorealistik vizuallar kiradi. Qo‘llanma illyustratsiyada chizish mantig‘ini, 3D ko‘rinishdagi tasvirda esa material, yorug‘lik, kamera va chuqurlikni tasvirlashni tavsiya qiladi. Ikkinchisi tahrirlanadigan mesh emas, rastr vizual bo‘lib qoladi. Plakat yoki qadoqlash g‘oyasi uchun qaysi so‘zlar asosiy, qayerda turishi va tasvir hamda tipografiya qanday bog‘lanishini ayting. Ishlab chiqaruvchi o‘qiladigan qisqa va o‘rtacha uzunlikdagi matnni ta’kidlaydi; ishlatishdan avval qaytgan tasvirdagi haqiqiy so‘zlar va joylashuvni tekshiring.\n\nYaratish 10,000 belgigacha topshiriq, tasodifiy seed, birdan oltitagacha natija, afzal ranglar va kerakli fon rangini qo‘llaydi. Ixtiyoriy mos maxsus uslublar va namuna tasvirlari flexible yoki precise matching orqali vizual ishlovni yo‘naltirishi mumkin. Bitta toza namuna yoki umumiy vizual dunyoga mansub to‘plamni tanlang, yangi obyekt va sahnani esa topshiriq tasvirlasin. Namuna va natija orasida rang mosligi kafolatlanmaydi, shuning uchun kerakli palitrani aniq saqlang va natijani unga solishtiring. Namuna uslubida yaratish uchun birdan o‘ntagacha PNG, JPG yoki WebP, jami ko‘pi bilan 64 MB va har biri 20 MB dan kichik tasvir ishlating. Har bir namunaning eng qisqa tomoni kamida 256 piksel, eng uzuni ko‘pi bilan 4,096 piksel, aniqligi esa ko‘pi bilan 16 megapiksel bo‘lishi kerak. Shu namunalar yoki mos saqlangan uslubdan birini ishlating, ikkalasini birga emas.\n\nHujjatlashtirilgan tasvirdan tasvir amali mavjud tasvir va topshiriqni birlashtiradi; 0 dan 1 gacha strength yangi natija manbadan qanchalik uzoqlashishini belgilaydi. Ushbu amalda V4 uslub boshqaruvlari qabul qilinmaydi. Hozirgi yaratish ma’lumotnomasi tayyor tanlangan uslub nomlari, negative_prompt, text_layout, artistic_level va no_text ni ham istisno qiladi. Kerakli natijaning ijobiy tavsifini tayyorlang va materialni maqsad kompozitsiyasi ichida baholang. Standart V4 aniq nashr, format va chiqish o‘lchamiga ega yo‘naltirilgan rastr dizayn talqinini beradi. Tasvirdan tasvir uchun 20 MB dan kichik, ko‘pi bilan 16 megapikselli, ikkala tomoni 256–4,096 piksel oralig‘idagi PNG, JPG, WebP yoki SVG bering.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "86b1f67d2b5e8364685340e4dc791ea0c1dc4c8d4c70e40602ff187aabd04225", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "uz", "methods": [ { "html": "recraft/recraft-v4Recraft V4 kompozitsiya, rang munosabatlari va batafsil ijodiy yo‘nalishga e’tibor qaratib, 1K rastr tasvirlar yaratadi. U ixtiyoriy uslub kirishlari va alohida tasvirdan tasvir jarayoni bilan illyustratsiya, fotorealistik sahnalar hamda grafik dizayn g‘oyalarini qamrab oladi.
Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.
Recraft V4 — Recraft’ning V4 avlodidagi standart rastr model. Ishlab chiqaruvchi dizayn tanlovini ta’kidlaydi: muvozanatli kompozitsiya, uyg‘un rang munosabatlari va vizual niyatga xizmat qiladigan detallar. U uslublashtirilgan illyustratsiya, fotografik sahnalar va grafik dizayn g‘oyalari bilan ishlay oladi. Qisqa yo‘nalishdan kayfiyat izlash yoki maqsadli maketni batafsil belgilashda, topshiriq estetik tanlovlarni aniqlik bilan birlashtirgan tasvir talab qilsa undan foydalaning.
Aniq model kodi recraftv4. Ishlab chiqaruvchi ma’lumotnomasi yo‘qotishsiz WebP yoki PNG shaklida 1K rastr natijani ko‘rsatadi. Kvadrat tasvir 1024 × 1024 piksel, 16:9 — 1344 × 768, 2:3 esa 832 × 1280; boshqa qo‘llanadigan nisbatlar o‘z o‘lchamlariga ega. V4 Pro alohida 2K rastr nashr, V4 Vector va Pro Vector esa tahrirlanadigan SVG qaytaradi. Turli chiqish xususiyatlarini birlashtirmasdan, kerakli natija uchun aniq V4 variantini tanlang.
Ishlab chiqaruvchi qo‘llanmasi qisqa talqinli topshiriqlarni tuzilmali ijodiy yo‘nalishdan ajratadi. Qisqa ibora shakl, kayfiyat va kadr kompozitsiyasini o‘rganishga joy qoldiradi. Tuzilmali topshiriq obyekt, muhit, poza, material, ikkinchi darajali elementlar, yoritish va vizual iyerarxiyani nomlashi mumkin. Hikoyaviy illyustratsiya uchun kichik ko‘prikdan o‘tayotgan velosipedchi, dadil soddalashtirilgan shakllar, iliq sokin ranglar va chapdan o‘ngga aniq harakatni tasvirlang. Bu mazmun va kompozitsiya qarorlari aloqasiz uslub sifatlarining uzun ro‘yxatidan amaliyroq.
V4 doirasiga illyustratsiya, hajmli tasvirlar va fotorealistik vizuallar kiradi. Qo‘llanma illyustratsiyada chizish mantig‘ini, 3D ko‘rinishdagi tasvirda esa material, yorug‘lik, kamera va chuqurlikni tasvirlashni tavsiya qiladi. Ikkinchisi tahrirlanadigan mesh emas, rastr vizual bo‘lib qoladi. Plakat yoki qadoqlash g‘oyasi uchun qaysi so‘zlar asosiy, qayerda turishi va tasvir hamda tipografiya qanday bog‘lanishini ayting. Ishlab chiqaruvchi o‘qiladigan qisqa va o‘rtacha uzunlikdagi matnni ta’kidlaydi; ishlatishdan avval qaytgan tasvirdagi haqiqiy so‘zlar va joylashuvni tekshiring.
Yaratish 10,000 belgigacha topshiriq, tasodifiy seed, birdan oltitagacha natija, afzal ranglar va kerakli fon rangini qo‘llaydi. Ixtiyoriy mos maxsus uslublar va namuna tasvirlari flexible yoki precise matching orqali vizual ishlovni yo‘naltirishi mumkin. Bitta toza namuna yoki umumiy vizual dunyoga mansub to‘plamni tanlang, yangi obyekt va sahnani esa topshiriq tasvirlasin. Namuna va natija orasida rang mosligi kafolatlanmaydi, shuning uchun kerakli palitrani aniq saqlang va natijani unga solishtiring. Namuna uslubida yaratish uchun birdan o‘ntagacha PNG, JPG yoki WebP, jami ko‘pi bilan 64 MB va har biri 20 MB dan kichik tasvir ishlating. Har bir namunaning eng qisqa tomoni kamida 256 piksel, eng uzuni ko‘pi bilan 4,096 piksel, aniqligi esa ko‘pi bilan 16 megapiksel bo‘lishi kerak. Shu namunalar yoki mos saqlangan uslubdan birini ishlating, ikkalasini birga emas.
Hujjatlashtirilgan tasvirdan tasvir amali mavjud tasvir va topshiriqni birlashtiradi; 0 dan 1 gacha strength yangi natija manbadan qanchalik uzoqlashishini belgilaydi. Ushbu amalda V4 uslub boshqaruvlari qabul qilinmaydi. Hozirgi yaratish ma’lumotnomasi tayyor tanlangan uslub nomlari, negative_prompt, text_layout, artistic_level va no_text ni ham istisno qiladi. Kerakli natijaning ijobiy tavsifini tayyorlang va materialni maqsad kompozitsiyasi ichida baholang. Standart V4 aniq nashr, format va chiqish o‘lchamiga ega yo‘naltirilgan rastr dizayn talqinini beradi. Tasvirdan tasvir uchun 20 MB dan kichik, ko‘pi bilan 16 megapikselli, ikkala tomoni 256–4,096 piksel oralig‘idagi PNG, JPG, WebP yoki SVG bering.
POST /v1/images/generationstext, imageimage| Maydon | Tur | Talab | Qiymatlar va cheklovlar | Standart |
|---|---|---|---|---|
Maydonmodel | Turstring | TalabMajburiy | Qiymatlar va cheklovlar recraft/recraft-v4 | Standart— |
Maydonprompt | Turstring | TalabMajburiy | Qiymatlar va cheklovlar Eng kam uzunlik: 1 | Standart— |
Maydonn | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar Eng kam: 1 Eng ko‘p: 6 | Standart— |
Maydonaspect_ratio | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar 1:1, 4:3, 3:4, 16:9, 9:16, auto | Standart— |
Maydoninput_references | Turarray | TalabIxtiyoriy | Qiymatlar va cheklovlar Elementlarning eng kam soni: 0 Elementlarning eng ko‘p soni: 1 | Standart— |
Matndan rasm · Majburiy: prompt
reference_guided_image · Majburiy: prompt, actual image reference
| Parametr | Parametr talablari |
|---|---|
Parametrcontent_type | Parametr talablariapplication/json |
Parametrrequired | Parametr talablarimodel, prompt |
Parametrmaterial_types | Parametr talablaritext, image |
Parametroptional_controls | Parametr talablarin, aspect_ratio, input_references |
Parametrn | Parametr talablari{"minimum":1,"maximum":6} |
Parametrreference_images | Parametr talablari{"minimum":0,"maximum":1,"source":"mijoz bergan haqiqiy material"} |
Parametrprovider_specific_options | Parametr talablariFaqat saqlangan aniq endpoint ruxsat ro‘yxatidagi style/controls/text_layout; taxminiy tuzilmalar yo‘q. |
Usul taxalluslari: /v1/images
Hayot sikli: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Amalda qaytarilgan task_id yoki media kutubxonasidagi yozuv
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Faqat matnli ko‘rsatma berilgan misolda rasmiy ImageGenerationRequest tuzilmasi saqlanadi.
Qaytarilgan har bir rasmni va to‘liq javobni saqlang; chiqishlar soni so‘ralgan n emas, haqiqiy sondir.
Ko‘rsatilgan tariflar xarajatni generatsiyadan oldin taxminiy hisoblash uchun xizmat qiladi. Yakuniy to‘lov dastlabki generatsiya uchun qayd etilgan xarajat asosida hisoblanadi. Natijaning o‘lchangan davomiyligi va oldindan taxmin qilingan miqdorlar haq undiriladigan yakuniy miqdor hisoblanmaydi.
Tarif ma’lumotlari so‘rov imkoniyatlarini qo‘shmaydi. Qo‘llab-quvvatlanadigan parametrlar tanlangan usulda ko‘rsatilgan.
Har bir to‘lovni ko‘rsatilgan shartlarga moslang. Har bir muqobil sozlamalar to‘plami uchun bitta tarifdan foydalaning.
| Sozlama | Tariflar jadvali | Prognoz miqdori | Hisob birligi | To‘lov |
|---|---|---|---|---|
| SozlamaTokenlar uchun bazaviy tariflar | Tariflar jadvaliAsosiy tarif | Prognoz miqdori— | Hisob birligi— | To‘lov Kirish · Kirish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Chiqish · Chiqish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshdan o‘qish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish, 1 soat · Faqat taqqoslash uchun taxmin — / 1K token |
| SozlamaUltra | Tariflar jadvali— | Prognoz miqdori— | Hisob birligichiqish rasmi uchun | To‘lov Chiqish · chiqish rasmi · Faqat taqqoslash uchun taxmin $0.08 chiqish rasmi uchun |
| SozlamaYaratishning taxminiy qiymati | Tariflar jadvali— | Prognoz miqdoribir generatsiya uchun taxmin | Hisob birligi— | To‘lov Chiqish · Yaratishning taxminiy narxi · Faqat taqqoslash uchun taxmin $0.08 yaratishdan oldingi taxmin Bu taxmin qo‘shimcha to‘lov ham, tugallangan generatsiya uchun qat’iy tarif ham emas. |
Ailoot so‘rovdan oldin taxminiy summani band qiladi. Natijadan keyin o‘lchangan sarf asosidagi yakuniy to‘lovni yechadi. Oqimli javob bo‘yicha yakuniy hisob-kitob yakuniy sarf yozuviga asoslanadi. Summani band qilish va to‘lovni hisoblash tartibi →
Modelning ma’lumot jadvallari usul tanlash, narx hisobi yoki to‘lovlarni o‘zgartirmaydi. Amaldagi to‘lovlar tanlangan Ailoot usuli tariflari bo‘yicha hisoblanadi.
| Sozlama | To‘lovni hisoblash shartlari | To‘lov |
|---|---|---|
| SozlamaChiqish rasmi | To‘lovni hisoblash shartlariNarxlash varianti e’lon qilinmagan. | To‘lov Chiqish · Chiqish rasmi $0.08 rasm uchun Teng kuchli yozuvlar ayni to‘lovni tavsiflaydi; ular ikkinchi haqni qo‘shmaydi. |
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");\nHar bir qaytarilgan rasmni yuklab oling yoki uning Base64 kontentini saqlang
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Har bir tayyor rasmni saqlang; har bir qaytarilgan URL dan kontentni oling yoki uning Base64 kontentini dekodlang.
Har bir data elementini va to‘liq foydalanish ma’lumotini saqlang; haqiqatda qaytarilgan barcha rasmlarni o‘z egaligingizga olib saqlang. URL yoki ID lar o‘ylab topilmasin.
Rasm yaratish yoki tahrirlash natijasini tekshirish kerak bo‘lsa, dastlabki operation_id/X-Client-Request-ID va qaytarilgan natija haqidagi ma’lumotlarni saqlang. Amalda qaytarilgan task_id yoki asset_id qiymatlari yordamida media kutubxonasidan o‘zingizga tegishli mavjud natijalarni tiklang. Rasm yaratish/tahrirlash so‘rovini qayta yubormang va operation_id dan holatni davriy tekshirish uchun URL tuzmang.
| Maydon | Tur |
|---|---|
Maydoncreated | Turinteger |
Maydondata[].url | Turstring |
Maydondata[].b64_json | Turbase64 string |
Maydonusage | Turobject |
| Javob | Shart | Keyingi qadam |
|---|---|---|
Javob400 · invalid_request_error | ShartMajburiy maydonlar, material ifodasi yoki parametr qiymati noto‘g‘ri | Keyingi qadamYangi yaratish so‘rovidan oldin ko‘rsatilgan maydonlarni tuzating. |
Javobserver_error | ShartQaytarilgan javob operatsiya yoki natijani tekshirish kerakligini bildiradi | Keyingi qadamDastlab qaytarilgan operatsiya/vazifa ID sini, so‘rov sarlavhalarini va javobni saqlang; aynan shu operatsiya uchun qo‘llab-quvvatlanadigan o‘qish so‘rovlarini davom ettiring. Yaratish so‘rovini qayta yubormang. |
Ailoot Ultra recraft/recraft-v4
/v1/images