ToAPIs
    InícioToAPIs
    Geração de imagensGPT Image 2.6, Gemini, FLUX…Geração de vídeoSeedance, Veo, Kling, Sora…Chat e escritaGPT-5.6, Claude, DeepSeek…Voz e músicaLocuções, TTS, áudio
    NovidadeSeedance 2.5
    PreçosDocumentação da APIMCP
    BlogAlternativas
    EntrarComece grátis
    Todos os modelosPreçosDocumentação da APIMCPBlogAlternativas
    EntrarComece grátis

    Idioma

    Esc
    • Seedance 2.5Geração de vídeo
    • GPT Image 2Geração de imagens
    • GPT Image 2.6Geração de imagens
    • GPT Image 2.5Geração de imagens
    • Veo 3.1 FastGeração de vídeo
    • Kling 3.0 TurboGeração de vídeo
    • Kling V4 FlashGeração de vídeo
    • Grok Video 1.5Geração de vídeo
    • Nano Banana 2Geração de imagens
    • Seedream 5.5Geração de imagens
    • FLUXGeração de imagens
    • Sora 2Geração de vídeo
    • Todos os modelos de imagemCategoria
    • Todos os modelos de vídeoCategoria
    • GPT-5.6 SolChat e código
    • Claude Opus 4.8Chat e código
    • Claude Opus 4.7Chat e código
    • DeepSeek V4 ProDeepSeek · Texto
    • Gemini Omni 1.1 FlashGoogle · Multimodal
    1. Início
    2. Blog
    3. Tutorial
    4. Gerar imagens nativas em 4K com o GPT Image 2: proporções e fluxos de upscaling
    Voltar a todos os artigos
    tutorial2026-11-127 min de leitura

    Gerar imagens nativas em 4K com o GPT Image 2: proporções e fluxos de upscaling

    Gere saída nativa em 4K com o contrato atual do GPT Image 2: defina size como uma proporção e resolution como 4k. Não existe um flag upscale: true documentado, e o tamanho em pixels do 4K depende da proporção que você escolher.

    ToAPIs Engineering & Evaluation Team
    GPT Image 24KAspect RatioImage APITutorial
    TL;DR - Principais conclusões
    • O gpt-image-2 exato expõe a resolução como um nível de primeira classe: 1k, 2k e 4k. Solicite 4K nativo enviando resolution: "4k" em POST /v1/images/generations — não um flag upscale: true do lado do servidor, e também não uma string de tamanho como 1024x1024.
    • size é uma proporção (1:1, 16:9 e as outras proporções documentadas). A referência da API publica uma tabela de pixels: uma imagem 16:9 em 4k é 3840x2160, enquanto uma imagem 1:1 em 4k é 2880x2880.
    • O playground atual omite 5:4 e 4:5 quando a resolução é 4K, embora a tabela de size da API liste valores em pixels para essas duas proporções. Confirme na referência em tempo real se precisar delas.
    • As tarefas são assíncronas: guarde o id da tarefa e consulte GET /v1/images/generations/{id}. Um timeout do cliente não prova que a tarefa falhou, especialmente em 4k.
    • Não faça orçamento com preços unitários antigos de 1024px / 2048px. Confirme a tarifa vigente por nível para o ID de modelo exato da sua conta.

    Gerar imagens nativas em 4K com o GPT Image 2: proporções e fluxos de upscaling

    Modelo alvo: gpt-image-2
    Endpoint de inferência: https://api.toapis.com/v1/images/generations
    Relacionado: Guia da API GPT Image 2 · Inpainting e outpainting · Espelho e proxy global · Referência de tamanhos da API


    1. TL;DR e visão geral de desempenho

    • Tarefa: produzir uma imagem pronta para impressão ou para um hero no nível 4K documentado, com a proporção que você realmente precisa, a partir de uma única requisição ao gpt-image-2.
    • Contrato: POST /v1/images/generations com o ID de modelo gpt-image-2. size é uma proporção (1:1, 16:9 e as demais proporções documentadas). resolution é 1k, 2k ou 4k. A referência oficial publica as dimensões em pixels resultantes de cada par.
    • O que não enviar: size: "2048x2048", um flag quality: "hd" no gpt-image-2 exato, ou um campo inventado upscale: true que prometa transformar uma renderização de 2048 px em 3840x2160. O 4K é um valor de resolution de primeira classe.
    • Protocolo assíncrono: a chamada de envio retorna um id de tarefa. Consulte GET /v1/images/generations/{id} (ou GET /v1/tasks/{id}) até o status ser completed ou failed. Tarefas em 4K podem demorar mais do que rascunhos em 1K; um timeout do cliente não prova que a tarefa falhou.
    • FinOps: faça rascunhos em 1k, promova os prompts aceitos para 4k e confirme a tarifa vigente por nível. Não copie linhas de preço antigas de 1024 px / 2048 px para uma previsão.

    2. Proporções, níveis de resolução e saída nativa em 4K

    O contrato atual do gpt-image-2 separa a forma do nível. size escolhe a proporção; resolution escolhe o nível de qualidade; o serviço deriva a largura e a altura em pixels dos dois. É por isso que uma "imagem em 4K" nem sempre é 3840x2160: esse tamanho é o resultado documentado de size: "16:9" mais resolution: "4k". Uma saída quadrada em 4K está documentada como 2880x2880.

    As proporções predefinidas listadas na referência oficial são:

    1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 21:9, 9:21

    Você pode enviar auto e deixar o fornecedor upstream escolher, mas então a proporção final e o tamanho em pixels não são garantidos. O gpt-image-2 exato não documenta um campo custom de tamanho em pixels; proporções personalizadas width:height (por exemplo 7:4) estão documentadas em gpt-image-2-vip e gpt-image-2-official, sujeitas aos próprios limites (lados múltiplos de 16, borda longa de no máximo 3,840 px, proporção de no máximo 3:1, total de pixels entre 655,360 e 8,294,400).

    A tabela de tamanhos da referência da API para o gpt-image-2 exato é:

    size1k2k4k
    1:11024x10242048x20482880x2880
    3:21536x10242048x13603520x2336
    2:31024x15361360x20482336x3520
    4:31024x7682048x15363312x2480
    3:4768x10241536x20482480x3312
    5:41280x10242560x20483216x2576
    4:51024x12802048x25602576x3216
    16:91536x8642048x11523840x2160
    9:16864x15361152x20482160x3840
    2:12048x10242688x13443840x1920
    1:21024x20481344x26881920x3840
    21:92016x8642688x11523840x1648
    9:21864x20161152x26881648x3840

    Duas ressalvas acompanham essa tabela:

    • O playground atual da ToAPIs mantém 3:2 e 2:3 em 4K, mas omite 5:4 e 4:5 quando a resolução é 4K. A tabela de tamanhos acima ainda lista pixels em 4k para essas duas proporções. Se o seu produto precisa de 5:4 ou 4:5 em 4k, confirme com uma requisição real em vez de assumir que o filtro do playground é o limite da API.
    • Em superfícies diferentes aparecem minúsculas (4k) e maiúsculas (4K). Os exemplos oficiais do gpt-image-2 usam minúsculas; a configuração do playground usa 1K / 2K / 4K. Siga a referência da API nos clientes e não trate maiúsculas como um segundo parâmetro.

    Uma grade grosseira de nós 2 por 2 fluindo por um gateway hexagonal até uma grade de alta resolução mais fina

    Figura 1: a resolução é um campo de requisição de primeira classe. O caminho documentado é pedir 4k diretamente, não inventar um flag de upscaling pós-processamento.

    Não existe um interruptor upscale: true documentado na ToAPIs que pegue uma renderização nativa de 2048 px e devolva 3840x2160. Se você já tem uma imagem em 1K ou 2K e quer uma maior, o movimento suportado é uma nova geração (opcionalmente com o rascunho em reference_images) com resolution: "4k". Não prometa fidelidade tipográfica, "originais de impressão a 300 DPI" nem upscaling sem artefatos, a menos que você tenha medido essas propriedades nos seus próprios ativos.

    O gpt-image-2 exato também aceita, de forma opcional, background: "transparent" e até 14 URLs em reference_images. Ele não expõe quality no contrato atual do playground; quality é um campo de IDs como gpt-image-2-vip.


    3. Implementação em produção: cURL e Python

    Os exemplos internacionais desta série usam https://api.toapis.com. A documentação oficial orienta usuários da China continental a usar https://toapis.cn. Mantenha uma única origem por ambiente.

    Passo 1: envio com cURL em 4K nativo

    bash
    curl -X POST "https://api.toapis.com/v1/images/generations" \
      -H "Authorization: Bearer $TOAPIS_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gpt-image-2",
        "prompt": "Wide architectural photograph of a concrete pavilion at dusk, still water in the foreground, no typography, no logos",
        "size": "16:9",
        "resolution": "4k",
        "n": 1,
        "response_format": "url"
      }'
    

    Esta requisição está documentada para mirar 3840x2160. Para um original quadrado em 4K, mude size para 1:1 (documentado como 2880x2880). Para um frame de story em 9:16, use size: "9:16" (documentado como 2160x3840).

    Passo 2: helper em Python para rascunho e promoção

    Itere em 1k, guarde o prompt aceito (e as URLs de referência opcionais) e reenvie em 4k. O helper de consulta é o mesmo contrato assíncrono usado no guia de espelho e proxy.

    python
    import os
    import time
    import requests
    
    API_KEY = os.environ["TOAPIS_API_KEY"]
    BASE = "https://api.toapis.com"
    ENDPOINT = f"{BASE}/v1/images/generations"
    HEADERS = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    }
    
    
    def dispatch_image(
        prompt: str,
        size: str = "16:9",
        resolution: str = "1k",
        model: str = "gpt-image-2",
        reference_images: list[str] | None = None,
    ) -> str:
        payload = {
            "model": model,
            "prompt": prompt,
            "size": size,
            "resolution": resolution,
            "n": 1,
            "response_format": "url",
        }
        if reference_images:
            payload["reference_images"] = reference_images
        res = requests.post(ENDPOINT, headers=HEADERS, json=payload, timeout=30)
        res.raise_for_status()
        data = res.json()
        task_id = data.get("id") or data.get("task_id")
        if not task_id:
            raise RuntimeError(f"Unexpected submission envelope: {data}")
        return task_id
    
    
    def poll_image_task(task_id: str, deadline_s: int = 300) -> str:
        poll_url = f"{BASE}/v1/images/generations/{task_id}"
        interval = 2.0
        start = time.time()
        while time.time() - start < deadline_s:
            time.sleep(interval)
            poll = requests.get(poll_url, headers=HEADERS, timeout=15)
            if poll.status_code == 429:
                retry_after = poll.headers.get("Retry-After")
                time.sleep(float(retry_after) if retry_after else min(interval * 2, 20))
                continue
            poll.raise_for_status()
            data = poll.json()
            status = data.get("status")
            if status == "completed":
                return data["result"]["data"][0]["url"]
            if status == "failed":
                raise RuntimeError(f"Generation failed: {data.get('error')}")
            interval = min(interval * 1.5, 8.0)
        raise TimeoutError(
            f"Task {task_id} exceeded {deadline_s}s; check status before retrying"
        )
    
    
    if __name__ == "__main__":
        prompt = (
            "Wide architectural photograph of a concrete pavilion at dusk, "
            "still water in the foreground, no typography, no logos"
        )
        draft_id = dispatch_image(prompt, size="16:9", resolution="1k")
        print("Draft:", draft_id, poll_image_task(draft_id))
        final_id = dispatch_image(prompt, size="16:9", resolution="4k")
        print("4K:", final_id, poll_image_task(final_id, deadline_s=300))
    

    Dê às consultas em 4K um prazo maior do que aos rascunhos em 1K. Guarde o id da tarefa imediatamente, para que um timeout do cliente possa ser resolvido depois por uma consulta de status. Se mais tarde você mudar o cliente para gpt-image-2-vip (proporções personalizadas, quality) ou gpt-image-2-official, mude uma variável por vez e releia a referência daquele ID: as unidades de cobrança não são automaticamente as mesmas.


    4. Tratamento de erros e matriz de status

    As categorias abaixo são pontos de partida para diagnóstico, não uma garantia de códigos de erro exatos da ToAPIs. Um envio HTTP bem-sucedido ainda exige que você leia o status da tarefa.

    Status HTTPCategoria comumAção recomendada
    400Campo inválido ou combinação não suportadaVerifique se size é uma proporção documentada, se resolution é 1k / 2k / 4k e se você não enviou uma string de pixels como 2048x2048 nem um flag upscale não documentado
    401Chave de API ausente ou inválidaRotacione a chave no painel da ToAPIs e confirme o cabeçalho Authorization
    429Limite de taxa ou de concorrênciaRespeite Retry-After quando presente; aplique backoff com jitter; tente novamente só quando for seguro
    5xx ou timeout de redeProblema temporário no gateway ou no upstreamVerifique o status da tarefa antes de reenviar; tarefas em 4K podem continuar em in_progress após um timeout do cliente

    WaitTime=min⁡(MaxWait,BaseInterval×2attempt)+Uniform(0,1)\text{WaitTime} = \min(\text{MaxWait}, \text{BaseInterval} \times 2^{\text{attempt}}) + \text{Uniform}(0, 1)WaitTime=min(MaxWait,BaseInterval×2attempt)+Uniform(0,1)


    5. Preços e ROI com FinOps

    Custo estimado=imagens cobraˊveis bem-sucedidas×tarifa atual da conta para esse modelo, tamanho e resoluc¸a˜o\text{Custo estimado} = \text{imagens cobráveis bem-sucedidas} \times \text{tarifa atual da conta para esse modelo, tamanho e resolução}Custo estimado=imagens cobraˊveis bem-sucedidas×tarifa atual da conta para esse modelo, tamanho e resoluc¸​a˜o

    • Não reutilize preços unitários antigos como $0.024 para 1024 px ou $0.072 para 2048 px. Essas linhas pertencem a um contrato de tamanho obsoleto.
    • O guia do modelo GPT Image 2 mostra atualmente uma comparação na landing da ToAPIs de $0.015 / $0.020 / $0.025 por imagem em 1K / 2K / 4K para o gpt-image-2 padrão. Use isso apenas como comparação publicada. Confirme a tarifa aplicável à sua conta e ao ID de modelo exato que você chama.
    • Um loop econômico consiste em rascunhar em 1k e depois promover o prompt aceito (e as referências) para 4k. Duas tarefas bem-sucedidas são duas imagens cobráveis, a menos que os termos da sua conta digam o contrário. Não existe um atalho gratuito documentado de "upscale do mesmo prompt".
    • Os preços por token do fornecedor oficial e os preços por requisição da ToAPIs não são intercambiáveis. Se você migrar para gpt-image-2-vip ou para uma SKU de canal oficial, releia a tabela de preços daquele ID.
    • Como contexto, veja o artigo de preços do GPT Image 2 e depois confira cada número no catálogo em tempo real antes de colocá-lo em uma previsão.

    6. Perguntas frequentes

    Veja o bloco FAQ do frontmatter. Resumo: o 4K é um valor de resolution de primeira classe, não um flag upscale; as dimensões em pixels dependem de size e de resolution; não envie 1024x1024 como size; confirme 5:4 / 4:5 em 4k contra a API em tempo real se precisar dessas proporções; confirme as tarifas publicadas de 1K / 2K / 4K na sua conta.


    7. Checklist de ações

    • Crie uma chave no Portal de desenvolvedores da ToAPIs.
    • Defina uma URL base por ambiente (https://api.toapis.com ou, quando necessário, https://toapis.cn) e teste o trecho cURL com size: "16:9" e resolution: "1k".
    • Promova o mesmo prompt para resolution: "4k" e confirme o tamanho em pixels documentado para essa proporção (para 16:9, 3840x2160).
    • Guarde o id da tarefa, dê às consultas em 4K um prazo maior e respeite Retry-After em 429.
    • Em seguida: o guia de inpainting e outpainting se estiver editando um frame existente, e o guia da API para o mapa completo de parâmetros.

    Explore os modelos mencionados neste artigo

    OpenAIIMAGE

    GPT-Image-2

    Taxa atual: 3 credits /request
    Guia do modeloTestar no consoleObter chave de API
    OpenAIIMAGE

    GPT-Image-2 VIP

    Taxa atual: 3.38 credits /request
    Guia do modeloTestar no consoleObter chave de API

    Artigos relacionados

    tutorial2026-11-12T10:00:00+08:007 min de leitura

    Dominar inpainting e outpainting com a API de edição de imagens do GPT Image 2

    Edite imagens existentes com o contrato atual do GPT Image 2: mudanças guiadas por referência no gpt-image-2 e inpainting com máscara no gpt-image-2-official, tudo no endpoint assíncrono de gerações.

    TO
    ToAPIs Engineering & Evaluation Team
    #GPT Image 2
    tutorial2026-11-11T10:00:00+08:007 min de leitura

    GPT Image 2: espelho global e proxy para equipes internacionais

    Como equipes internacionais podem chamar a API GPT Image 2 por uma origem documentada da ToAPIs, reutilizar sessões e consultar tarefas de imagem assíncronas, sem depender de números de latência não verificados.

    TO
    ToAPIs Engineering & Evaluation Team
    #GPT Image 2
    tutorial2026-10-23T10:00:00+08:004 min de leitura

    Guia completo da API GPT Image 2: parâmetros, especificações oficiais e exemplos em Python

    Guia de integração para desenvolvedores da API GPT Image 2. Aprenda a ajustar parâmetros, usar resoluções HD, controlar a proporção, aplicar inpainting e implementar em Python e Node.js.

    TO
    ToAPIs Engineering & Evaluation Team
    #GPT Image 2
    ToAPIs
    InícioToAPIs
    Gateway empresarial de API de IA. Acesse GPT-5, Claude, Gemini e mais de 200 modelos por uma única API unificada.

    Modelos populares

    • Seedance 2.5 API
    • Seedance 2.0 API
    • Veo 3.1 Fast API
    • Kling 3.0 Turbo API
    Mostrar maisMostrar menos
    • GPT Image 2 API
    • Claude Opus 4.8 API
    • Nano Banana 2 API
    • Seedance 2 Mini API
    • Todos os modelos

    Categorias de API

    • API de imagem com IA
    • API de vídeo com IA
    • API de texto para vídeo
    • API de imagem para vídeo
    Mostrar maisMostrar menos
    • API de edição de imagens com IA
    • API de LLM e raciocínio
    • Todas as ferramentas de API →

    Alternativas

    Alternativas
    • Alternativa ao Kie.ai
    • Alternativa ao Fal.ai
    • Alternativa ao OpenRouter
    • Alternativa ao Replicate
    • Alternativa ao Wavespeed AI
    • Todas as comparações →

    Guias em destaque

    Guias em destaque
    • Preços do Seedance 2.0 e 2.5
    • Guia da API Seedance mais barata
    • Guia de integração do MiniMax H3
    • Chave de API gratuita do Seedance 2
    • Início rápido da API Seedance 2
    • Todos os artigos técnicos →

    Desenvolvedores e plataforma

    Desenvolvedores e plataforma
    • Documentação da API
    • MCP
    • Preços
    • Playground de modelos
    • LLMs.txt
    • Falar com o suporte
    • Diretório de guias de modelos
    Entidade operadora:
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    Sede social:
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    PrivacidadeTermosUso aceitávelExclusão de dadosRetenção de dadosSubprocessadores e regiõesCobrança e reembolsosPolítica de CookiesMapa do siteSobre

    © 2026 ToAPIs. Todos os direitos reservados.