GPT Image 2 yra OpenAI modelis vaizdams generuoti ir redaguoti iš teksto bei vaizdinės įvesties. Jis kuria naują vaizdą iš rašytinio aprašo ir gali naudoti šaltinio vaizdus redagavimui ar etalonais grindžiamam darbui. Praktinės užduotys apima iliustracijas, produktų koncepcijas, vizualines kompozicijas ir esamos medžiagos pakeitimus. Tai atskira versija nuo GPT Image 2.5 Sunburst ir Flare modelių, turinti savo kokybės diapazoną ir įvesties tikslumo elgesį.
Generavimui aprašykite objektą, sceną, kompoziciją, šviesą ir norimą stilių. Redagavimui įvardykite, kas turi keistis ir kas išlaikyti išvaizdą. Produkto aprašas gali prašyti keramikinio šviestuvo ant šviesaus paviršiaus su centruotu siluetu ir vieta užrašui; tolesnis redagavimas gali pakeisti foną, išsaugodamas šviestuvo formą ir žiūrėjimo kampą. Dokumentuotos tiesioginės generavimo ir redagavimo eigos priima iki 32 000 simbolių užklausas ir gali pateikti nuo vieno iki dešimties vaizdų.
Redagavimas pagal etalonus priima iki šešiolikos įvesties vaizdų. Nurodykite kiekvieno etalono paskirtį, kad objektas, fonas ir vizualinis apdorojimas nebūtų supainioti. GPT Image 2 automatiškai apdoroja kiekvieną vaizdo įvestį dideliu tikslumu; input_fidelity reikia praleisti, nes šioje versijoje jis nereguliuojamas. Tai skiriasi nuo GPT Image 1 high arba low pasirinkimo ir tik low įvesties tikslumo režimo GPT Image 1 Mini. Didelio tikslumo įvesties apdorojimas padeda šaltinio detalėms, bet negarantuoja, kad kiekviena detalė bus atkurta nepakeista.
Kaukė gali identifikuoti redaguojamą sritį. Šaltinio vaizdas ir kaukė turi būti to paties formato bei matmenų ir pagal vadovo paruošimo reikalavimus mažesni nei 50 MB; kaukei taip pat reikia alfa kanalo. Jei pateikti keli įvesties vaizdai, kaukė taikoma pirmajam. Modelis kaukę laiko užklausa grindžiama gaire, o ne griežta geometrine riba. Aprašykite vietinį pakeitimą ir išsaugojimo reikalavimus, tada patikrinkite aplinkinę sritį dėl netyčinių skirtumų.
GPT Image 2 palaiko low, medium, high ir auto kokybę; numatytoji – auto. 2.5 šeimos xhigh ir max nuostatos nepriklauso šios versijos kokybės diapazonui. Dydis gali būti kvadratinis, horizontalus, vertikalus, automatinis arba tinkamas individualus plotis ir aukštis. Gamintojo pavyzdžiai apima 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 ir 2160 × 3840 pikselių. Orientaciją ir detalumo lygį rinkitės tikram maketui, užuot laikę kokybę bei matmenis tuo pačiu valdikliu.
Individualūs matmenys turi būti šešiolikos pikselių kartotiniai, su didžiausia 3840 pikselių kraštine, ilgosios ir trumposios kraštinių santykiu ne daugiau kaip 3:1 ir plotu nuo 655 360 iki 8 294 400 pikselių. Šios sąlygos galioja vienu metu. Didesnės nei 2560 × 1440 raiškos pažymėtos kaip eksperimentinės. Vieną taisyklę atitinkantis kadras gali pažeisti kitą, todėl pasirinkite palaikomą matmenų porą ir apraše nurodykite apkirpimui jautrius elementus.
Išvestis pagal numatymą yra PNG, taip pat galimi JPEG arba WebP. JPEG ir WebP palaikomas glaudinimas nuo 0 iki 100. Fonas gali būti nepermatomas arba automatinis; konkreti dabartinė specifikacija GPT Image 2 skaidrumą aprašo kaip bandomąją funkciją. Prašydami skaidrumo naudokite PNG arba WebP, kad būtų galima išlaikyti alfa kanalą. Dokumentuota srautinė eiga leidžia iki trijų dalinių vaizdų prieš užbaigtą vaizdą; išsaugokite galutinę medžiagą, o ne pažangos peržiūrą. Gamintojo sąsaja taip pat palaiko paketinį apdorojimą.
Tikrame rezultate įvertinkite teksto aiškumą, objektų vietą ir šaltinio detalių išsaugojimą. Modeliui GPT Image gali būti sunku tiksliai atvaizduoti raides, kurti išdėstymui jautrias kompozicijas ir išlaikyti pasikartojančią vizualinę tapatybę tarp atskirų generavimų. Redagavimų sekai pasirinktą rezultatą naudokite kaip kitą šaltinį ir pateikite konkretų pakeitimą, susietą su matomu trūkumu. Naudinga GPT Image 2 išvestis yra vaizdas, susietas su aiškiu generavimo ar redagavimo aprašu, o didelio tikslumo įvestys, matmenys ir kokybė parinkti būtent tai užduočiai.
", "aboutText": "GPT Image 2 yra OpenAI modelis vaizdams generuoti ir redaguoti iš teksto bei vaizdinės įvesties. Jis kuria naują vaizdą iš rašytinio aprašo ir gali naudoti šaltinio vaizdus redagavimui ar etalonais grindžiamam darbui. Praktinės užduotys apima iliustracijas, produktų koncepcijas, vizualines kompozicijas ir esamos medžiagos pakeitimus. Tai atskira versija nuo GPT Image 2.5 Sunburst ir Flare modelių, turinti savo kokybės diapazoną ir įvesties tikslumo elgesį.\n\nGeneravimui aprašykite objektą, sceną, kompoziciją, šviesą ir norimą stilių. Redagavimui įvardykite, kas turi keistis ir kas išlaikyti išvaizdą. Produkto aprašas gali prašyti keramikinio šviestuvo ant šviesaus paviršiaus su centruotu siluetu ir vieta užrašui; tolesnis redagavimas gali pakeisti foną, išsaugodamas šviestuvo formą ir žiūrėjimo kampą. Dokumentuotos tiesioginės generavimo ir redagavimo eigos priima iki 32 000 simbolių užklausas ir gali pateikti nuo vieno iki dešimties vaizdų.\n\nRedagavimas pagal etalonus priima iki šešiolikos įvesties vaizdų. Nurodykite kiekvieno etalono paskirtį, kad objektas, fonas ir vizualinis apdorojimas nebūtų supainioti. GPT Image 2 automatiškai apdoroja kiekvieną vaizdo įvestį dideliu tikslumu; input_fidelity reikia praleisti, nes šioje versijoje jis nereguliuojamas. Tai skiriasi nuo GPT Image 1 high arba low pasirinkimo ir tik low įvesties tikslumo režimo GPT Image 1 Mini. Didelio tikslumo įvesties apdorojimas padeda šaltinio detalėms, bet negarantuoja, kad kiekviena detalė bus atkurta nepakeista.\n\nKaukė gali identifikuoti redaguojamą sritį. Šaltinio vaizdas ir kaukė turi būti to paties formato bei matmenų ir pagal vadovo paruošimo reikalavimus mažesni nei 50 MB; kaukei taip pat reikia alfa kanalo. Jei pateikti keli įvesties vaizdai, kaukė taikoma pirmajam. Modelis kaukę laiko užklausa grindžiama gaire, o ne griežta geometrine riba. Aprašykite vietinį pakeitimą ir išsaugojimo reikalavimus, tada patikrinkite aplinkinę sritį dėl netyčinių skirtumų.\n\nGPT Image 2 palaiko low, medium, high ir auto kokybę; numatytoji – auto. 2.5 šeimos xhigh ir max nuostatos nepriklauso šios versijos kokybės diapazonui. Dydis gali būti kvadratinis, horizontalus, vertikalus, automatinis arba tinkamas individualus plotis ir aukštis. Gamintojo pavyzdžiai apima 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 ir 2160 × 3840 pikselių. Orientaciją ir detalumo lygį rinkitės tikram maketui, užuot laikę kokybę bei matmenis tuo pačiu valdikliu.\n\nIndividualūs matmenys turi būti šešiolikos pikselių kartotiniai, su didžiausia 3840 pikselių kraštine, ilgosios ir trumposios kraštinių santykiu ne daugiau kaip 3:1 ir plotu nuo 655 360 iki 8 294 400 pikselių. Šios sąlygos galioja vienu metu. Didesnės nei 2560 × 1440 raiškos pažymėtos kaip eksperimentinės. Vieną taisyklę atitinkantis kadras gali pažeisti kitą, todėl pasirinkite palaikomą matmenų porą ir apraše nurodykite apkirpimui jautrius elementus.\n\nIšvestis pagal numatymą yra PNG, taip pat galimi JPEG arba WebP. JPEG ir WebP palaikomas glaudinimas nuo 0 iki 100. Fonas gali būti nepermatomas arba automatinis; konkreti dabartinė specifikacija GPT Image 2 skaidrumą aprašo kaip bandomąją funkciją. Prašydami skaidrumo naudokite PNG arba WebP, kad būtų galima išlaikyti alfa kanalą. Dokumentuota srautinė eiga leidžia iki trijų dalinių vaizdų prieš užbaigtą vaizdą; išsaugokite galutinę medžiagą, o ne pažangos peržiūrą. Gamintojo sąsaja taip pat palaiko paketinį apdorojimą.\n\nTikrame rezultate įvertinkite teksto aiškumą, objektų vietą ir šaltinio detalių išsaugojimą. Modeliui GPT Image gali būti sunku tiksliai atvaizduoti raides, kurti išdėstymui jautrias kompozicijas ir išlaikyti pasikartojančią vizualinę tapatybę tarp atskirų generavimų. Redagavimų sekai pasirinktą rezultatą naudokite kaip kitą šaltinį ir pateikite konkretų pakeitimą, susietą su matomu trūkumu. Naudinga GPT Image 2 išvestis yra vaizdas, susietas su aiškiu generavimo ar redagavimo aprašu, o didelio tikslumo įvestys, matmenys ir kokybė parinkti būtent tai užduočiai.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "2665b80c3bcbcffcd350b3c454cbd5952f677f534b72d721e74276fc9ef72e76", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "lt", "methods": [ { "html": "gpt-image-2GPT Image 2 generuoja ir redaguoja vaizdus iš teksto bei vaizdinių etalonų. Jis palaiko lanksčius kadro matmenis ir automatiškai apdoroja vaizdų įvestį dideliu tikslumu, siūlydamas atskirus galutinės medžiagos kokybės, formato ir fono valdiklius.
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
GPT Image 2 yra OpenAI modelis vaizdams generuoti ir redaguoti iš teksto bei vaizdinės įvesties. Jis kuria naują vaizdą iš rašytinio aprašo ir gali naudoti šaltinio vaizdus redagavimui ar etalonais grindžiamam darbui. Praktinės užduotys apima iliustracijas, produktų koncepcijas, vizualines kompozicijas ir esamos medžiagos pakeitimus. Tai atskira versija nuo GPT Image 2.5 Sunburst ir Flare modelių, turinti savo kokybės diapazoną ir įvesties tikslumo elgesį.
Generavimui aprašykite objektą, sceną, kompoziciją, šviesą ir norimą stilių. Redagavimui įvardykite, kas turi keistis ir kas išlaikyti išvaizdą. Produkto aprašas gali prašyti keramikinio šviestuvo ant šviesaus paviršiaus su centruotu siluetu ir vieta užrašui; tolesnis redagavimas gali pakeisti foną, išsaugodamas šviestuvo formą ir žiūrėjimo kampą. Dokumentuotos tiesioginės generavimo ir redagavimo eigos priima iki 32 000 simbolių užklausas ir gali pateikti nuo vieno iki dešimties vaizdų.
Redagavimas pagal etalonus priima iki šešiolikos įvesties vaizdų. Nurodykite kiekvieno etalono paskirtį, kad objektas, fonas ir vizualinis apdorojimas nebūtų supainioti. GPT Image 2 automatiškai apdoroja kiekvieną vaizdo įvestį dideliu tikslumu; input_fidelity reikia praleisti, nes šioje versijoje jis nereguliuojamas. Tai skiriasi nuo GPT Image 1 high arba low pasirinkimo ir tik low įvesties tikslumo režimo GPT Image 1 Mini. Didelio tikslumo įvesties apdorojimas padeda šaltinio detalėms, bet negarantuoja, kad kiekviena detalė bus atkurta nepakeista.
Kaukė gali identifikuoti redaguojamą sritį. Šaltinio vaizdas ir kaukė turi būti to paties formato bei matmenų ir pagal vadovo paruošimo reikalavimus mažesni nei 50 MB; kaukei taip pat reikia alfa kanalo. Jei pateikti keli įvesties vaizdai, kaukė taikoma pirmajam. Modelis kaukę laiko užklausa grindžiama gaire, o ne griežta geometrine riba. Aprašykite vietinį pakeitimą ir išsaugojimo reikalavimus, tada patikrinkite aplinkinę sritį dėl netyčinių skirtumų.
GPT Image 2 palaiko low, medium, high ir auto kokybę; numatytoji – auto. 2.5 šeimos xhigh ir max nuostatos nepriklauso šios versijos kokybės diapazonui. Dydis gali būti kvadratinis, horizontalus, vertikalus, automatinis arba tinkamas individualus plotis ir aukštis. Gamintojo pavyzdžiai apima 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 ir 2160 × 3840 pikselių. Orientaciją ir detalumo lygį rinkitės tikram maketui, užuot laikę kokybę bei matmenis tuo pačiu valdikliu.
Individualūs matmenys turi būti šešiolikos pikselių kartotiniai, su didžiausia 3840 pikselių kraštine, ilgosios ir trumposios kraštinių santykiu ne daugiau kaip 3:1 ir plotu nuo 655 360 iki 8 294 400 pikselių. Šios sąlygos galioja vienu metu. Didesnės nei 2560 × 1440 raiškos pažymėtos kaip eksperimentinės. Vieną taisyklę atitinkantis kadras gali pažeisti kitą, todėl pasirinkite palaikomą matmenų porą ir apraše nurodykite apkirpimui jautrius elementus.
Išvestis pagal numatymą yra PNG, taip pat galimi JPEG arba WebP. JPEG ir WebP palaikomas glaudinimas nuo 0 iki 100. Fonas gali būti nepermatomas arba automatinis; konkreti dabartinė specifikacija GPT Image 2 skaidrumą aprašo kaip bandomąją funkciją. Prašydami skaidrumo naudokite PNG arba WebP, kad būtų galima išlaikyti alfa kanalą. Dokumentuota srautinė eiga leidžia iki trijų dalinių vaizdų prieš užbaigtą vaizdą; išsaugokite galutinę medžiagą, o ne pažangos peržiūrą. Gamintojo sąsaja taip pat palaiko paketinį apdorojimą.
Tikrame rezultate įvertinkite teksto aiškumą, objektų vietą ir šaltinio detalių išsaugojimą. Modeliui GPT Image gali būti sunku tiksliai atvaizduoti raides, kurti išdėstymui jautrias kompozicijas ir išlaikyti pasikartojančią vizualinę tapatybę tarp atskirų generavimų. Redagavimų sekai pasirinktą rezultatą naudokite kaip kitą šaltinį ir pateikite konkretų pakeitimą, susietą su matomu trūkumu. Naudinga GPT Image 2 išvestis yra vaizdas, susietas su aiškiu generavimo ar redagavimo aprašu, o didelio tikslumo įvestys, matmenys ir kokybė parinkti būtent tai užduočiai.
POST /v1/images/generationstextimage| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos gpt-image-2 | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias ilgis: 1 | Numatyta— |
Laukasn | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 1 | Numatyta1 |
Laukasresponse_format | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos url, b64_json | Numatyta— |
Laukasstream | Tipasboolean | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatytafalse |
Laukassize | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasquality | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasbackground | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasoutput_format | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasoutput_compression | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasmoderation | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasinput_fidelity | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasstyle | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukaspartial_images | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Iš teksto į vaizdą · Privaloma: prompt
| Parametras | Specifikacija |
|---|---|
Parametrasmaterial_types | Specifikacijatext |
Parametrasrequired | Specifikacijamodel, prompt |
Parametrasoptional_controls | Specifikacijanull |
Parametrascontent_type | Specifikacijaapplication/json |
Gyvavimo ciklas: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · faktiškai grąžinta task_id reikšmė arba medijos bibliotekos įrašas
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Metodų struktūros ir ID yra tikslūs; tiekėjo galimybės yra atskirtos nuo užklausos priėmimo.
POST /v1/images/generationsAiloot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
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-2", "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-2', '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-2", "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");\nAtsisiųskite kiekvieną grąžintą vaizdą arba išsaugokite jo Base64 turinį
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Išsaugokite kiekvieną baigtą vaizdą; gaukite turinį iš kiekvieno grąžinto URL arba dekoduokite jo Base64 turinį.
Išsaugokite kiekvieną duomenų elementą. Iškoduokite kiekvieną b64_json arba atsisiųskite turinį pagal kiekvieną grąžintą pasirašytą URL. Failo plėtinį pasirinkite pagal faktinį MIME tipą ir baitus.
Jei vaizdo generavimo ar redagavimo rezultatą reikia patikrinti, išsaugokite pradinį operation_id/X-Client-Request-ID ir grąžintą informaciją apie rezultatą. Atkurkite prieigą prie esamų jums priklausančių rezultatų per medijos biblioteką, naudodami faktines task_id arba asset_id reikšmes. Pakartotinai neteikite generavimo ar redagavimo užklausos ir nekurkite būsenos tikrinimo URL iš operation_id.
| Laukas | Tipas |
|---|---|
Laukascreated | Tipasinteger |
Laukasdata[].url | Tipasstring |
Laukasdata[].b64_json | Tipasbase64 string |
Laukasusage | Tipasobject |
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas400 · invalid_request_error | SąlygaNetinkami privalomi laukai, medžiagos pateikimo forma arba parametro reikšmė | Kitas žingsnisPrieš naują kūrimo užklausą pataisykite nurodytus laukus. |
Atsakymasserver_error | SąlygaGrąžintame atsakyme nurodoma, kad operaciją arba rezultatą reikia patikrinti | Kitas žingsnisIšsaugokite pradinį grąžintą operacijos ar užduoties ID, užklausos antraštes ir atsakymą; toliau tikrinkite tos pačios pradinės operacijos duomenis palaikomais būdais. Kūrimo užklausos pakartotinai neteikite. |
Ailoot gpt-image-2
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images
gpt-image-2GPT Image 2 generuoja ir redaguoja vaizdus iš teksto bei vaizdinių etalonų. Jis palaiko lanksčius kadro matmenis ir automatiškai apdoroja vaizdų įvestį dideliu tikslumu, siūlydamas atskirus galutinės medžiagos kokybės, formato ir fono valdiklius.
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
GPT Image 2 yra OpenAI modelis vaizdams generuoti ir redaguoti iš teksto bei vaizdinės įvesties. Jis kuria naują vaizdą iš rašytinio aprašo ir gali naudoti šaltinio vaizdus redagavimui ar etalonais grindžiamam darbui. Praktinės užduotys apima iliustracijas, produktų koncepcijas, vizualines kompozicijas ir esamos medžiagos pakeitimus. Tai atskira versija nuo GPT Image 2.5 Sunburst ir Flare modelių, turinti savo kokybės diapazoną ir įvesties tikslumo elgesį.
Generavimui aprašykite objektą, sceną, kompoziciją, šviesą ir norimą stilių. Redagavimui įvardykite, kas turi keistis ir kas išlaikyti išvaizdą. Produkto aprašas gali prašyti keramikinio šviestuvo ant šviesaus paviršiaus su centruotu siluetu ir vieta užrašui; tolesnis redagavimas gali pakeisti foną, išsaugodamas šviestuvo formą ir žiūrėjimo kampą. Dokumentuotos tiesioginės generavimo ir redagavimo eigos priima iki 32 000 simbolių užklausas ir gali pateikti nuo vieno iki dešimties vaizdų.
Redagavimas pagal etalonus priima iki šešiolikos įvesties vaizdų. Nurodykite kiekvieno etalono paskirtį, kad objektas, fonas ir vizualinis apdorojimas nebūtų supainioti. GPT Image 2 automatiškai apdoroja kiekvieną vaizdo įvestį dideliu tikslumu; input_fidelity reikia praleisti, nes šioje versijoje jis nereguliuojamas. Tai skiriasi nuo GPT Image 1 high arba low pasirinkimo ir tik low įvesties tikslumo režimo GPT Image 1 Mini. Didelio tikslumo įvesties apdorojimas padeda šaltinio detalėms, bet negarantuoja, kad kiekviena detalė bus atkurta nepakeista.
Kaukė gali identifikuoti redaguojamą sritį. Šaltinio vaizdas ir kaukė turi būti to paties formato bei matmenų ir pagal vadovo paruošimo reikalavimus mažesni nei 50 MB; kaukei taip pat reikia alfa kanalo. Jei pateikti keli įvesties vaizdai, kaukė taikoma pirmajam. Modelis kaukę laiko užklausa grindžiama gaire, o ne griežta geometrine riba. Aprašykite vietinį pakeitimą ir išsaugojimo reikalavimus, tada patikrinkite aplinkinę sritį dėl netyčinių skirtumų.
GPT Image 2 palaiko low, medium, high ir auto kokybę; numatytoji – auto. 2.5 šeimos xhigh ir max nuostatos nepriklauso šios versijos kokybės diapazonui. Dydis gali būti kvadratinis, horizontalus, vertikalus, automatinis arba tinkamas individualus plotis ir aukštis. Gamintojo pavyzdžiai apima 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 ir 2160 × 3840 pikselių. Orientaciją ir detalumo lygį rinkitės tikram maketui, užuot laikę kokybę bei matmenis tuo pačiu valdikliu.
Individualūs matmenys turi būti šešiolikos pikselių kartotiniai, su didžiausia 3840 pikselių kraštine, ilgosios ir trumposios kraštinių santykiu ne daugiau kaip 3:1 ir plotu nuo 655 360 iki 8 294 400 pikselių. Šios sąlygos galioja vienu metu. Didesnės nei 2560 × 1440 raiškos pažymėtos kaip eksperimentinės. Vieną taisyklę atitinkantis kadras gali pažeisti kitą, todėl pasirinkite palaikomą matmenų porą ir apraše nurodykite apkirpimui jautrius elementus.
Išvestis pagal numatymą yra PNG, taip pat galimi JPEG arba WebP. JPEG ir WebP palaikomas glaudinimas nuo 0 iki 100. Fonas gali būti nepermatomas arba automatinis; konkreti dabartinė specifikacija GPT Image 2 skaidrumą aprašo kaip bandomąją funkciją. Prašydami skaidrumo naudokite PNG arba WebP, kad būtų galima išlaikyti alfa kanalą. Dokumentuota srautinė eiga leidžia iki trijų dalinių vaizdų prieš užbaigtą vaizdą; išsaugokite galutinę medžiagą, o ne pažangos peržiūrą. Gamintojo sąsaja taip pat palaiko paketinį apdorojimą.
Tikrame rezultate įvertinkite teksto aiškumą, objektų vietą ir šaltinio detalių išsaugojimą. Modeliui GPT Image gali būti sunku tiksliai atvaizduoti raides, kurti išdėstymui jautrias kompozicijas ir išlaikyti pasikartojančią vizualinę tapatybę tarp atskirų generavimų. Redagavimų sekai pasirinktą rezultatą naudokite kaip kitą šaltinį ir pateikite konkretų pakeitimą, susietą su matomu trūkumu. Naudinga GPT Image 2 išvestis yra vaizdas, susietas su aiškiu generavimo ar redagavimo aprašu, o didelio tikslumo įvestys, matmenys ir kokybė parinkti būtent tai užduočiai.
POST /v1/images/generationstextimage| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos gpt-image-2 | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos Didžiausias ilgis: 32 000 | Numatyta— |
Laukassize | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Sąlygos: Naudokite auto arba WIDTHxHEIGHT, kai abu matmenys dalijasi iš 16. Ilgiausia kraštinė negali viršyti 3,840 pikselių, o bendras dydis – 8,300,000 pikselių. | Numatytaauto |
Laukasbackground | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos transparent, opaque, auto | Numatytaauto |
Laukasmoderation | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos low, auto Sąlygos: Įprastam turinio moderavimui naudokite auto. | Numatyta— |
Laukasn | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 1 Didžiausia reikšmė: 10 | Numatyta1 |
Laukasquality | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos auto, high, medium, low | Numatytaauto |
Laukasoutput_compression | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 0 Didžiausia reikšmė: 100 Sąlygos: Taikoma JPEG ir WebP išvesčiai; siųskite dokumentacijoje nurodytą sveikąjį skaičių. | Numatyta100 |
Laukasoutput_format | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos webp, png, jpeg | Numatytapng |
Laukasstream | Tipasboolean | ReikalavimasNeprivaloma | Reikšmės ir ribos false Sąlygos: Šis maršrutas grąžina vieną užbaigtą JSON atsakymą. | Numatytafalse |
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijaprompt, model |
Parametrasmaterial_types | Specifikacijatext |
Parametrasoptional | Specifikacijasize, background, moderation, n, quality, output_compression, output_format, stream |
Parametrasconditions | SpecifikacijaSkaidriam fonui reikia PNG arba WebP., Išvesties glaudinimas taikomas JPEG arba WebP., Pasirinktas metodas generuoja iš teksto. Gamintojo aprašyti redagavimo ir srautinės išvesties valdikliai yra atskiros galimybės. |
Gyvavimo ciklas: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · faktiškai grąžinta task_id reikšmė arba medijos bibliotekos įrašas
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.
Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Įkainių lentelė | Numatomas kiekis | Mokestis |
|---|---|---|---|
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Numatomas kiekis— | Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų |
| KonfigūracijaNumatoma generavimo kaina | Įkainių lentelė— | Numatomas kiekisvieno generavimo įvertis | Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $0.24576 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis. |
Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
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-2', '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\nAtsisiųskite kiekvieną grąžintą vaizdą arba išsaugokite jo Base64 turinį
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.\nIšsaugokite kiekvieną baigtą vaizdą; gaukite turinį iš kiekvieno grąžinto URL arba dekoduokite jo Base64 turinį.
Išsaugokite visą atsakymą ir antraštes, visus faktiškai gautus rezultatus, pradinius grąžintus identifikatorius ir visus naudojimo apskaitos laukus. Atkurkite prieigą prie pradinės operacijos pakartotinai neteikdami kūrimo užklausos.
Išsaugokite grąžintą X-Client-Request-ID duomenims sutikrinti. Tikrinkite tik faktiškai grąžintas task_id/asset_id reikšmes arba jums priklausančią medijos biblioteką; niekada nekurkite užduoties URL iš operacijos ID ir niekada pakartotinai neteikite kūrimo užklausos.
| Laukas | Tipas |
|---|---|
Laukascreated | Tipas |
Laukasdata[].url | Tipas |
Laukasdata[].b64_json | Tipas |
Laukasusage | Tipas |
Ailoot gpt-image-2
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images
openai/gpt-image-2GPT Image 2 generuoja ir redaguoja vaizdus iš teksto bei vaizdinių etalonų. Jis palaiko lanksčius kadro matmenis ir automatiškai apdoroja vaizdų įvestį dideliu tikslumu, siūlydamas atskirus galutinės medžiagos kokybės, formato ir fono valdiklius.
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
GPT Image 2 yra OpenAI modelis vaizdams generuoti ir redaguoti iš teksto bei vaizdinės įvesties. Jis kuria naują vaizdą iš rašytinio aprašo ir gali naudoti šaltinio vaizdus redagavimui ar etalonais grindžiamam darbui. Praktinės užduotys apima iliustracijas, produktų koncepcijas, vizualines kompozicijas ir esamos medžiagos pakeitimus. Tai atskira versija nuo GPT Image 2.5 Sunburst ir Flare modelių, turinti savo kokybės diapazoną ir įvesties tikslumo elgesį.
Generavimui aprašykite objektą, sceną, kompoziciją, šviesą ir norimą stilių. Redagavimui įvardykite, kas turi keistis ir kas išlaikyti išvaizdą. Produkto aprašas gali prašyti keramikinio šviestuvo ant šviesaus paviršiaus su centruotu siluetu ir vieta užrašui; tolesnis redagavimas gali pakeisti foną, išsaugodamas šviestuvo formą ir žiūrėjimo kampą. Dokumentuotos tiesioginės generavimo ir redagavimo eigos priima iki 32 000 simbolių užklausas ir gali pateikti nuo vieno iki dešimties vaizdų.
Redagavimas pagal etalonus priima iki šešiolikos įvesties vaizdų. Nurodykite kiekvieno etalono paskirtį, kad objektas, fonas ir vizualinis apdorojimas nebūtų supainioti. GPT Image 2 automatiškai apdoroja kiekvieną vaizdo įvestį dideliu tikslumu; input_fidelity reikia praleisti, nes šioje versijoje jis nereguliuojamas. Tai skiriasi nuo GPT Image 1 high arba low pasirinkimo ir tik low įvesties tikslumo režimo GPT Image 1 Mini. Didelio tikslumo įvesties apdorojimas padeda šaltinio detalėms, bet negarantuoja, kad kiekviena detalė bus atkurta nepakeista.
Kaukė gali identifikuoti redaguojamą sritį. Šaltinio vaizdas ir kaukė turi būti to paties formato bei matmenų ir pagal vadovo paruošimo reikalavimus mažesni nei 50 MB; kaukei taip pat reikia alfa kanalo. Jei pateikti keli įvesties vaizdai, kaukė taikoma pirmajam. Modelis kaukę laiko užklausa grindžiama gaire, o ne griežta geometrine riba. Aprašykite vietinį pakeitimą ir išsaugojimo reikalavimus, tada patikrinkite aplinkinę sritį dėl netyčinių skirtumų.
GPT Image 2 palaiko low, medium, high ir auto kokybę; numatytoji – auto. 2.5 šeimos xhigh ir max nuostatos nepriklauso šios versijos kokybės diapazonui. Dydis gali būti kvadratinis, horizontalus, vertikalus, automatinis arba tinkamas individualus plotis ir aukštis. Gamintojo pavyzdžiai apima 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 ir 2160 × 3840 pikselių. Orientaciją ir detalumo lygį rinkitės tikram maketui, užuot laikę kokybę bei matmenis tuo pačiu valdikliu.
Individualūs matmenys turi būti šešiolikos pikselių kartotiniai, su didžiausia 3840 pikselių kraštine, ilgosios ir trumposios kraštinių santykiu ne daugiau kaip 3:1 ir plotu nuo 655 360 iki 8 294 400 pikselių. Šios sąlygos galioja vienu metu. Didesnės nei 2560 × 1440 raiškos pažymėtos kaip eksperimentinės. Vieną taisyklę atitinkantis kadras gali pažeisti kitą, todėl pasirinkite palaikomą matmenų porą ir apraše nurodykite apkirpimui jautrius elementus.
Išvestis pagal numatymą yra PNG, taip pat galimi JPEG arba WebP. JPEG ir WebP palaikomas glaudinimas nuo 0 iki 100. Fonas gali būti nepermatomas arba automatinis; konkreti dabartinė specifikacija GPT Image 2 skaidrumą aprašo kaip bandomąją funkciją. Prašydami skaidrumo naudokite PNG arba WebP, kad būtų galima išlaikyti alfa kanalą. Dokumentuota srautinė eiga leidžia iki trijų dalinių vaizdų prieš užbaigtą vaizdą; išsaugokite galutinę medžiagą, o ne pažangos peržiūrą. Gamintojo sąsaja taip pat palaiko paketinį apdorojimą.
Tikrame rezultate įvertinkite teksto aiškumą, objektų vietą ir šaltinio detalių išsaugojimą. Modeliui GPT Image gali būti sunku tiksliai atvaizduoti raides, kurti išdėstymui jautrias kompozicijas ir išlaikyti pasikartojančią vizualinę tapatybę tarp atskirų generavimų. Redagavimų sekai pasirinktą rezultatą naudokite kaip kitą šaltinį ir pateikite konkretų pakeitimą, susietą su matomu trūkumu. Naudinga GPT Image 2 išvestis yra vaizdas, susietas su aiškiu generavimo ar redagavimo aprašu, o didelio tikslumo įvestys, matmenys ir kokybė parinkti būtent tai užduočiai.
POST /v1/images/generationstext, imageimage| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos openai/gpt-image-2 | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias ilgis: 1 | Numatyta— |
Laukasaspect_ratio | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto | Numatyta— |
Laukasquality | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos auto, low, medium, high | Numatyta— |
Laukasbackground | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos auto, opaque | Numatyta— |
Laukasn | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 1 Didžiausia reikšmė: 10 | Numatyta— |
Laukasinput_references | Tipasarray | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausias elementų skaičius: 0 Didžiausias elementų skaičius: 16 | Numatyta— |
Laukasoutput_compression | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 0 Didžiausia reikšmė: 100 | Numatyta— |
Laukasprovider | Tipasobject | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, prompt |
Parametrasmaterial_types | Specifikacijatext, image |
Gyvavimo ciklas: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · faktiškai grąžinta task_id reikšmė arba medijos bibliotekos įrašas
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.
Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Įkainių lentelė | Numatomas kiekis | Mokestis |
|---|---|---|---|
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Numatomas kiekis— | Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų |
| KonfigūracijaNumatoma generavimo kaina | Įkainių lentelė— | Numatomas kiekisvieno generavimo įvertis | Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $0.24576 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis. |
Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
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': 'openai/gpt-image-2', '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\nAtsisiųskite kiekvieną grąžintą vaizdą arba išsaugokite jo Base64 turinį
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.\nIšsaugokite kiekvieną baigtą vaizdą; gaukite turinį iš kiekvieno grąžinto URL arba dekoduokite jo Base64 turinį.
Išsaugokite visą atsakymą ir antraštes, visus faktiškai gautus rezultatus, pradinius grąžintus identifikatorius ir visus naudojimo apskaitos laukus. Atkurkite prieigą prie pradinės operacijos pakartotinai neteikdami kūrimo užklausos.
Išsaugokite grąžintą X-Client-Request-ID duomenims sutikrinti. Tikrinkite tik faktiškai grąžintas task_id/asset_id reikšmes arba jums priklausančią medijos biblioteką; niekada nekurkite užduoties URL iš operacijos ID ir niekada pakartotinai neteikite kūrimo užklausos.
| Laukas | Tipas |
|---|---|
Laukascreated | Tipas |
Laukasdata[].url | Tipas |
Laukasdata[].b64_json | Tipas |
Laukasusage | Tipas |
Ailoot gpt-image-2
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images