Blog

Como Acessar a API do GPT-5.4

Ashley Innocent

Ashley Innocent

6 março 2026

Como Acessar a API do GPT-5.4

Em resumo / Resposta Rápida

Para acessar a API GPT-5.4: (1) Crie uma conta OpenAI em platform.openai.com, (2) Adicione um método de pagamento nas configurações de cobrança, (3) Gere uma chave de API na seção API Keys, (4) Instale o SDK OpenAI (pip install openai ou npm install openai), (5) Defina a variável de ambiente OPENAI_API_KEY, (6) Faça requisições ao modelo gpt-5.4. Preços: $2.50/M tokens de entrada, $15/M tokens de saída. Versão Pro ($30/$180) disponível para tarefas complexas.

Introdução

Acessar a API GPT-5.4 leva cerca de 10 minutos, desde a criação da conta até sua primeira chamada de API. No entanto, o processo de configuração envolve várias etapas onde lacunas na documentação criam atrito: verificação de cobrança, gerenciamento de chaves de API, instalação do SDK e compreensão dos níveis de preços.

Este guia aborda cada etapa com capturas de tela, exemplos de código e dicas de solução de problemas. Você aprenderá como configurar sua conta OpenAI, gerar chaves de API de forma segura, instalar o SDK e começar a fazer requisições ao GPT-5.4.

Também abordaremos a discriminação de preços, limites de taxa, acesso específico da plataforma (ChatGPT vs. Codex vs. API) e as melhores práticas de segurança para implantações em produção.

O que você obterá:

💡
Antes de integrar o GPT-5.4 em aplicações de produção, teste seus endpoints de API minuciosamente. O Apidog fornece uma plataforma unificada para depuração, teste e documentação de API. Use-o para validar suas requisições de integração do GPT-5.4, inspecionar payloads de resposta, criar suítes de teste automatizadas e simular respostas durante o desenvolvimento para minimizar os custos de tokens.
button

Pré-requisitos

Antes de começar, certifique-se de ter:

Tempo necessário: 10-15 minutos Custo: $0 para começar (preço de pagamento por uso)

Passo 1: Criar Conta OpenAI

Navegue até platform.openai.com e clique em "Sign Up" (Cadastre-se).

Você precisará fornecer:

A OpenAI enviará um código de verificação para o seu e-mail. Digite o código para verificar sua conta.

Importante: Use um e-mail comercial se planeja usar a API para projetos comerciais. Transferências de titularidade de conta exigem tickets de suporte.

Após a verificação do e-mail, complete a verificação do telefone:

  1. Selecione o código do seu país
  2. Digite seu número de telefone
  3. Receba um SMS com o código de verificação
  4. Digite o código para completar a verificação

Algumas regiões podem ter acesso limitado à API. Verifique a lista de países suportados da OpenAI se encontrar problemas.

Passo 2: Configurar Cobrança

A API GPT-5.4 usa um modelo de preços pay-as-you-go (pague pelo uso). Você deve adicionar um método de pagamento antes de fazer requisições.

Navegue até Settings (Configurações) > Billing (Cobrança) no painel da plataforma.

Adicionar Método de Pagamento

  1. Clique em "Add payment method" (Adicionar método de pagamento)
  2. Insira os detalhes do cartão de crédito/débito (Visa, Mastercard ou American Express)
  3. O endereço de cobrança deve corresponder ao registro do cartão
  4. Clique em "Save" (Salvar)

A OpenAI realiza uma pequena cobrança de autorização ($0.50-1.00) para verificar o cartão. Essa cobrança é revertida em 3-5 dias úteis.

Níveis de Cobrança

As contas OpenAI começam com limites de nível padrão:

Nível 1 (Contas novas):

Nível 2 (Após o primeiro pagamento):

Nível 3 (Alto volume verificado):

Para aumentar os limites:

  1. Vá para Settings (Configurações) > Billing (Cobrança) > Limits (Limites)
  2. Clique em "Request limit increase" (Solicitar aumento de limite)
  3. Forneça a descrição do caso de uso e o gasto mensal esperado
  4. Aguarde 1-3 dias úteis para aprovação

Habilitar Alertas de Uso

Configure alertas de cobrança para evitar cobranças inesperadas:

  1. Settings (Configurações) > Billing (Cobrança) > Overview (Visão geral)
  2. Clique em "Add alert" (Adicionar alerta)
  3. Defina o limite (ex: $50, $100, $500)
  4. Insira o e-mail para notificações

Você receberá e-mails quando o uso ultrapassar cada limite.

Passo 3: Gerar Chave de API

