GPT Image 1.5 — мәтіндік сипаттама бойынша сурет жасауға арналған OpenAI моделі. Өндіруші нұсқауларды орындауды және егжей-тегжейлі тапсырманы өңдеуді атап көрсетеді: онда көрініс мазмұнын, композицияны, нысандардың сыртқы түрін және қажетті стильді анықтауға болады. Сурет әдісінің нәтижесі — дайын сурет.
Ailoot-та бұл карточка мәтіндік кіріспен генерацияға жатады. OpenAI модельдің бастапқы суреттермен жұмысын, өңдеуді және жеке аймақтарды өзгертуді де сипаттайды. Бұл мүмкіндіктер визуалды кірістің бөлек қолдауын қажет етеді және мұнда белгіленген мәтіндік генерация тәсіліне кірмейді.
OpenAI бөлек қарастырған түзету операциясында маска бағдар қызметін атқарады: нәтиженің оның контурларына дәл сәйкес келуі кепілдендірілмейді. Мұндай операция бастапқы суретті беруді қолдауды қажет етеді; қазіргі Ailoot карточкасы бұрынғыдай мәтіндік кіріспен генерацияға жатады.
Шаршы 1024x1024, көлденең 1536x1024 және тік 1024x1536 өлшемдері, сондай-ақ автоматты таңдау қарастырылған. Бұл нұсқаға басқа модельдердің еркін өлшемдерін қолдануға болмайды.
Сапа деңгейлері — low, medium, high және auto. Сапаны таңдау өңдеу көлеміне және нәтиженің детализациясына әсер етеді. Сапа мен өлшем — әртүрлі баптаулар: кадр бағыты композиция кеңістігін, ал сапа деңгейі оны қалыптастыру режимін анықтайды. GPT Image 1.5 үшін xhigh және max деңгейлері мәлімделмеген.
Әдепкіде нәтиже PNG түрінде жасалады; JPEG және WebP де қарастырылған. JPEG пен WebP үшін сығу дәрежесін беруге болады. Бұл — генерация сапасынан өзгеше нәтиже файлының баптауы.
Өндіруші мөлдір және мөлдір емес фонды, сондай-ақ автоматты таңдауды қарастырады. Мөлдірлік үшін PNG немесе WebP қажет: JPEG альфа-арнаны сақтамайды. Мөлдір фон сурет кейінгі композицияда бөлек нысан ретінде қолданылуы керек болғанда ыңғайлы. Нақты параметрлердің қолдауын таңдалған әдіспен үйлестіру керек.
Модель суретке жазулар қосып, бірнеше элементтен көрініс құра алады, бірақ мәтін мен нысандардың дәл орналасуына кепілдік берілмейді. Жеке генерациялар арасында бір кейіпкердің келбеті немесе безендірудің қайталануы да бақылауды қажет етеді.
Күрделі сурет қарапайымнан ұзағырақ қалыптасуы мүмкін; OpenAI дерегіне сәйкес, кейбір күрделі тапсырмалар екі минутқа дейін созылуы мүмкін. Нәтиже үшін бастапқы сипаттаманың толықтығы да, дайын суретті тексеру де маңызды: жазулардың оқылуы, бөлшектердің орналасуы және берілген көрініске сәйкестігі файлдың өзі бойынша бағаланады.
", "aboutText": "### Егжей-тегжейлі тапсырма бойынша сурет\n\nGPT Image 1.5 — мәтіндік сипаттама бойынша сурет жасауға арналған OpenAI моделі. Өндіруші нұсқауларды орындауды және егжей-тегжейлі тапсырманы өңдеуді атап көрсетеді: онда көрініс мазмұнын, композицияны, нысандардың сыртқы түрін және қажетті стильді анықтауға болады. Сурет әдісінің нәтижесі — дайын сурет.\n\nAiloot-та бұл карточка мәтіндік кіріспен генерацияға жатады. OpenAI модельдің бастапқы суреттермен жұмысын, өңдеуді және жеке аймақтарды өзгертуді де сипаттайды. Бұл мүмкіндіктер визуалды кірістің бөлек қолдауын қажет етеді және мұнда белгіленген мәтіндік генерация тәсіліне кірмейді.\n\nOpenAI бөлек қарастырған түзету операциясында маска бағдар қызметін атқарады: нәтиженің оның контурларына дәл сәйкес келуі кепілдендірілмейді. Мұндай операция бастапқы суретті беруді қолдауды қажет етеді; қазіргі Ailoot карточкасы бұрынғыдай мәтіндік кіріспен генерацияға жатады.\n\n### Кадрдың үш пішіні және сапаны баптау\n\nШаршы `1024x1024`, көлденең `1536x1024` және тік `1024x1536` өлшемдері, сондай-ақ автоматты таңдау қарастырылған. Бұл нұсқаға басқа модельдердің еркін өлшемдерін қолдануға болмайды.\n\nСапа деңгейлері — `low`, `medium`, `high` және `auto`. Сапаны таңдау өңдеу көлеміне және нәтиженің детализациясына әсер етеді. Сапа мен өлшем — әртүрлі баптаулар: кадр бағыты композиция кеңістігін, ал сапа деңгейі оны қалыптастыру режимін анықтайды. GPT Image 1.5 үшін `xhigh` және `max` деңгейлері мәлімделмеген.\n\n### Файл форматы және фон\n\nӘдепкіде нәтиже PNG түрінде жасалады; JPEG және WebP де қарастырылған. JPEG пен WebP үшін сығу дәрежесін беруге болады. Бұл — генерация сапасынан өзгеше нәтиже файлының баптауы.\n\nӨндіруші мөлдір және мөлдір емес фонды, сондай-ақ автоматты таңдауды қарастырады. Мөлдірлік үшін PNG немесе WebP қажет: JPEG альфа-арнаны сақтамайды. Мөлдір фон сурет кейінгі композицияда бөлек нысан ретінде қолданылуы керек болғанда ыңғайлы. Нақты параметрлердің қолдауын таңдалған әдіспен үйлестіру керек.\n\n### Мәтін мен композицияны тексеру қажет\n\nМодель суретке жазулар қосып, бірнеше элементтен көрініс құра алады, бірақ мәтін мен нысандардың дәл орналасуына кепілдік берілмейді. Жеке генерациялар арасында бір кейіпкердің келбеті немесе безендірудің қайталануы да бақылауды қажет етеді.\n\nКүрделі сурет қарапайымнан ұзағырақ қалыптасуы мүмкін; OpenAI дерегіне сәйкес, кейбір күрделі тапсырмалар екі минутқа дейін созылуы мүмкін. Нәтиже үшін бастапқы сипаттаманың толықтығы да, дайын суретті тексеру де маңызды: жазулардың оқылуы, бөлшектердің орналасуы және берілген көрініске сәйкестігі файлдың өзі бойынша бағаланады.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "ae6effcb15f23e5d560db0a5647b74bb19c65357bb47d839cba3109926329636", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "kk", "methods": [ { "html": "gpt-image-1.5GPT Image 1.5 егжей-тегжейлі нұсқауларды орындауға басымдық беріп, мәтіндік тапсырма бойынша суреттер жасайды. Кадрдың үш пішіні, бірнеше сапа деңгейі және нәтиже форматы қарастырылған.
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
GPT Image 1.5 — мәтіндік сипаттама бойынша сурет жасауға арналған OpenAI моделі. Өндіруші нұсқауларды орындауды және егжей-тегжейлі тапсырманы өңдеуді атап көрсетеді: онда көрініс мазмұнын, композицияны, нысандардың сыртқы түрін және қажетті стильді анықтауға болады. Сурет әдісінің нәтижесі — дайын сурет.
Ailoot-та бұл карточка мәтіндік кіріспен генерацияға жатады. OpenAI модельдің бастапқы суреттермен жұмысын, өңдеуді және жеке аймақтарды өзгертуді де сипаттайды. Бұл мүмкіндіктер визуалды кірістің бөлек қолдауын қажет етеді және мұнда белгіленген мәтіндік генерация тәсіліне кірмейді.
OpenAI бөлек қарастырған түзету операциясында маска бағдар қызметін атқарады: нәтиженің оның контурларына дәл сәйкес келуі кепілдендірілмейді. Мұндай операция бастапқы суретті беруді қолдауды қажет етеді; қазіргі Ailoot карточкасы бұрынғыдай мәтіндік кіріспен генерацияға жатады.
Шаршы 1024x1024, көлденең 1536x1024 және тік 1024x1536 өлшемдері, сондай-ақ автоматты таңдау қарастырылған. Бұл нұсқаға басқа модельдердің еркін өлшемдерін қолдануға болмайды.
Сапа деңгейлері — low, medium, high және auto. Сапаны таңдау өңдеу көлеміне және нәтиженің детализациясына әсер етеді. Сапа мен өлшем — әртүрлі баптаулар: кадр бағыты композиция кеңістігін, ал сапа деңгейі оны қалыптастыру режимін анықтайды. GPT Image 1.5 үшін xhigh және max деңгейлері мәлімделмеген.
Әдепкіде нәтиже PNG түрінде жасалады; JPEG және WebP де қарастырылған. JPEG пен WebP үшін сығу дәрежесін беруге болады. Бұл — генерация сапасынан өзгеше нәтиже файлының баптауы.
Өндіруші мөлдір және мөлдір емес фонды, сондай-ақ автоматты таңдауды қарастырады. Мөлдірлік үшін PNG немесе WebP қажет: JPEG альфа-арнаны сақтамайды. Мөлдір фон сурет кейінгі композицияда бөлек нысан ретінде қолданылуы керек болғанда ыңғайлы. Нақты параметрлердің қолдауын таңдалған әдіспен үйлестіру керек.
Модель суретке жазулар қосып, бірнеше элементтен көрініс құра алады, бірақ мәтін мен нысандардың дәл орналасуына кепілдік берілмейді. Жеке генерациялар арасында бір кейіпкердің келбеті немесе безендірудің қайталануы да бақылауды қажет етеді.
Күрделі сурет қарапайымнан ұзағырақ қалыптасуы мүмкін; OpenAI дерегіне сәйкес, кейбір күрделі тапсырмалар екі минутқа дейін созылуы мүмкін. Нәтиже үшін бастапқы сипаттаманың толықтығы да, дайын суретті тексеру де маңызды: жазулардың оқылуы, бөлшектердің орналасуы және берілген көрініске сәйкестігі файлдың өзі бойынша бағаланады.
POST /v1/images/generationstextimage| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер gpt-image-1.5 | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер Ең аз ұзындық: 1 | Әдепкі— |
Өрісn | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 1 | Әдепкі1 |
Өрісresponse_format | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер url, b64_json | Әдепкі— |
Өрісstream | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкіfalse |
Өрісsize | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— |
Өрісquality | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— |
Өрісbackground | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— |
Өрісoutput_format | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— |
Өрісoutput_compression | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— |
Өрісmoderation | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— |
Өрісinput_fidelity | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— |
Өрісstyle | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— |
Өрісpartial_images | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— |
Мәтіннен сурет жасау · Міндетті: 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": "gpt-image-1.5", "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': 'gpt-image-1.5', '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": "gpt-image-1.5", "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 gpt-image-1.5
Ailoot Ultra gpt-image-1.5
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.
gpt-image-1.5GPT Image 1.5 егжей-тегжейлі нұсқауларды орындауға басымдық беріп, мәтіндік тапсырма бойынша суреттер жасайды. Кадрдың үш пішіні, бірнеше сапа деңгейі және нәтиже форматы қарастырылған.
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
GPT Image 1.5 — мәтіндік сипаттама бойынша сурет жасауға арналған OpenAI моделі. Өндіруші нұсқауларды орындауды және егжей-тегжейлі тапсырманы өңдеуді атап көрсетеді: онда көрініс мазмұнын, композицияны, нысандардың сыртқы түрін және қажетті стильді анықтауға болады. Сурет әдісінің нәтижесі — дайын сурет.
Ailoot-та бұл карточка мәтіндік кіріспен генерацияға жатады. OpenAI модельдің бастапқы суреттермен жұмысын, өңдеуді және жеке аймақтарды өзгертуді де сипаттайды. Бұл мүмкіндіктер визуалды кірістің бөлек қолдауын қажет етеді және мұнда белгіленген мәтіндік генерация тәсіліне кірмейді.
OpenAI бөлек қарастырған түзету операциясында маска бағдар қызметін атқарады: нәтиженің оның контурларына дәл сәйкес келуі кепілдендірілмейді. Мұндай операция бастапқы суретті беруді қолдауды қажет етеді; қазіргі Ailoot карточкасы бұрынғыдай мәтіндік кіріспен генерацияға жатады.
Шаршы 1024x1024, көлденең 1536x1024 және тік 1024x1536 өлшемдері, сондай-ақ автоматты таңдау қарастырылған. Бұл нұсқаға басқа модельдердің еркін өлшемдерін қолдануға болмайды.
Сапа деңгейлері — low, medium, high және auto. Сапаны таңдау өңдеу көлеміне және нәтиженің детализациясына әсер етеді. Сапа мен өлшем — әртүрлі баптаулар: кадр бағыты композиция кеңістігін, ал сапа деңгейі оны қалыптастыру режимін анықтайды. GPT Image 1.5 үшін xhigh және max деңгейлері мәлімделмеген.
Әдепкіде нәтиже PNG түрінде жасалады; JPEG және WebP де қарастырылған. JPEG пен WebP үшін сығу дәрежесін беруге болады. Бұл — генерация сапасынан өзгеше нәтиже файлының баптауы.
Өндіруші мөлдір және мөлдір емес фонды, сондай-ақ автоматты таңдауды қарастырады. Мөлдірлік үшін PNG немесе WebP қажет: JPEG альфа-арнаны сақтамайды. Мөлдір фон сурет кейінгі композицияда бөлек нысан ретінде қолданылуы керек болғанда ыңғайлы. Нақты параметрлердің қолдауын таңдалған әдіспен үйлестіру керек.
Модель суретке жазулар қосып, бірнеше элементтен көрініс құра алады, бірақ мәтін мен нысандардың дәл орналасуына кепілдік берілмейді. Жеке генерациялар арасында бір кейіпкердің келбеті немесе безендірудің қайталануы да бақылауды қажет етеді.
Күрделі сурет қарапайымнан ұзағырақ қалыптасуы мүмкін; OpenAI дерегіне сәйкес, кейбір күрделі тапсырмалар екі минутқа дейін созылуы мүмкін. Нәтиже үшін бастапқы сипаттаманың толықтығы да, дайын суретті тексеру де маңызды: жазулардың оқылуы, бөлшектердің орналасуы және берілген көрініске сәйкестігі файлдың өзі бойынша бағаланады.
POST /v1/images/generationstextimage| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер gpt-image-1.5 | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер Ең үлкен ұзындық: 32 000 | Әдепкі— |
Өрісsize | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 1024x1024, 1536x1024, 1024x1536, auto | Әдепкіauto |
Өрісbackground | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер transparent, opaque, auto | Әдепкіauto |
Өрісmoderation | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер low, auto Шарттар: Мазмұнның стандартты модерациясы үшін auto қолданыңыз. | Әдепкі— |
Өрісn | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 1 Ең көбі: 10 | Әдепкі1 |
Өрісquality | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер auto, high, medium, low | Әдепкіauto |
Өрісoutput_compression | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 0 Ең көбі: 100 Шарттар: JPEG және WebP шығысына қолданылады; құжатталған бүтін сан мәнін жіберіңіз. | Әдепкі100 |
Өрісoutput_format | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер webp, png, jpeg | Әдепкіpng |
Өрісstream | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер false Шарттар: Бұл маршрут бір толық аяқталған JSON жауабын қайтарады. | Әдепкіfalse |
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыprompt, model |
Параметрmaterial_types | Параметр талаптарыtext |
Параметрoptional | Параметр талаптарыsize, background, moderation, n, quality, output_compression, output_format, stream |
Параметрconditions | Параметр талаптарыМөлдір фон үшін PNG немесе WebP қажет., Шығысты сығу JPEG немесе WebP үшін қолданылады., Таңдалған әдіс мәтіннен генерация жасайды. Өндіруші сипаттаған өңдеу және ағынмен беру параметрлері бөлек мүмкіндіктерге жатады. |
Өмірлік цикл: 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}
Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.
Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Мөлшерлемелер кестесі | Болжамды мөлшер | Төлем |
|---|---|---|---|
| БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Болжамды мөлшер— | Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен |
| БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.32768 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
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={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-1.5', 'size': '1024x1024', 'n': 1, 'background': 'auto', 'moderation': 'auto', 'output_format': 'png'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nҚайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nӘр дайын суретті сақтаңыз; қайтарылған әр URL арқылы мазмұнды алыңыз немесе оның Base64 мазмұнын декодтаңыз.
Толық жауапты және тақырыптарды, алынған әрбір нәтижені, бастапқыда қайтарылған идентификаторларды және пайдалану туралы барлық өрістерді сақтаңыз. Жасау сұрауын қайта жібермей, бастапқы операцияны қалпына келтіріңіз.
Есептерді салыстырып тексеру үшін қайтарылған X-Client-Request-ID мәнін сақтаңыз. Тек нақты қайтарылған task_id/asset_id мәндері арқылы немесе өзіңізге тиесілі медиатекадан оқыңыз; операция ID мәнінен тапсырманың URL мекенжайын ешқашан құрастырмаңыз және жасау сұрауын ешқашан қайта жібермеңіз.
| Өріс | Түрі |
|---|---|
Өрісcreated | Түрі |
Өрісdata[].url | Түрі |
Өрісdata[].b64_json | Түрі |
Өрісusage | Түрі |
Ailoot gpt-image-1.5
Ailoot Ultra gpt-image-1.5
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.