> ## Documentation Index > Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt > Use this file to discover all available pages before exploring further. # Use uma API GPT Image de terceiros mantendo o login no Codex > Mantenha o login e o chat do Codex enquanto um Skill separado usa a BetterToken GPT Image API. Veja instalação, geração, edição e solução de erros comuns. Use um Skill de imagens separado: o Codex continua conversando pela sua conta oficial, enquanto o Skill chama a API com a BetterToken API Key e salva o resultado localmente. As imagens são cobradas conforme os preços atuais do BetterToken. Este guia usa o projeto comunitário [Wangnov/gpt-image-2-skill](https://github.com/Wangnov/gpt-image-2-skill). A configuração independente de imagens compatível com OpenAI permite manter o modelo do chat e os arquivos de login. Depois, peça imagens e edições em linguagem natural. ## Prepare o Codex e uma API Key 1. Entre com sua conta oficial no Codex App ou Codex CLI local e abra um projeto. 2. Crie uma BetterToken API Key ou use uma existente. 3. Confira o modelo e o preço atual no model plaza. Comece com `gpt-image-2`. O Codex precisa executar scripts locais e acessar `bettertoken.ai`. Este fluxo usa App e CLI locais; tarefas na nuvem precisam de ambiente e credenciais próprios. ## Etapa 1: envie a instrução de instalação Copie toda a instrução. Ela contém um marcador, então você ainda não precisa compartilhar uma chave real. ```text theme={null} Instale e configure um Skill independente de imagens para meu Codex local. Repositório: https://github.com/Wangnov/gpt-image-2-skill Subdiretório: skills/gpt-image-2-skill Instale em meu diretório de usuário .agents/skills/gpt-image-2-skill; confira e reutilize uma instalação existente. Mantenha meu login oficial, modelo do chat, config.toml, auth.json e OPENAI_API_KEY. Confira Node.js e prepare o runtime publicado para meu sistema conforme o wrapper Node do repositório. Não exija um ambiente de desenvolvimento Rust. Salve as configurações em gpt-image-2-skill/config.json no CODEX_HOME atual; se não estiver definido, use ~/.codex/gpt-image-2-skill/config.json. Combine configurações existentes e preserve outras entradas. Adicione o serviço bettertoken-image: type = openai-compatible api_base = https://bettertoken.ai/v1 model = gpt-image-2 credentials.api_key = {"source":"file","value":"YOUR_BETTERTOKEN_API_KEY"} Defina default_provider deste Skill como bettertoken-image. Passe explicitamente --provider bettertoken-image para gerar e editar. Não use --provider codex, a ferramenta oficial integrada ou outros serviços de imagens. Deixe a chave como marcador para eu preencher localmente; não peça a chave real no chat. Agora apenas instale e verifique a configuração, sem pedidos pagos de imagens. Informe os caminhos absolutos do Skill e da configuração, a Base URL e o Model ID. Não mostre a chave. ``` Se faltar Node.js, siga as instruções do Codex para instalar Node.js LTS. O wrapper normalmente baixa o runtime publicado para seu sistema. ## Etapa 2: preencha a chave localmente Abra o arquivo indicado pelo Codex e substitua o marcador em `credentials.api_key.value` pela sua BetterToken API Key. | Sistema | Arquivo padrão | | - | - | | macOS / Linux | `~/.codex/gpt-image-2-skill/config.json` | | Windows | `%USERPROFILE%\.codex\gpt-image-2-skill\config.json` | Se usar um `CODEX_HOME` personalizado, siga o caminho absoluto informado. A configuração de imagens fica separada do arquivo de login. Uma configuração nova tem esta estrutura. Em um arquivo existente, altere apenas a entrada correspondente: ```json theme={null} { "version": 1, "default_provider": "bettertoken-image", "providers": { "bettertoken-image": { "type": "openai-compatible", "api_base": "https://bettertoken.ai/v1", "model": "gpt-image-2", "credentials": { "api_key": { "source": "file", "value": "YOUR_BETTERTOKEN_API_KEY" } } } } } ``` Mantenha o arquivo privado, fora do repositório do projeto e de capturas de tela. `providers` é um campo da ferramenta comunitária. ## Etapa 3: gere a primeira imagem Salve a configuração, abra um novo chat e envie: ```text theme={null} Use $gpt-image-2-skill com --provider bettertoken-image para gerar uma imagem. Modelo: gpt-image-2. Um PNG de 1024x1024. Conteúdo: uma caneca de cerâmica verde em um estúdio branco, luz natural suave, sem texto. Salve em output/images/mug.png no projeto atual e mostre a imagem. Não use a ferramenta oficial integrada nem troque de serviço. Se falhar, informe o motivo sem mudar de modelo ou enviar outro pedido. ``` Permita o acesso do script à API quando o Codex solicitar. A geração pode levar alguns minutos; aguarde o pedido atual terminar. Confirme que a conta oficial continua conectada, `output/images/mug.png` existe e abre, e o registro do BetterToken contém o pedido com o modelo de imagens. ## Edite uma imagem de referência Coloque a imagem no projeto ou forneça seu caminho local: ```text theme={null} Use $gpt-image-2-skill com --provider bettertoken-image para editar uma imagem. Referência: output/images/mug.png. Mude apenas o fundo para cinza-claro; mantenha a cor, a forma da caneca e a composição. Use gpt-image-2 e salve em output/images/mug-edited.png. Não substitua o original, use a ferramenta oficial integrada ou troque de serviço. ``` O Skill chama o endpoint de edição. Veja [edição de imagens](/pt-br/api-reference/images-edits) para arquivos e máscaras. Para trocar de modelo, informe o Model ID completo do model plaza. ## Solução de problemas | Sintoma | O que fazer | | - | - | | Skill não encontrado | Peça ao Codex para conferir o `SKILL.md` instalado e abra um chat novo. Reinicie se ainda não aparecer. | | Usa a ferramenta oficial | Especifique `$gpt-image-2-skill` e `--provider bettertoken-image`; confira a URL e o modelo de imagens. | | `401` ou erro de autenticação | Confira se a chave está completa e ativa, em vez do marcador. | | `404` ou modelo não encontrado | Use `https://bettertoken.ai/v1`, sem `/responses` ou outro `/v1`; confira o Model ID exato. | | Rede bloqueada | Permita o pedido desse script e confira a conexão ou o proxy local. | | Timeout, limite ou saldo insuficiente | Confira primeiro o registro e saldo do BetterToken. Após um timeout, confirme o status antes de tentar novamente. | ## Documentação relacionada * [API de geração de imagens](/pt-br/api-reference/images-generations) * [Login oficial do Codex e APIs de texto de terceiros](/pt-br/faq/codex/official-login-third-party-api) * [OpenAI: instalação e descoberta de Skills](https://learn.chatgpt.com/docs/build-skills) * [Configuração do Skill comunitário](https://github.com/Wangnov/gpt-image-2-skill) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.