As chaves de API autenticam suas requisições à API da OpenAI.

Navegue até platform.openai.com/api-keys.

Criar Nova Chave

  1. Clique em "Create new secret key" (Criar nova chave secreta)
  2. Insira um nome descritivo (ex: "Desenvolvimento", "Produção", "CI/CD")
  3. Selecione o projeto (opcional, para contas de organização)
  4. Clique em "Create secret key" (Criar chave secreta)

Crítico: Copie a chave imediatamente. Você não poderá visualizá-la novamente após fechar o modal. Se perdida, gere uma nova chave.

Formato da chave: sk-proj- seguido por string alfanumérica (exemplo: sk-proj-abc123def456...)

Permissões da Chave

A OpenAI suporta permissões granulares:

Para acesso ao GPT-5.4, garanta que a chave tenha:

Melhores Práticas de Rotação de Chaves

Gire as chaves de API a cada 90 dias:

  1. Gere uma nova chave
  2. Atualize as aplicações com a nova chave
  3. Teste minuciosamente
  4. Exclua a chave antiga do painel da OpenAI

Use variáveis de ambiente ou sistemas de gerenciamento de segredos (AWS Secrets Manager, HashiCorp Vault) para armazenar chaves de forma segura.

Passo 4: Instalar o SDK da OpenAI

A OpenAI oferece SDKs oficiais para Python e Node.js. Você também pode usar o cURL para requisições HTTP diretas.

Instalação para Python

pip install openai

Verifique a instalação:

import openai
print(openai.__version__)

Requer Python 3.7 ou superior. Para ambientes virtuais:

python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows
pip install openai

Instalação para Node.js

npm install openai

Verifique a instalação:

const OpenAI = require('openai');
console.log(OpenAI.version);

Requer Node.js 14 ou superior. Para TypeScript:

npm install --save-dev @types/node

cURL (Sem Instalação)

O cURL vem pré-instalado na maioria dos sistemas. Verifique:

curl --version

Use o cURL para testes rápidos de API sem dependências de SDK.

Passo 5: Configurar o Ambiente

Armazene sua chave de API em variáveis de ambiente. Nunca codifique chaves no código-fonte.

Linux/macOS

Adicione a ~/.bashrc, ~/.zshrc ou perfil do shell:

export OPENAI_API_KEY="sk-proj-abc123def456..."

Recarregue o shell:

source ~/.zshrc  # ou ~/.bashrc

Windows

Prompt de Comando:

set OPENAI_API_KEY=sk-proj-abc123def456...

PowerShell:

$env:OPENAI_API_KEY="sk-proj-abc123def456..."

Permanente (Variáveis de Ambiente do Sistema):

  1. Pesquise "Variáveis de Ambiente" no menu Iniciar
  2. Clique em "Editar as variáveis de ambiente do sistema"
  3. Clique em "Variáveis de Ambiente"
  4. Em "Variáveis do usuário", clique em "Novo"
  5. Nome: OPENAI_API_KEY
  6. Valor: Sua chave de API
  7. Reinicie o terminal

Arquivo .env (Desenvolvimento)

Crie o arquivo .env na raiz do projeto:

OPENAI_API_KEY=sk-proj-abc123def456...

Carregue com python-dotenv:

pip install python-dotenv
from dotenv import load_dotenv
load_dotenv()

Nunca adicione arquivos .env ao controle de versão. Adicione a .gitignore:

.env

Passo 6: Fazer Sua Primeira Requisição

Teste sua configuração com uma requisição simples ao GPT-5.4.

Usando o Apidog para Testes de API: Em vez de escrever código para testar sua integração da API GPT-5.4, use a interface visual do Apidog para:

Exemplo em Python

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.getenv("OPENAI_API_KEY")
)

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "What is GPT-5.4?"}
    ]
)

print(response.choices[0].message.content)

Exemplo em Node.js

const OpenAI = require('openai');

const client = new OpenAI({
    apiKey: process.env.OPENAI_API_KEY
});

async function main() {
    const response = await client.chat.completions.create({
        model: 'gpt-5.4',
        messages: [
            { role: 'system', content: 'You are a helpful assistant.' },
            { role: 'user', content: 'What is GPT-5.4?' }
        ]
    });

    console.log(response.choices[0].message.content);
}

main();

Exemplo em cURL

curl https://api.openai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "What is GPT-5.4?"}
    ]
  }'

Resposta Esperada

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1741234567,
  "model": "gpt-5.4",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "GPT-5.4 is OpenAI's most advanced frontier model..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 150,
    "total_tokens": 175
  }
}

Verificar Acesso ao GPT-5.4

