Qwen-Image-3.0-Pro — композициясы, жазулары мен ұсақ бөлшектері маңызды суреттерді жасауға және өңдеуге арналған Alibaba моделі. Оның бағыттарына тығыз макеттер, суреттің ішіндегі сурет, газет беттеуі, кадрлық жоспарлар, мәзірлер және оқу парақтары кіреді. Ailoot-тың ағымдағы карточкасында мәтіндік тапсырма бойынша сурет генерациялау режимі берілген. Alibaba өңдеуді және үлгі суреттермен жұмысты да қарастырады; бұл операциялар кіріс суреттерді жеке қолдауды қажет етеді және карточканың ағымдағы әдісінде ұсынылмаған.
Өндіруші 4,5 мың токенге дейінгі ұзақ тапсырмаларды, 12 тілдегі жазуларды және бірнеше қаріппен жұмысты атап көрсетеді. Бұл — тапсырманы өңдеудің сипатталған мүмкіндігі, формалды контекст терезесінің жарияланған өлшемі емес. Мәлімделген қасиеттерге өлшемі 10 пиксель болатын ұсақ жазуларды, тері мен шаш текстурасын, бет әлпетінің шағын өзгерістерін беру кіреді. Мұндай бөлшектер суреті жақыннан қаралатын материалдарды дайындағанда пайдалы.
Qwen-Image-3.0-Pro веб-беттердің, ойындардың және тікелей эфир экрандарының визуалды тұжырымдамаларына да арналған. Мұндай нәтижеде иллюстрацияны, экран құрылымын және безендірілген жазуларды біріктіруге болады. Модель макеттің суретін жасайды; жұмыс істейтін қолданба бөлек іске асыруды қажет етеді.
Өңдеу режимі үшін Alibaba бірден үшке дейін сурет көрсетеді. Бұл тәсілде өндіруші нысанды үлгінің нөмірімен байланыстырып, материалдардың үйлесуін сипаттауға мүмкіндік береді. Нысандарды қосу, жою және жылжыту, әрекетті, стильді, бөлшектер мен мәтінді өзгерту қарастырылған. Теріс сипаттама қажетсіз элементтерді белгілеуге көмектеседі.
Өндірушідегі өңдеу режимінің кіріс материалдары JPG, JPEG, PNG, BMP, TIFF, WEBP және GIF форматтарында қабылданады. Анимациялық GIF үшін бірінші кадр қолданылады. Әр файлдың өлшемі — 10 МБ-қа дейін; өндіруші қабырғалары 384-тен 3072 пиксельге дейінгі суреттерді ұсынады. Бұл — дайын нәтиженің өлшемдері емес, кіріске арналған ұсынымдар.
Өндіруші спецификациясында бір сұрауға PNG форматындағы бірден алтыға дейін шығыс сурет қарастырылған. Нәтиженің ауданы — 262 144-тен 4 194 304 пиксельге дейін, бұл 512 × 512-ден 2048 × 2048-ге дейінгі шаршы суреттерге сәйкес келеді. 1:8-ден 8:1-ге дейінгі арақатынастарға рұқсат етіледі, сондықтан созылыңқы композиция үшін қабырға ұзындығы таңдалған кадр пішініне де байланысты. Генерация алдында тапсырманы қосымша қайта өңдеу қарастырылған.
", "aboutText": "Qwen-Image-3.0-Pro — композициясы, жазулары мен ұсақ бөлшектері маңызды суреттерді жасауға және өңдеуге арналған Alibaba моделі. Оның бағыттарына тығыз макеттер, суреттің ішіндегі сурет, газет беттеуі, кадрлық жоспарлар, мәзірлер және оқу парақтары кіреді. Ailoot-тың ағымдағы карточкасында мәтіндік тапсырма бойынша сурет генерациялау режимі берілген. Alibaba өңдеуді және үлгі суреттермен жұмысты да қарастырады; бұл операциялар кіріс суреттерді жеке қолдауды қажет етеді және карточканың ағымдағы әдісінде ұсынылмаған.\n\n### Суреттегі мәтін және бөлшектер\n\nӨндіруші 4,5 мың токенге дейінгі ұзақ тапсырмаларды, 12 тілдегі жазуларды және бірнеше қаріппен жұмысты атап көрсетеді. Бұл — тапсырманы өңдеудің сипатталған мүмкіндігі, формалды контекст терезесінің жарияланған өлшемі емес. Мәлімделген қасиеттерге өлшемі 10 пиксель болатын ұсақ жазуларды, тері мен шаш текстурасын, бет әлпетінің шағын өзгерістерін беру кіреді. Мұндай бөлшектер суреті жақыннан қаралатын материалдарды дайындағанда пайдалы.\n\nQwen-Image-3.0-Pro веб-беттердің, ойындардың және тікелей эфир экрандарының визуалды тұжырымдамаларына да арналған. Мұндай нәтижеде иллюстрацияны, экран құрылымын және безендірілген жазуларды біріктіруге болады. Модель макеттің суретін жасайды; жұмыс істейтін қолданба бөлек іске асыруды қажет етеді.\n\n### Alibaba спецификациясындағы өңдеу\n\nӨңдеу режимі үшін Alibaba бірден үшке дейін сурет көрсетеді. Бұл тәсілде өндіруші нысанды үлгінің нөмірімен байланыстырып, материалдардың үйлесуін сипаттауға мүмкіндік береді. Нысандарды қосу, жою және жылжыту, әрекетті, стильді, бөлшектер мен мәтінді өзгерту қарастырылған. Теріс сипаттама қажетсіз элементтерді белгілеуге көмектеседі.\n\nӨндірушідегі өңдеу режимінің кіріс материалдары JPG, JPEG, PNG, BMP, TIFF, WEBP және GIF форматтарында қабылданады. Анимациялық GIF үшін бірінші кадр қолданылады. Әр файлдың өлшемі — 10 МБ-қа дейін; өндіруші қабырғалары 384-тен 3072 пиксельге дейінгі суреттерді ұсынады. Бұл — дайын нәтиженің өлшемдері емес, кіріске арналған ұсынымдар.\n\nӨндіруші спецификациясында бір сұрауға PNG форматындағы бірден алтыға дейін шығыс сурет қарастырылған. Нәтиженің ауданы — 262 144-тен 4 194 304 пиксельге дейін, бұл 512 × 512-ден 2048 × 2048-ге дейінгі шаршы суреттерге сәйкес келеді. 1:8-ден 8:1-ге дейінгі арақатынастарға рұқсат етіледі, сондықтан созылыңқы композиция үшін қабырға ұзындығы таңдалған кадр пішініне де байланысты. Генерация алдында тапсырманы қосымша қайта өңдеу қарастырылған.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "db67073ff56e946b97b6c921d9340dfbdb332abd49c84419ab7881aa19d7ce6a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "kk", "methods": [ { "html": "qwen-image-3.0-proМәтін бойынша күрделі макеттерге, жазуларға және шынайы бөлшектерге мән беріп сурет жасайтын модель. Постерлерге, кадрлық жоспарларға, мәзірлерге және тығыз композициялы материалдарға жарайды.
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Qwen-Image-3.0-Pro — композициясы, жазулары мен ұсақ бөлшектері маңызды суреттерді жасауға және өңдеуге арналған Alibaba моделі. Оның бағыттарына тығыз макеттер, суреттің ішіндегі сурет, газет беттеуі, кадрлық жоспарлар, мәзірлер және оқу парақтары кіреді. Ailoot-тың ағымдағы карточкасында мәтіндік тапсырма бойынша сурет генерациялау режимі берілген. Alibaba өңдеуді және үлгі суреттермен жұмысты да қарастырады; бұл операциялар кіріс суреттерді жеке қолдауды қажет етеді және карточканың ағымдағы әдісінде ұсынылмаған.
Өндіруші 4,5 мың токенге дейінгі ұзақ тапсырмаларды, 12 тілдегі жазуларды және бірнеше қаріппен жұмысты атап көрсетеді. Бұл — тапсырманы өңдеудің сипатталған мүмкіндігі, формалды контекст терезесінің жарияланған өлшемі емес. Мәлімделген қасиеттерге өлшемі 10 пиксель болатын ұсақ жазуларды, тері мен шаш текстурасын, бет әлпетінің шағын өзгерістерін беру кіреді. Мұндай бөлшектер суреті жақыннан қаралатын материалдарды дайындағанда пайдалы.
Qwen-Image-3.0-Pro веб-беттердің, ойындардың және тікелей эфир экрандарының визуалды тұжырымдамаларына да арналған. Мұндай нәтижеде иллюстрацияны, экран құрылымын және безендірілген жазуларды біріктіруге болады. Модель макеттің суретін жасайды; жұмыс істейтін қолданба бөлек іске асыруды қажет етеді.
Өңдеу режимі үшін Alibaba бірден үшке дейін сурет көрсетеді. Бұл тәсілде өндіруші нысанды үлгінің нөмірімен байланыстырып, материалдардың үйлесуін сипаттауға мүмкіндік береді. Нысандарды қосу, жою және жылжыту, әрекетті, стильді, бөлшектер мен мәтінді өзгерту қарастырылған. Теріс сипаттама қажетсіз элементтерді белгілеуге көмектеседі.
Өндірушідегі өңдеу режимінің кіріс материалдары JPG, JPEG, PNG, BMP, TIFF, WEBP және GIF форматтарында қабылданады. Анимациялық GIF үшін бірінші кадр қолданылады. Әр файлдың өлшемі — 10 МБ-қа дейін; өндіруші қабырғалары 384-тен 3072 пиксельге дейінгі суреттерді ұсынады. Бұл — дайын нәтиженің өлшемдері емес, кіріске арналған ұсынымдар.
Өндіруші спецификациясында бір сұрауға PNG форматындағы бірден алтыға дейін шығыс сурет қарастырылған. Нәтиженің ауданы — 262 144-тен 4 194 304 пиксельге дейін, бұл 512 × 512-ден 2048 × 2048-ге дейінгі шаршы суреттерге сәйкес келеді. 1:8-ден 8:1-ге дейінгі арақатынастарға рұқсат етіледі, сондықтан созылыңқы композиция үшін қабырға ұзындығы таңдалған кадр пішініне де байланысты. Генерация алдында тапсырманы қосымша қайта өңдеу қарастырылған.
POST /v1/images/generationstextimage| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер qwen-image-3.0-pro | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер Ең аз ұзындық: 1 | Әдепкі— |
Өрісn | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 1 | Әдепкі1 |
Өрісresponse_format | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер url, b64_json | Әдепкі— |
Өрісstream | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкіfalse |
Өрісsize | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— |
Өрісpartial_images | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— |
Өрісimages[].image_url | Түріstring | ТалапҚолдау көрсетілмейді | Мәндер мен шектеулер Декодталған байттардың ең көп саны: 10 485 760 MIME түрлері: image/png, image/jpeg Массивтегі суреттердің ең көп саны: 3 Шарттар: Әр images[] объектісіне бір нақты URL беріледі. Массив элементтерінің саны бұл жол түріндегі соңғы мәннен бөлек ұғым. Мына жағдайда қолданылады: Тек JSON images/edits үшін; JSON images/generations сурет үлгілерін талдамайды. | Әдепкі— |
Өрісimage | Түріfile | ТалапМіндетті емес | Мәндер мен шектеулер Декодталған байттардың ең көп саны: 10 485 760 MIME түрлері: image/png, image/jpeg Мына жағдайда қолданылады: multipart/form-data арқылы генерация | Әдепкі— |
Өрісimage[] | Түріfile[] | ТалапМіндетті емес | Мәндер мен шектеулер Элементтердің ең көп саны: 3 Декодталған байттардың ең көп саны: 10 485 760 MIME түрлері: image/png, image/jpeg Мына жағдайда қолданылады: multipart/form-data арқылы генерация | Әдепкі— |
Мәтіннен сурет жасау · Міндетті: prompt
reference_images_generation · Міндетті: prompt
| Параметр | Параметр талаптары |
|---|---|
Параметрmaterial_types | Параметр талаптарыtext |
Параметрrequired | Параметр талаптарыmodel, prompt |
Параметрoptional_controls | Параметр талаптарыnull |
Параметрcontent_type | Параметр талаптарыapplication/json |
Өмірлік цикл: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Нақты қайтарылған task_id немесе медиатека жазбасы
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Әдіс құрылымдары мен ID мәндері дәл берілген; жеткізушінің мүмкіндігі сұрауды қабылдаудан бөлек қаралады.
POST /v1/images/generationsAiloot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "qwen-image-3.0-pro", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'qwen-image-3.0-pro', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\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": "qwen-image-3.0-pro", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\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Қайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Әр дайын суретті сақтаңыз; қайтарылған әр URL арқылы мазмұнды алыңыз немесе оның Base64 мазмұнын декодтаңыз.
Әрбір дерек элементін сақтаңыз. Әрбір b64_json мәнін декодтаңыз немесе қайтарылған әрбір қолтаңбаланған URL мекенжайынан жүктеп алыңыз. Файл атауының кеңейтімін нақты MIME түріне/байттарға қарап таңдаңыз.
Кескінді генерациялау немесе өңдеу нәтижесін тексеру қажет болса, бастапқы operation_id/X-Client-Request-ID мәнін және қайтарылған нәтиже туралы ақпаратты сақтаңыз. Нақты task_id немесе asset_id мәндерін қолданып, өзіңізге тиесілі бұрыннан бар нәтижелерді медиатека арқылы қалпына келтіріңіз. Генерациялау/өңдеу сұрауын қайта жібермеңіз және operation_id мәнінен күйді сұратуға арналған URL мекенжайын құрастырмаңыз.
| Өріс | Түрі |
|---|---|
Өрісcreated | Түріinteger |
Өрісdata[].url | Түріstring |
Өрісdata[].b64_json | Түріbase64 string |
Өрісusage | Түріobject |
| Жауап | Шарт | Келесі қадам |
|---|---|---|
Жауап400 · invalid_request_error | ШартМіндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қате | Келесі қадамЖаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз. |
Жауапserver_error | ШартҚайтарылған жауапта операцияны немесе нәтижені тексеру қажет екені көрсетілген | Келесі қадамБастапқыда қайтарылған операцияның/тапсырманың ID мәнін, сұрау тақырыптарын және жауабын сақтаңыз; сол бастапқы операцияны қолдау көрсетілетін тәсілдермен оқуды жалғастырыңыз. Жасау сұрауын қайта жібермеңіз. |
Ailoot qwen-image-3.0-pro, qwen-image, qwen-image-latest
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.
qwen-imageМәтін бойынша күрделі макеттерге, жазуларға және шынайы бөлшектерге мән беріп сурет жасайтын модель. Постерлерге, кадрлық жоспарларға, мәзірлерге және тығыз композициялы материалдарға жарайды.
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Qwen-Image-3.0-Pro — композициясы, жазулары мен ұсақ бөлшектері маңызды суреттерді жасауға және өңдеуге арналған Alibaba моделі. Оның бағыттарына тығыз макеттер, суреттің ішіндегі сурет, газет беттеуі, кадрлық жоспарлар, мәзірлер және оқу парақтары кіреді. Ailoot-тың ағымдағы карточкасында мәтіндік тапсырма бойынша сурет генерациялау режимі берілген. Alibaba өңдеуді және үлгі суреттермен жұмысты да қарастырады; бұл операциялар кіріс суреттерді жеке қолдауды қажет етеді және карточканың ағымдағы әдісінде ұсынылмаған.
Өндіруші 4,5 мың токенге дейінгі ұзақ тапсырмаларды, 12 тілдегі жазуларды және бірнеше қаріппен жұмысты атап көрсетеді. Бұл — тапсырманы өңдеудің сипатталған мүмкіндігі, формалды контекст терезесінің жарияланған өлшемі емес. Мәлімделген қасиеттерге өлшемі 10 пиксель болатын ұсақ жазуларды, тері мен шаш текстурасын, бет әлпетінің шағын өзгерістерін беру кіреді. Мұндай бөлшектер суреті жақыннан қаралатын материалдарды дайындағанда пайдалы.
Qwen-Image-3.0-Pro веб-беттердің, ойындардың және тікелей эфир экрандарының визуалды тұжырымдамаларына да арналған. Мұндай нәтижеде иллюстрацияны, экран құрылымын және безендірілген жазуларды біріктіруге болады. Модель макеттің суретін жасайды; жұмыс істейтін қолданба бөлек іске асыруды қажет етеді.
Өңдеу режимі үшін Alibaba бірден үшке дейін сурет көрсетеді. Бұл тәсілде өндіруші нысанды үлгінің нөмірімен байланыстырып, материалдардың үйлесуін сипаттауға мүмкіндік береді. Нысандарды қосу, жою және жылжыту, әрекетті, стильді, бөлшектер мен мәтінді өзгерту қарастырылған. Теріс сипаттама қажетсіз элементтерді белгілеуге көмектеседі.
Өндірушідегі өңдеу режимінің кіріс материалдары JPG, JPEG, PNG, BMP, TIFF, WEBP және GIF форматтарында қабылданады. Анимациялық GIF үшін бірінші кадр қолданылады. Әр файлдың өлшемі — 10 МБ-қа дейін; өндіруші қабырғалары 384-тен 3072 пиксельге дейінгі суреттерді ұсынады. Бұл — дайын нәтиженің өлшемдері емес, кіріске арналған ұсынымдар.
Өндіруші спецификациясында бір сұрауға PNG форматындағы бірден алтыға дейін шығыс сурет қарастырылған. Нәтиженің ауданы — 262 144-тен 4 194 304 пиксельге дейін, бұл 512 × 512-ден 2048 × 2048-ге дейінгі шаршы суреттерге сәйкес келеді. 1:8-ден 8:1-ге дейінгі арақатынастарға рұқсат етіледі, сондықтан созылыңқы композиция үшін қабырға ұзындығы таңдалған кадр пішініне де байланысты. Генерация алдында тапсырманы қосымша қайта өңдеу қарастырылған.
POST /v1/images/generationstextimage| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер qwen-image | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер Ең аз ұзындық: 1 | Әдепкі— |
Өрісn | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 1 | Әдепкі1 |
Өрісresponse_format | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер url, b64_json | Әдепкі— |
Өрісstream | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкіfalse |
Өрісsize | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— |
Өрісpartial_images | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— |
Өрісimages[].image_url | Түріstring | ТалапҚолдау көрсетілмейді | Мәндер мен шектеулер Декодталған байттардың ең көп саны: 10 485 760 MIME түрлері: image/png, image/jpeg Массивтегі суреттердің ең көп саны: 3 Шарттар: Әр images[] объектісіне бір нақты URL беріледі. Массив элементтерінің саны бұл жол түріндегі соңғы мәннен бөлек ұғым. Мына жағдайда қолданылады: Тек JSON images/edits үшін; JSON images/generations сурет үлгілерін талдамайды. | Әдепкі— |
Өрісimage | Түріfile | ТалапМіндетті емес | Мәндер мен шектеулер Декодталған байттардың ең көп саны: 10 485 760 MIME түрлері: image/png, image/jpeg Мына жағдайда қолданылады: multipart/form-data арқылы генерация | Әдепкі— |
Өрісimage[] | Түріfile[] | ТалапМіндетті емес | Мәндер мен шектеулер Элементтердің ең көп саны: 3 Декодталған байттардың ең көп саны: 10 485 760 MIME түрлері: image/png, image/jpeg Мына жағдайда қолданылады: multipart/form-data арқылы генерация | Әдепкі— |
Мәтіннен сурет жасау · Міндетті: prompt
reference_images_generation · Міндетті: prompt
| Параметр | Параметр талаптары |
|---|---|
Параметрmaterial_types | Параметр талаптарыtext |
Параметрrequired | Параметр талаптарыmodel, prompt |
Параметрoptional_controls | Параметр талаптарыnull |
Параметрcontent_type | Параметр талаптарыapplication/json |
Өмірлік цикл: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Нақты қайтарылған task_id немесе медиатека жазбасы
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Әдіс құрылымдары мен ID мәндері дәл берілген; жеткізушінің мүмкіндігі сұрауды қабылдаудан бөлек қаралады.
POST /v1/images/generationsAiloot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "qwen-image", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'qwen-image', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\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": "qwen-image", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\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Қайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Әр дайын суретті сақтаңыз; қайтарылған әр URL арқылы мазмұнды алыңыз немесе оның Base64 мазмұнын декодтаңыз.
Әрбір дерек элементін сақтаңыз. Әрбір b64_json мәнін декодтаңыз немесе қайтарылған әрбір қолтаңбаланған URL мекенжайынан жүктеп алыңыз. Файл атауының кеңейтімін нақты MIME түріне/байттарға қарап таңдаңыз.
Кескінді генерациялау немесе өңдеу нәтижесін тексеру қажет болса, бастапқы operation_id/X-Client-Request-ID мәнін және қайтарылған нәтиже туралы ақпаратты сақтаңыз. Нақты task_id немесе asset_id мәндерін қолданып, өзіңізге тиесілі бұрыннан бар нәтижелерді медиатека арқылы қалпына келтіріңіз. Генерациялау/өңдеу сұрауын қайта жібермеңіз және operation_id мәнінен күйді сұратуға арналған URL мекенжайын құрастырмаңыз.
| Өріс | Түрі |
|---|---|
Өрісcreated | Түріinteger |
Өрісdata[].url | Түріstring |
Өрісdata[].b64_json | Түріbase64 string |
Өрісusage | Түріobject |
| Жауап | Шарт | Келесі қадам |
|---|---|---|
Жауап400 · invalid_request_error | ШартМіндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қате | Келесі қадамЖаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз. |
Жауапserver_error | ШартҚайтарылған жауапта операцияны немесе нәтижені тексеру қажет екені көрсетілген | Келесі қадамБастапқыда қайтарылған операцияның/тапсырманың ID мәнін, сұрау тақырыптарын және жауабын сақтаңыз; сол бастапқы операцияны қолдау көрсетілетін тәсілдермен оқуды жалғастырыңыз. Жасау сұрауын қайта жібермеңіз. |
Ailoot qwen-image-3.0-pro, qwen-image, qwen-image-latest
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.
qwen-image-latestМәтін бойынша күрделі макеттерге, жазуларға және шынайы бөлшектерге мән беріп сурет жасайтын модель. Постерлерге, кадрлық жоспарларға, мәзірлерге және тығыз композициялы материалдарға жарайды.
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Qwen-Image-3.0-Pro — композициясы, жазулары мен ұсақ бөлшектері маңызды суреттерді жасауға және өңдеуге арналған Alibaba моделі. Оның бағыттарына тығыз макеттер, суреттің ішіндегі сурет, газет беттеуі, кадрлық жоспарлар, мәзірлер және оқу парақтары кіреді. Ailoot-тың ағымдағы карточкасында мәтіндік тапсырма бойынша сурет генерациялау режимі берілген. Alibaba өңдеуді және үлгі суреттермен жұмысты да қарастырады; бұл операциялар кіріс суреттерді жеке қолдауды қажет етеді және карточканың ағымдағы әдісінде ұсынылмаған.
Өндіруші 4,5 мың токенге дейінгі ұзақ тапсырмаларды, 12 тілдегі жазуларды және бірнеше қаріппен жұмысты атап көрсетеді. Бұл — тапсырманы өңдеудің сипатталған мүмкіндігі, формалды контекст терезесінің жарияланған өлшемі емес. Мәлімделген қасиеттерге өлшемі 10 пиксель болатын ұсақ жазуларды, тері мен шаш текстурасын, бет әлпетінің шағын өзгерістерін беру кіреді. Мұндай бөлшектер суреті жақыннан қаралатын материалдарды дайындағанда пайдалы.
Qwen-Image-3.0-Pro веб-беттердің, ойындардың және тікелей эфир экрандарының визуалды тұжырымдамаларына да арналған. Мұндай нәтижеде иллюстрацияны, экран құрылымын және безендірілген жазуларды біріктіруге болады. Модель макеттің суретін жасайды; жұмыс істейтін қолданба бөлек іске асыруды қажет етеді.
Өңдеу режимі үшін Alibaba бірден үшке дейін сурет көрсетеді. Бұл тәсілде өндіруші нысанды үлгінің нөмірімен байланыстырып, материалдардың үйлесуін сипаттауға мүмкіндік береді. Нысандарды қосу, жою және жылжыту, әрекетті, стильді, бөлшектер мен мәтінді өзгерту қарастырылған. Теріс сипаттама қажетсіз элементтерді белгілеуге көмектеседі.
Өндірушідегі өңдеу режимінің кіріс материалдары JPG, JPEG, PNG, BMP, TIFF, WEBP және GIF форматтарында қабылданады. Анимациялық GIF үшін бірінші кадр қолданылады. Әр файлдың өлшемі — 10 МБ-қа дейін; өндіруші қабырғалары 384-тен 3072 пиксельге дейінгі суреттерді ұсынады. Бұл — дайын нәтиженің өлшемдері емес, кіріске арналған ұсынымдар.
Өндіруші спецификациясында бір сұрауға PNG форматындағы бірден алтыға дейін шығыс сурет қарастырылған. Нәтиженің ауданы — 262 144-тен 4 194 304 пиксельге дейін, бұл 512 × 512-ден 2048 × 2048-ге дейінгі шаршы суреттерге сәйкес келеді. 1:8-ден 8:1-ге дейінгі арақатынастарға рұқсат етіледі, сондықтан созылыңқы композиция үшін қабырға ұзындығы таңдалған кадр пішініне де байланысты. Генерация алдында тапсырманы қосымша қайта өңдеу қарастырылған.
POST /v1/images/generationstextimage| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер qwen-image-latest | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер Ең аз ұзындық: 1 | Әдепкі— |
Өрісn | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 1 | Әдепкі1 |
Өрісresponse_format | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер url, b64_json | Әдепкі— |
Өрісstream | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкіfalse |
Өрісsize | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— |
Өрісpartial_images | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— |
Өрісimages[].image_url | Түріstring | ТалапҚолдау көрсетілмейді | Мәндер мен шектеулер Декодталған байттардың ең көп саны: 10 485 760 MIME түрлері: image/png, image/jpeg Массивтегі суреттердің ең көп саны: 3 Шарттар: Әр images[] объектісіне бір нақты URL беріледі. Массив элементтерінің саны бұл жол түріндегі соңғы мәннен бөлек ұғым. Мына жағдайда қолданылады: Тек JSON images/edits үшін; JSON images/generations сурет үлгілерін талдамайды. | Әдепкі— |
Өрісimage | Түріfile | ТалапМіндетті емес | Мәндер мен шектеулер Декодталған байттардың ең көп саны: 10 485 760 MIME түрлері: image/png, image/jpeg Мына жағдайда қолданылады: multipart/form-data арқылы генерация | Әдепкі— |
Өрісimage[] | Түріfile[] | ТалапМіндетті емес | Мәндер мен шектеулер Элементтердің ең көп саны: 3 Декодталған байттардың ең көп саны: 10 485 760 MIME түрлері: image/png, image/jpeg Мына жағдайда қолданылады: multipart/form-data арқылы генерация | Әдепкі— |
Мәтіннен сурет жасау · Міндетті: prompt
reference_images_generation · Міндетті: prompt
| Параметр | Параметр талаптары |
|---|---|
Параметрmaterial_types | Параметр талаптарыtext |
Параметрrequired | Параметр талаптарыmodel, prompt |
Параметрoptional_controls | Параметр талаптарыnull |
Параметрcontent_type | Параметр талаптарыapplication/json |
Өмірлік цикл: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Нақты қайтарылған task_id немесе медиатека жазбасы
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Әдіс құрылымдары мен ID мәндері дәл берілген; жеткізушінің мүмкіндігі сұрауды қабылдаудан бөлек қаралады.
POST /v1/images/generationsAiloot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "qwen-image-latest", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'qwen-image-latest', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\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": "qwen-image-latest", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\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Қайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Әр дайын суретті сақтаңыз; қайтарылған әр URL арқылы мазмұнды алыңыз немесе оның Base64 мазмұнын декодтаңыз.
Әрбір дерек элементін сақтаңыз. Әрбір b64_json мәнін декодтаңыз немесе қайтарылған әрбір қолтаңбаланған URL мекенжайынан жүктеп алыңыз. Файл атауының кеңейтімін нақты MIME түріне/байттарға қарап таңдаңыз.
Кескінді генерациялау немесе өңдеу нәтижесін тексеру қажет болса, бастапқы operation_id/X-Client-Request-ID мәнін және қайтарылған нәтиже туралы ақпаратты сақтаңыз. Нақты task_id немесе asset_id мәндерін қолданып, өзіңізге тиесілі бұрыннан бар нәтижелерді медиатека арқылы қалпына келтіріңіз. Генерациялау/өңдеу сұрауын қайта жібермеңіз және operation_id мәнінен күйді сұратуға арналған URL мекенжайын құрастырмаңыз.
| Өріс | Түрі |
|---|---|
Өрісcreated | Түріinteger |
Өрісdata[].url | Түріstring |
Өрісdata[].b64_json | Түріbase64 string |
Өрісusage | Түріobject |
| Жауап | Шарт | Келесі қадам |
|---|---|---|
Жауап400 · invalid_request_error | ШартМіндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қате | Келесі қадамЖаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз. |
Жауапserver_error | ШартҚайтарылған жауапта операцияны немесе нәтижені тексеру қажет екені көрсетілген | Келесі қадамБастапқыда қайтарылған операцияның/тапсырманың ID мәнін, сұрау тақырыптарын және жауабын сақтаңыз; сол бастапқы операцияны қолдау көрсетілетін тәсілдермен оқуды жалғастырыңыз. Жасау сұрауын қайта жібермеңіз. |
Ailoot qwen-image-3.0-pro, qwen-image, qwen-image-latest
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.