O GPT Image 1.5 é um modelo da OpenAI para criar imagens a partir de uma descrição em texto. O fabricante destaca o cumprimento de instruções e o tratamento de pedidos detalhados: estes podem definir o conteúdo da cena, a composição, o aspeto dos objetos e o estilo pretendido. O resultado do método de imagens é uma imagem pronta.
Na Ailoot, esta ficha refere-se à geração com entrada de texto. A OpenAI descreve também o trabalho do modelo com imagens de origem, edição e alteração de áreas específicas. Estas capacidades exigem suporte separado de entrada visual e não fazem parte da forma de geração a partir de texto aqui indicada.
Na operação de edição separada prevista pela OpenAI, a máscara serve de orientação: não é garantida uma correspondência exata entre o resultado e os seus contornos. Esta operação exige suporte para enviar a imagem de origem; a ficha Ailoot atual continua a referir-se à geração com entrada de texto.
Estão previstos o tamanho quadrado 1024x1024, o horizontal 1536x1024 e o vertical 1024x1536, bem como a seleção automática. Não se devem aplicar a esta versão dimensões arbitrárias de outros modelos.
Os níveis de qualidade são low, medium, high e auto. A escolha da qualidade influencia o volume de processamento e o detalhe do resultado. A qualidade e as dimensões são configurações diferentes: a orientação do enquadramento determina o espaço da composição, enquanto o nível de qualidade define o modo como é formada. Os níveis xhigh e max não estão anunciados para o GPT Image 1.5.
Por predefinição, o resultado é criado em PNG; estão também previstos JPEG e WebP. Para JPEG e WebP, pode definir-se o grau de compressão. Esta configuração do ficheiro de resultado é distinta da qualidade de geração.
O fabricante prevê fundos transparentes e opacos, bem como a seleção automática. A transparência exige PNG ou WebP: JPEG não preserva o canal alfa. Um fundo transparente é conveniente quando a imagem se destina a ser utilizada como um objeto separado numa composição posterior. O suporte dos parâmetros concretos deve ser considerado em função do método escolhido.
O modelo pode incluir texto na imagem e compor uma cena com vários elementos, mas não garante a posição exata do texto e dos objetos. A consistência do aspeto de uma personagem ou do grafismo entre gerações separadas também exige controlo.
Uma imagem complexa pode demorar mais a ser gerada do que uma simples; segundo a OpenAI, algumas tarefas complexas podem demorar até dois minutos. Para o resultado, são importantes tanto a completude da descrição de origem como a verificação da imagem pronta: a legibilidade do texto, a posição dos pormenores e a correspondência com a cena pedida são avaliadas no próprio ficheiro.
", "aboutText": "### Uma imagem a partir de instruções detalhadas\n\nO GPT Image 1.5 é um modelo da OpenAI para criar imagens a partir de uma descrição em texto. O fabricante destaca o cumprimento de instruções e o tratamento de pedidos detalhados: estes podem definir o conteúdo da cena, a composição, o aspeto dos objetos e o estilo pretendido. O resultado do método de imagens é uma imagem pronta.\n\nNa Ailoot, esta ficha refere-se à geração com entrada de texto. A OpenAI descreve também o trabalho do modelo com imagens de origem, edição e alteração de áreas específicas. Estas capacidades exigem suporte separado de entrada visual e não fazem parte da forma de geração a partir de texto aqui indicada.\n\nNa operação de edição separada prevista pela OpenAI, a máscara serve de orientação: não é garantida uma correspondência exata entre o resultado e os seus contornos. Esta operação exige suporte para enviar a imagem de origem; a ficha Ailoot atual continua a referir-se à geração com entrada de texto.\n\n### Três formatos de enquadramento e configuração da qualidade\n\nEstão previstos o tamanho quadrado `1024x1024`, o horizontal `1536x1024` e o vertical `1024x1536`, bem como a seleção automática. Não se devem aplicar a esta versão dimensões arbitrárias de outros modelos.\n\nOs níveis de qualidade são `low`, `medium`, `high` e `auto`. A escolha da qualidade influencia o volume de processamento e o detalhe do resultado. A qualidade e as dimensões são configurações diferentes: a orientação do enquadramento determina o espaço da composição, enquanto o nível de qualidade define o modo como é formada. Os níveis `xhigh` e `max` não estão anunciados para o GPT Image 1.5.\n\n### Formato do ficheiro e fundo\n\nPor predefinição, o resultado é criado em PNG; estão também previstos JPEG e WebP. Para JPEG e WebP, pode definir-se o grau de compressão. Esta configuração do ficheiro de resultado é distinta da qualidade de geração.\n\nO fabricante prevê fundos transparentes e opacos, bem como a seleção automática. A transparência exige PNG ou WebP: JPEG não preserva o canal alfa. Um fundo transparente é conveniente quando a imagem se destina a ser utilizada como um objeto separado numa composição posterior. O suporte dos parâmetros concretos deve ser considerado em função do método escolhido.\n\n### O texto e a composição exigem verificação\n\nO modelo pode incluir texto na imagem e compor uma cena com vários elementos, mas não garante a posição exata do texto e dos objetos. A consistência do aspeto de uma personagem ou do grafismo entre gerações separadas também exige controlo.\n\nUma imagem complexa pode demorar mais a ser gerada do que uma simples; segundo a OpenAI, algumas tarefas complexas podem demorar até dois minutos. Para o resultado, são importantes tanto a completude da descrição de origem como a verificação da imagem pronta: a legibilidade do texto, a posição dos pormenores e a correspondência com a cena pedida são avaliadas no próprio ficheiro.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "6ef97cd0685488d42cd46f1a032e54238157c0ef908821dc1ae8b25ef2fc9a0b", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pt-pt", "methods": [ { "html": "gpt-image-1.5O GPT Image 1.5 cria imagens a partir de instruções em texto, com especial atenção ao cumprimento de indicações detalhadas. Estão previstos três formatos de enquadramento, vários níveis de qualidade e formatos de resultado.
Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.
O GPT Image 1.5 é um modelo da OpenAI para criar imagens a partir de uma descrição em texto. O fabricante destaca o cumprimento de instruções e o tratamento de pedidos detalhados: estes podem definir o conteúdo da cena, a composição, o aspeto dos objetos e o estilo pretendido. O resultado do método de imagens é uma imagem pronta.
Na Ailoot, esta ficha refere-se à geração com entrada de texto. A OpenAI descreve também o trabalho do modelo com imagens de origem, edição e alteração de áreas específicas. Estas capacidades exigem suporte separado de entrada visual e não fazem parte da forma de geração a partir de texto aqui indicada.
Na operação de edição separada prevista pela OpenAI, a máscara serve de orientação: não é garantida uma correspondência exata entre o resultado e os seus contornos. Esta operação exige suporte para enviar a imagem de origem; a ficha Ailoot atual continua a referir-se à geração com entrada de texto.
Estão previstos o tamanho quadrado 1024x1024, o horizontal 1536x1024 e o vertical 1024x1536, bem como a seleção automática. Não se devem aplicar a esta versão dimensões arbitrárias de outros modelos.
Os níveis de qualidade são low, medium, high e auto. A escolha da qualidade influencia o volume de processamento e o detalhe do resultado. A qualidade e as dimensões são configurações diferentes: a orientação do enquadramento determina o espaço da composição, enquanto o nível de qualidade define o modo como é formada. Os níveis xhigh e max não estão anunciados para o GPT Image 1.5.
Por predefinição, o resultado é criado em PNG; estão também previstos JPEG e WebP. Para JPEG e WebP, pode definir-se o grau de compressão. Esta configuração do ficheiro de resultado é distinta da qualidade de geração.
O fabricante prevê fundos transparentes e opacos, bem como a seleção automática. A transparência exige PNG ou WebP: JPEG não preserva o canal alfa. Um fundo transparente é conveniente quando a imagem se destina a ser utilizada como um objeto separado numa composição posterior. O suporte dos parâmetros concretos deve ser considerado em função do método escolhido.
O modelo pode incluir texto na imagem e compor uma cena com vários elementos, mas não garante a posição exata do texto e dos objetos. A consistência do aspeto de uma personagem ou do grafismo entre gerações separadas também exige controlo.
Uma imagem complexa pode demorar mais a ser gerada do que uma simples; segundo a OpenAI, algumas tarefas complexas podem demorar até dois minutos. Para o resultado, são importantes tanto a completude da descrição de origem como a verificação da imagem pronta: a legibilidade do texto, a posição dos pormenores e a correspondência com a cena pedida são avaliadas no próprio ficheiro.
POST /v1/images/generationstextimage| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites gpt-image-1.5 | Predefinição— |
Campoprompt | Tipostring | RequisitoObrigatório | Valores e limites Comprimento mínimo: 1 | Predefinição— |
Campon | Tipointeger | RequisitoOpcional | Valores e limites Mínimo: 1 | Predefinição1 |
Camporesponse_format | Tipostring | RequisitoOpcional | Valores e limites url, b64_json | Predefinição— |
Campostream | Tipoboolean | RequisitoOpcional | Valores e limites | Predefiniçãofalse |
Camposize | Tipostring | RequisitoOpcional | Valores e limites Depende do modelo | Predefinição— |
Campoquality | Tipostring | RequisitoOpcional | Valores e limites Depende do modelo | Predefinição— |
Campobackground | Tipostring | RequisitoOpcional | Valores e limites Depende do modelo | Predefinição— |
Campooutput_format | Tipostring | RequisitoOpcional | Valores e limites Depende do modelo | Predefinição— |
Campooutput_compression | Tipointeger | RequisitoOpcional | Valores e limites Depende do modelo | Predefinição— |
Campomoderation | Tipostring | RequisitoOpcional | Valores e limites Depende do modelo | Predefinição— |
Campoinput_fidelity | Tipostring | RequisitoOpcional | Valores e limites Depende do modelo | Predefinição— |
Campostyle | Tipostring | RequisitoOpcional | Valores e limites Depende do modelo | Predefinição— |
Campopartial_images | Tipointeger | RequisitoOpcional | Valores e limites Depende do modelo | Predefinição— |
Texto para imagem · Obrigatório: prompt
| Parâmetro | Contrato |
|---|---|
Parâmetromaterial_types | Contratotext |
Parâmetrorequired | Contratomodel, prompt |
Parâmetrooptional_controls | Contratonull |
Parâmetrocontent_type | Contratoapplication/json |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id efetivamente devolvido ou registo na biblioteca de multimédia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
As estruturas dos métodos e os ID são exatos; a capacidade do fornecedor é distinta da admissão dos pedidos.
POST /v1/images/generationsO Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. Como funcionam a reserva e a liquidação →
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");\nDescarregue cada imagem devolvida ou guarde o respetivo conteúdo Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Guarde cada imagem concluída; obtenha cada URL devolvido ou descodifique o respetivo conteúdo Base64.
Guarde todos os itens de dados. Descodifique cada b64_json ou obtenha todos os URL assinados devolvidos. Escolha a extensão do ficheiro a partir do MIME/dos bytes reais.
Se o resultado de uma geração ou edição de imagem requerer verificação, guarde o operation_id/X-Client-Request-ID original e as informações do resultado devolvidas. Recupere os resultados existentes que lhe pertencem através da biblioteca de multimédia, usando valores task_id ou asset_id reais. Não volte a enviar o pedido de geração/edição nem construa um URL de consulta periódica a partir de operation_id.
| Campo | Tipo |
|---|---|
Campocreated | Tipointeger |
Campodata[].url | Tipostring |
Campodata[].b64_json | Tipobase64 string |
Campousage | Tipoobject |
| Resposta | Condição | Passo seguinte |
|---|---|---|
Resposta400 · invalid_request_error | CondiçãoCampos obrigatórios, representação do material ou valor do parâmetro inválidos | Passo seguinteCorrija os campos indicados antes de um novo pedido de criação. |
Respostaserver_error | CondiçãoA resposta devolvida indica que a operação ou o resultado requer verificação | Passo seguinteGuarde o ID original da operação/tarefa devolvido, os cabeçalhos do pedido e a resposta; continue a consultar essa operação original através das consultas suportadas. Não volte a enviar o pedido de criação. |
Ailoot gpt-image-1.5
Ailoot Ultra gpt-image-1.5
Use os caminhos dos métodos indicados acima.
gpt-image-1.5O GPT Image 1.5 cria imagens a partir de instruções em texto, com especial atenção ao cumprimento de indicações detalhadas. Estão previstos três formatos de enquadramento, vários níveis de qualidade e formatos de resultado.
Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.
O GPT Image 1.5 é um modelo da OpenAI para criar imagens a partir de uma descrição em texto. O fabricante destaca o cumprimento de instruções e o tratamento de pedidos detalhados: estes podem definir o conteúdo da cena, a composição, o aspeto dos objetos e o estilo pretendido. O resultado do método de imagens é uma imagem pronta.
Na Ailoot, esta ficha refere-se à geração com entrada de texto. A OpenAI descreve também o trabalho do modelo com imagens de origem, edição e alteração de áreas específicas. Estas capacidades exigem suporte separado de entrada visual e não fazem parte da forma de geração a partir de texto aqui indicada.
Na operação de edição separada prevista pela OpenAI, a máscara serve de orientação: não é garantida uma correspondência exata entre o resultado e os seus contornos. Esta operação exige suporte para enviar a imagem de origem; a ficha Ailoot atual continua a referir-se à geração com entrada de texto.
Estão previstos o tamanho quadrado 1024x1024, o horizontal 1536x1024 e o vertical 1024x1536, bem como a seleção automática. Não se devem aplicar a esta versão dimensões arbitrárias de outros modelos.
Os níveis de qualidade são low, medium, high e auto. A escolha da qualidade influencia o volume de processamento e o detalhe do resultado. A qualidade e as dimensões são configurações diferentes: a orientação do enquadramento determina o espaço da composição, enquanto o nível de qualidade define o modo como é formada. Os níveis xhigh e max não estão anunciados para o GPT Image 1.5.
Por predefinição, o resultado é criado em PNG; estão também previstos JPEG e WebP. Para JPEG e WebP, pode definir-se o grau de compressão. Esta configuração do ficheiro de resultado é distinta da qualidade de geração.
O fabricante prevê fundos transparentes e opacos, bem como a seleção automática. A transparência exige PNG ou WebP: JPEG não preserva o canal alfa. Um fundo transparente é conveniente quando a imagem se destina a ser utilizada como um objeto separado numa composição posterior. O suporte dos parâmetros concretos deve ser considerado em função do método escolhido.
O modelo pode incluir texto na imagem e compor uma cena com vários elementos, mas não garante a posição exata do texto e dos objetos. A consistência do aspeto de uma personagem ou do grafismo entre gerações separadas também exige controlo.
Uma imagem complexa pode demorar mais a ser gerada do que uma simples; segundo a OpenAI, algumas tarefas complexas podem demorar até dois minutos. Para o resultado, são importantes tanto a completude da descrição de origem como a verificação da imagem pronta: a legibilidade do texto, a posição dos pormenores e a correspondência com a cena pedida são avaliadas no próprio ficheiro.
POST /v1/images/generationstextimage| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites gpt-image-1.5 | Predefinição— |
Campoprompt | Tipostring | RequisitoObrigatório | Valores e limites Comprimento máximo: 32 000 | Predefinição— |
Camposize | Tipostring | RequisitoOpcional | Valores e limites 1024x1024, 1536x1024, 1024x1536, auto | Predefiniçãoauto |
Campobackground | Tipostring | RequisitoOpcional | Valores e limites transparent, opaque, auto | Predefiniçãoauto |
Campomoderation | Tipostring | RequisitoOpcional | Valores e limites low, auto Condições: Utilize auto para a moderação normal de conteúdo. | Predefinição— |
Campon | Tipointeger | RequisitoOpcional | Valores e limites Mínimo: 1 Máximo: 10 | Predefinição1 |
Campoquality | Tipostring | RequisitoOpcional | Valores e limites auto, high, medium, low | Predefiniçãoauto |
Campooutput_compression | Tipointeger | RequisitoOpcional | Valores e limites Mínimo: 0 Máximo: 100 Condições: Aplica-se à saída JPEG e WebP; envie o valor inteiro documentado. | Predefinição100 |
Campooutput_format | Tipostring | RequisitoOpcional | Valores e limites webp, png, jpeg | Predefiniçãopng |
Campostream | Tipoboolean | RequisitoOpcional | Valores e limites false Condições: Esta rota devolve uma única resposta JSON concluída. | Predefiniçãofalse |
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratoprompt, model |
Parâmetromaterial_types | Contratotext |
Parâmetrooptional | Contratosize, background, moderation, n, quality, output_compression, output_format, stream |
Parâmetroconditions | ContratoUm fundo transparente exige PNG ou WebP., A compressão de saída aplica-se a JPEG ou WebP., O método selecionado gera a partir de texto. Os controlos de edição e transmissão em fluxo descritos para o fabricante são capacidades separadas. |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id efetivamente devolvido ou registo na biblioteca de multimédia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
As tarifas apresentadas permitem estimar o custo antes da geração. O montante final cobrado é calculado a partir do custo registado para a geração original. A duração medida do resultado e as quantidades previstas não correspondem à quantidade final faturável.
As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado.
Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.
| Configuração | Tabela de tarifas | Quantidade prevista | Custo |
|---|---|---|---|
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | Custo Entrada · Tokens de entrada · Estimativa apenas para comparação — / 1K tokens Saída · Tokens de saída · Estimativa apenas para comparação — / 1K tokens Entrada · Leitura da cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache, 1 hora · Estimativa apenas para comparação — / 1K tokens |
| ConfiguraçãoCusto estimado de geração | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Custo Saída · Custo estimado de geração · Estimativa apenas para comparação $0.32768 estimativa antes da geração Esta estimativa não é um encargo adicional nem uma tarifa fixa para a geração concluída. |
O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. Como funcionam a reserva e a liquidação →
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\nDescarregue cada imagem devolvida ou guarde o respetivo conteúdo 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.\nGuarde cada imagem concluída; obtenha cada URL devolvido ou descodifique o respetivo conteúdo Base64.
Conserve a resposta completa e os cabeçalhos, todos os resultados efetivamente produzidos, os identificadores originais devolvidos e todos os campos de utilização. Recupere a operação original sem voltar a enviar o pedido de criação.
Guarde o X-Client-Request-ID devolvido para reconciliação. Consulte apenas os valores task_id/asset_id efetivamente devolvidos ou a sua biblioteca de multimédia; nunca construa um URL de tarefa a partir do ID da operação e nunca volte a enviar o pedido de criação.
| Campo | Tipo |
|---|---|
Campocreated | Tipo |
Campodata[].url | Tipo |
Campodata[].b64_json | Tipo |
Campousage | Tipo |
Ailoot gpt-image-1.5
Ailoot Ultra gpt-image-1.5
Use os caminhos dos métodos indicados acima.