Se você receber um erro sobre acesso ao modelo:

  1. Verifique se a cobrança está ativa (Settings (Configurações) > Billing (Cobrança))
  2. Verifique se a chave de API possui as permissões corretas
  3. Certifique-se de estar usando o nome exato do modelo gpt-5.4
  4. Entre em contato com o suporte da OpenAI se os problemas persistirem

O GPT-5.4 foi lançado gradualmente a partir de 5 de março de 2026. Algumas contas podem ter acesso atrasado durante o lançamento.

Preços da API GPT-5.4

Compreender os preços do GPT-5.4 ajuda a otimizar custos e evitar surpresas na cobrança.

Preços Padrão

Componente

Preço

Tokens de entrada

$2.50 por milhão

Tokens de entrada em cache

$0.25 por milhão

Tokens de saída

$15 por milhão

Preços Pro

Componente

Preço

Tokens de entrada

$30 por milhão

Tokens de saída

$180 por milhão

Programas de Desconto

Processamento em Lote (Batch Processing):

Processamento Flexível (Flex Processing):

Processamento Prioritário (Priority Processing):

Exemplo de Cálculo de Custo

Exemplo: Processamento de 10.000 consultas de suporte ao cliente mensalmente

Premissas:

Preços padrão:

Com preços de Lote (50% de desconto):

Dicas de Otimização de Custo

  1. Use entradas em cache - Prompts de sistema repetidos custam 90% menos ($0.25 vs $2.50)
  2. Otimize prompts - Prompts mais curtos = menos tokens de entrada
  3. Limite tokens de saída - Defina o parâmetro max_tokens apropriadamente
  4. Use processamento em Lote - 50% de economia para cargas de trabalho não em tempo real
  5. Monitore o uso - Configure alertas de cobrança e acompanhe o consumo de tokens

Preços da Janela de Contexto

Contexto padrão: 272K tokens (preços padrão) Contexto estendido: Até 1M tokens (taxa de uso 2x)

Requisições que excedem 272K tokens contam com o dobro da taxa normal:

Limites de Taxa e Cotas

A OpenAI impõe limites de taxa para garantir o uso justo entre os clientes.

Limites de Taxa Padrão

Os limites de taxa variam de acordo com o nível da conta e o histórico de uso.

Nível 1 (Contas novas):

Nível 2 (Contas estabelecidas):

Nível 3 (Alto volume):

Cabeçalhos de Limite de Taxa

As respostas da API incluem informações de limite de taxa:

x-ratelimit-limit-requests: 60
x-ratelimit-limit-tokens: 150000
x-ratelimit-remaining-requests: 59
x-ratelimit-remaining-tokens: 149500
x-ratelimit-reset-requests: 1s
x-ratelimit-reset-tokens: 200ms

Lidando com Limites de Taxa

Quando o limite de taxa é atingido, você receberá um erro HTTP 429:

{
  "error": {
    "message": "Rate limit reached for requests",
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded"
  }
}

Estratégia de repetição (retry):

import time
from openai import OpenAI, RateLimitError

client = OpenAI()

def make_request_with_retry(messages, max_retries=3):
    for attempt in range(max_retries):
        try:
            return client.chat.completions.create(
                model="gpt-5.4",
                messages=messages
            )
        except RateLimitError as e:
            if attempt == max_retries - 1:
                raise
            wait_time = 2 ** attempt  # Exponential backoff
            time.sleep(wait_time)

Melhores práticas:

Solicitando Aumento de Limite

Para aumentar os limites de taxa:

  1. Vá para Settings (Configurações) > Billing (Cobrança) > Limits (Limites)
  2. Clique em "Request limit increase" (Solicitar aumento de limite)

Forneça:

  1. Aguarde 1-3 dias úteis

A aprovação depende de:

Acesso em Todas as Plataformas

O GPT-5.4 está disponível em várias plataformas OpenAI com diferentes métodos de acesso.

Acesso à API

Nomes dos modelos:

Método de acesso:

Melhor para:

Acesso ao ChatGPT

O GPT-5.4 Thinking está disponível para:

O GPT-5.4 Pro está disponível para:

Método de acesso:

Melhor para:

Acesso ao Codex

O GPT-5.4 é o modelo padrão no Codex com:

Método de acesso:

Melhor para:

Comparação de Plataformas

Recurso

API

ChatGPT

Codex

Acesso GPT-5.4

Sim

Sim (Plus+)

Sim

GPT-5.4 Pro

Sim

Sim (Pro+)

Sim

Uso de Computador

Sim

Limitado

Sim

Pesquisa de Ferramentas

