Gerar imagens nas suas próprias ferramentas

Quero gerar imagens com os modelos GPT Image da OfoxAI. Já criei uma chave de API no console da OfoxAI. Não tenho muito conhecimento técnico; por isso, conduza-me passo a passo. Antes de cada passo, explique em linguagem simples o que você está fazendo e o que vem a seguir.

[Passo 1: ajude-me a guardar a chave com segurança]
1. Crie um arquivo .env na pasta atual contendo uma linha: OFOX_API_KEY= (deixe o valor vazio). Se a pasta atual for um repositório de código, adicione .env ao .gitignore.
2. Diga-me onde está o arquivo e como abri-lo, para que eu mesmo cole a chave depois do sinal de igual e salve.
3. Não me peça para enviar a chave neste chat. Se eu colá-la por engano, lembre-me de excluir essa chave no console e criar uma nova.
4. Aguarde até eu dizer "pronto" antes de continuar.

[Passo 2: prepare a geração de imagens]
5. Escreva um pequeno script que leia OFOX_API_KEY do .env e chame POST https://api.ofox.ai/v1/images/generations para gerar uma imagem.
6. Use o modelo openai/gpt-image-2.5-flare, quality low, size 1024x1024, e defina o timeout do cliente em 600 segundos.
7. O data[0].b64_json retornado é base64 puro. Decodifique-o e salve-o como PNG em uma pasta images dentro da pasta atual.
8. Não exiba a chave e não a escreva no script.

[Passo 3: teste uma imagem]
9. Primeiro gere "uma maçã vermelha sobre uma mesa branca" e depois me diga onde a imagem foi salva e como abri-la.
10. A partir daí, sempre que eu descrever uma imagem, gere-a com este script e diga onde foi salva. Se eu disser "qualidade mais alta", altere quality para medium ou high e lembre-me de que isso custa mais e demora mais.

[Quando algo falhar]
11. Exiba o status HTTP e o erro completo (incluindo error.message e request_id), procure a causa em https://ofox.ai/pt/docs/develop/models/gpt-image#errors e altere apenas uma coisa antes de tentar novamente.
12. Se o mesmo erro persistir após duas correções, pare, explique-me o problema em linguagem simples e informe o request_id e a mensagem de erro exata, para que eu possa contatar a OfoxAI.
13. Gere uma imagem por vez e não repita requisições em lote por conta própria (cada requisição é cobrada).

Quero adicionar a geração de imagens do GPT Image da OfoxAI a este projeto. Já criei uma chave de API no console da OfoxAI. Não tenho muito conhecimento técnico; por isso, conduza-me passo a passo. Antes de cada passo, explique em linguagem simples o que você está fazendo e o que vem a seguir.

[Passo 1: ajude-me a guardar a chave com segurança]
1. Crie um arquivo .env no projeto contendo uma linha: OFOX_API_KEY= (deixe o valor vazio).
2. Adicione .env ao .gitignore para que ele nunca seja commitado nem enviado.
3. Diga-me onde está o arquivo e como abri-lo, para que eu mesmo cole a chave depois do sinal de igual e salve.
4. Não me peça para enviar a chave neste chat. Se eu colá-la por engano, lembre-me de excluir essa chave no console e criar uma nova.
5. Aguarde até eu dizer "pronto" antes de continuar.

[Passo 2: escreva o código]
6. Use o SDK oficial da OpenAI com os endpoints de imagem da OfoxAI e base_url https://api.ofox.ai/v1, lendo a chave de OFOX_API_KEY no .env.
 - Texto para imagem: POST /v1/images/generations
 - Edição, combinação de imagens, inpainting: POST /v1/images/edits (upload multipart)
7. Use IDs de modelo completos: openai/gpt-image-2.5-flare (openai/gpt-image-2.5-sunburst para edição).
8. Sempre informe quality explicitamente; use low durante o desenvolvimento. Se omitido, o modelo escolhe o nível por conta própria.
9. size deve atender a todas as condições: largura e altura divisíveis por 16, maior lado ≤ 3840, proporção entre 1:3 e 3:1, total de pixels ≥ 655.360.
10. O resultado está em data[0].b64_json como base64 puro, sem o prefixo data:; decodifique-o e salve-o como arquivo de imagem.
11. Defina o timeout do cliente em 600 segundos.
12. Não envie response_format, input_fidelity nem style.
13. Nunca escreva a chave no código, em logs ou em mensagens de erro; oculte o cabeçalho Authorization ao exibir requisições.

[Passo 3: teste]
14. Faça uma chamada real com quality=low e size=1024x1024, confirme que ela retorna 200 e que a imagem abre, e depois me diga onde a imagem foi salva.
15. Durante os testes, gere uma imagem por vez; não escreva loops de teste em lote (cada requisição é cobrada).

[Quando algo falhar]
16. Exiba o status HTTP e o corpo completo da resposta (incluindo error.message e request_id) e procure a causa em https://ofox.ai/pt/docs/develop/models/gpt-image#errors
17. Para 429, aguarde e tente novamente; para outros erros, corrija primeiro a requisição em vez de repeti-la sem alterações.
18. Se o mesmo erro persistir após duas correções, pare, explique-me o problema em linguagem simples e informe o request_id e a mensagem de erro exata, para que eu possa contatar a OfoxAI.

[Verificação antes de publicar]
19. Quando eu disser "pronto para publicar", verifique cada item e informe o resultado: nenhuma chave no código nem no histórico de commits; .env está no .gitignore; toda requisição informa quality; o timeout é ≥ 600 segundos; os erros exibem o código de status, o texto original do erro e o request_id.

Referências:
- Valores e restrições desta família: https://ofox.ai/pt/docs/develop/models/gpt-image
- Estrutura comum dos endpoints: https://ofox.ai/pt/docs/api/openai/images