Sim

Não

Sim

Contexto de 1M

Sim (experimental)

Não

Sim

Integrações Personalizadas

Sim

Não

Limitado

Pagamento por Uso

Sim

Assinatura

Assinatura

Apidog para Integração de API

Ao integrar a API GPT-5.4 em aplicações, o Apidog fornece uma plataforma unificada para o desenvolvimento de API:

Solução de Problemas Comuns

Erro "Modelo não encontrado"

Erro: The model gpt-5.4 does not exist (O modelo gpt-5.4 não existe)

Causas:

Soluções:

  1. Verifique o nome exato do modelo: gpt-5.4
  2. Verifique se a cobrança está ativa
  3. Gere uma nova chave de API com as permissões corretas
  4. Aguarde 24 horas se a conta foi criada recentemente

Erro "Cota insuficiente"

Erro: You exceeded your current quota (Você excedeu sua cota atual)

Causas:

Soluções:

  1. Verifique o uso em platform.openai.com/usage
  2. Verifique se o método de pagamento está atualizado
  3. Solicite aumento de limite (Settings (Configurações) > Billing (Cobrança) > Limits (Limites))
  4. Aguarde o reset da cota (limites diários são resetados à meia-noite UTC)

Falhas de Autenticação

Erro: Invalid authentication - Please provide a valid API key (Autenticação inválida - Forneça uma chave de API válida)

Causas:

Soluções:

  1. Verifique a variável de ambiente: echo $OPENAI_API_KEY
  2. Verifique se a chave começa com sk-proj- ou sk-
  3. Regenere a chave se comprometida
  4. Reinicie a aplicação após definir a variável de ambiente

Erros de Limite de Taxa

Erro: Rate limit reached for requests (Limite de taxa atingido para requisições)

Soluções:

  1. Implemente lógica de repetição com backoff exponencial
  2. Reduza a frequência das requisições
  3. Use a API de Lote para processamento em massa
  4. Solicite aumento de limite para necessidades de produção

Problemas de Cobrança

Erro: Payment required (Pagamento necessário) ou Billing information needs updating (As informações de cobrança precisam ser atualizadas)

Soluções:

  1. Atualize o método de pagamento (Settings (Configurações) > Billing (Cobrança))
  2. Verifique a data de validade do cartão
  3. Verifique se o endereço de cobrança corresponde ao cartão
  4. Entre em contato com o banco se a cobrança for recusada repetidamente
  5. Entre em contato com o suporte da OpenAI para revisão da conta

Erros de Tempo Limite

Erro: Request timed out (Requisição expirou) ou erros de conexão

Causas:

Soluções:

  1. Aumente o tempo limite na configuração do cliente HTTP
  2. Verifique a conectividade de rede
  3. Implemente lógica de repetição com backoff
  4. Use streaming para requisições de longa duração

Melhores Práticas de Segurança

Proteja suas chaves de API e dados com estas práticas de segurança.

Use o Apidog para criar suítes abrangentes de testes de segurança para suas integrações GPT-5.4:

Gerenciamento de Chaves de API

Faça:

Não faça:

Padrões de Requisição Seguros

Use apenas HTTPS: Todas as requisições da API OpenAI usam HTTPS por padrão. Nunca desabilite a verificação SSL.

Valide entradas: Sanitize as entradas do usuário antes de enviá-las para a API para prevenir injeção de prompt:

def sanitize_input(user_input):
    # Remove ou escapa conteúdo potencialmente perigoso
    dangerous_patterns = ['ignore previous instructions', 'system prompt', 'api key']
    for pattern in dangerous_patterns:
        user_input = user_input.replace(pattern, '[REDACTED]')
    return user_input

Registre com responsabilidade: Nunca registre requisições/respostas completas da API que contenham dados sensíveis:

import logging

# Bom: Registra o uso de tokens, não o conteúdo
logging.info(f"API call: {response.usage.total_tokens} tokens")

# Ruim: Registra conteúdo sensível
logging.info(f"API response: {response.choices[0].message.content}")

Considerações sobre Privacidade de Dados

Retenção Zero de Dados (ZDR): A OpenAI oferece ZDR para clientes empresariais:

Residência de dados: Para clientes da UE, a OpenAI oferece opções de residência de dados na UE. Entre em contato com vendas para detalhes.

Manuseio de PII: Evite enviar informações de identificação pessoal (PII) para a API:

Se PII for necessário, implemente:

Segurança de Rede

Lista de IPs permitidos (IP allowlisting): Contas empresariais podem configurar listas de IPs permitidos:

Endpoints VPC: AWS PrivateLink disponível para clientes empresariais:

Conclusão

Acessar a API GPT-5.4 requer uma configuração direta: criar uma conta, adicionar cobrança, gerar uma chave de API, instalar o SDK e fazer sua primeira requisição. Todo o processo leva de 10 a 15 minutos.

Para equipes que integram o GPT-5.4 em aplicações de produção, ter fluxos de trabalho robustos de teste e depuração acelera o desenvolvimento. O Apidog fornece uma plataforma unificada para design, depuração, teste e documentação de API. Use-o para validar suas integrações GPT-5.4, criar suítes de teste automatizadas, simular respostas durante o desenvolvimento e colaborar com membros da equipe em contratos de API.

button

Recapitulação dos principais passos:

  1. Crie uma conta OpenAI em platform.openai.com
  2. Adicione um método de pagamento e habilite a cobrança
  3. Gere uma chave de API com as permissões apropriadas
  4. Instale o SDK OpenAI (Python, Node.js ou use cURL)
  5. Armazene a chave de API em variáveis de ambiente
  6. Faça uma requisição de teste para verificar a configuração

Resumo de preços:

Próximos passos:

A eficiência de tokens aprimorada e as taxas de alucinação reduzidas do GPT-5.4 o tornam adequado para cargas de trabalho de produção. Comece com pequenos testes, monitore o uso e escale gradualmente à medida que você valida o desempenho.

FAQ

Como faço para obter acesso à API GPT-5.4?

Crie uma conta em platform.openai.com, adicione um método de pagamento nas configurações de cobrança, gere uma chave de API e use o nome do modelo gpt-5.4 em suas requisições. O acesso foi lançado gradualmente a partir de 5 de março de 2026.

A API GPT-5.4 é gratuita para usar?

Não. O GPT-5.4 custa $2.50 por milhão de tokens de entrada e $15 por milhão de tokens de saída. Novas contas recebem um crédito de $5 (expira após 3 meses). Os preços de Lote e Flex oferecem 50% de desconto.

Qual é a diferença entre gpt-5.4 e gpt-5.4-pro?

O GPT-5.4 Pro oferece desempenho máximo em tarefas complexas de raciocínio, mas custa 12x mais ($30/$180 vs $2.50/$15). Use o GPT-5.4 padrão para a maioria das cargas de trabalho, o Pro para tarefas que exigem a mais alta precisão.

Como corrijo erros de "modelo não encontrado"?

Verifique se você está usando o nome exato do modelo gpt-5.4 (não gpt5.4 ou gpt-5-4). Verifique se a cobrança está ativa e se a chave de API possui as permissões corretas. Aguarde 24 horas se a conta foi criada recentemente.

Quais são os limites de taxa para a API GPT-5.4?

Limites padrão do Nível 2: 60 requisições por minuto, 150.000 tokens por minuto, 1.000.000 tokens por dia. Contas novas começam no Nível 1 (20 RPM, 40K TPM). Solicite aumentos via Settings (Configurações) > Billing (Cobrança) > Limits (Limites).

Posso usar o GPT-5.4 gratuitamente no ChatGPT?

O GPT-5.4 Thinking está disponível para assinantes do ChatGPT Plus ($20/mês), Team ($25/usuário/mês) e Pro ($200/mês). Não está disponível no nível gratuito. O acesso à API usa preços separados de pagamento por token.

Como reduzo os custos da API GPT-5.4?

Use entradas em cache (90% de economia em prompts repetidos), otimize o comprimento do prompt, limite os tokens de saída com o parâmetro max_tokens e use o processamento em Lote (50% de desconto para cargas de trabalho não em tempo real).

O GPT-5.4 está disponível em todo o mundo?

A API GPT-5.4 está disponível na maioria dos países onde a OpenAI opera. Algumas regiões têm restrições. Verifique platform.openai.com para disponibilidade específica do país durante o cadastro.

Como faço para girar chaves de API com segurança?

Gere uma nova chave, atualize todas as aplicações com a nova chave, teste minuciosamente e, em seguida, exclua a chave antiga do painel da OpenAI. Use variáveis de ambiente ou sistemas de gerenciamento de segredos para evitar alterações no código.

O que acontece se eu exceder meu limite de taxa?

Você receberá um erro HTTP 429. Implemente uma lógica de repetição com backoff exponencial (atrasos de 1s, 2s, 4s). Considere usar a API de Lote para processamento em massa ou solicitar aumento de limite para necessidades de produção.

Pratique o design de API no Apidog

Descubra uma forma mais fácil de construir e usar APIs

Cadastre-se gratuitamenteBaixar