Pular para o conteúdo

API do Mage · Modelo de imagem

API do GPT Image 2

Prompts precisos e texto legível

POST https://api.mage.space/v1/gpt_image_2/generate

Resumo rápido

A API do GPT Image 2 roda o GPT Image 2 e mais 4 variantes pela Mage em POST https://api.mage.space/v1/gpt_image_2/generate. Uma requisição com as configurações padrão custa 9 Gems (cerca de US$ 0,009), sem assinatura. O GPT Image 2 aceita personagens salvos e referências por @handle no prompt.

  • ImagemSaída
  • 5Variantes
  • 9Gems por imagem, padrão
  • $0.009Aproximadamente, em USD

Visão geral

O que a API do GPT Image 2 faz

Os modelos GPT Image da OpenAI, que seguem o prompt à risca e geram texto legível. Gere ou edite a partir de várias imagens de referência, ou crie GIFs animados no GPT Image 2.6. O filtro de segurança da OpenAI se aplica.

Os modelos GPT Image da OpenAI para geração e edição: GPT Image 2, GPT Image 2.5 Flare e Sunburst, e GPT Image 2.6 Flare e Sunburst, que também criam GIFs animados. O filtro de segurança da OpenAI se aplica.

Aceita image e additional_images como entradas.

Início rápido

Chame a API do GPT Image 2

Defina MAGE_API_KEY, envie para /gpt_image_2/generate e consulte status_url até a solicitação ser concluída.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/gpt_image_2/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "gpt-image-2"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('gpt_image_2', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'gpt-image-2',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("gpt_image_2", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "gpt-image-2",
})

print(request["result"]["url"])

Modelos

Valores de model_id do GPT Image 2

Envie model_id para escolher uma variante. Uma solicitação sem ele usa a padrão.

model_idNomePadrão
gpt-image-2GPT Image 2Sim
gpt-image-2.5-flareGPT Image 2.5 Flare
gpt-image-2.5-sunburstGPT Image 2.5 Sunburst
gpt-image-2.6-flareGPT Image 2.6 Flare
gpt-image-2.6-sunburstGPT Image 2.6 Sunburst

Opções

Parâmetros do GPT Image 2

Valores permitidos em todas as variantes; uma variante pode oferecer menos. A documentação lista as opções de cada variante.

CampoValores
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K
output_formatjpeg, gif

Entradas

Entradas de mídia aceitas pelo GPT Image 2

Envie cada uma como URL https, data URL ou upload de até 100 MB.

CampoFunção
imageA imagem de referência.
additional_imagesImagens de referência adicionais.

Regras

O que a API do GPT Image 2 impõe

  • Cada modelo oferece apenas alguns níveis de `quality`; um nível que o modelo escolhido não oferece é recusado.
  • Defina `output_format` como `gif` em um modelo GPT Image 2.6 para obter um GIF animado, com `frame_count` de 2 a 16 (padrão 9) e `frame_duration_ms` de 20 a 2000 (padrão 200). Outros modelos recusam essa opção. `resolution` não se aplica: cada `aspect_ratio` tem um único tamanho de quadro, perto de 640 pixels. O resultado é um arquivo `.gif`, e o `type` continua sendo `image`.
  • Um GIF é cobrado por `quality` e pela faixa de quadros em que se encaixa (2 a 8, 9, 10 a 12 ou 13 a 16), não por quadro. A tabela de preços abaixo mostra imagens estáticas: veja o preço de um GIF na estimativa de custo.
  • Um GIF do Mage, como um resultado anterior, enviado como entrada de imagem é processado a partir do primeiro frame. Um GIF de qualquer outra origem é recusado: as entradas de imagem devem ser JPEG ou PNG.

Mais modelos de imagem

Outras APIs de geração de imagens no Mage

  • Imagem · a partir de 90 Gems

    API do Grok Image

    Grok Imagine, em dois níveis

  • Imagem · a partir de 37 Gems

    API do Guava

    Fotorrealismo que parece uma fotografia de verdade

  • Imagem · a partir de 20 Gems

    API do HiDream

    Rápido e versátil, com prompts negativos

  • Imagem · a partir de 20 Gems

    API do Krea 2

    Estética deslumbrante em segundos

  • Imagem · a partir de 42 Gems

    API do Mango

    Nossa família de imagens principal

  • Imagem · a partir de 15 Gems

    API do MiniMax H3 Image

    Imagens nativas de 16 megapixels, pesos abertos

Perguntas frequentes

Perguntas frequentes

Quanto custa a API do GPT Image 2?
Uma solicitação ao GPT Image 2 nas configurações padrão (GPT Image 2) custa 9 Gems, cerca de US$ 0,009. Outras resoluções, durações e variantes alteram o preço; a resposta informa o valor exato cobrado. Uma geração que falha é reembolsada; uma bloqueada pela política de conteúdo do Mage não é.
Qual é o endpoint da API do GPT Image 2?
POST https://api.mage.space/v1/gpt_image_2/generate com um cabeçalho Authorization: Bearer contendo sua chave de API do Mage. A resposta inclui um status_url para consultar o resultado.
Quais modelos do GPT Image 2 posso chamar?
gpt-image-2 (GPT Image 2), gpt-image-2.5-flare (GPT Image 2.5 Flare), gpt-image-2.5-sunburst (GPT Image 2.5 Sunburst), gpt-image-2.6-flare (GPT Image 2.6 Flare), gpt-image-2.6-sunburst (GPT Image 2.6 Sunburst). O padrão é o GPT Image 2.
O GPT Image 2 aceita imagens de referência ou personagens?
O GPT Image 2 aceita image, additional_images. Ele também aceita personagens e referências salvos, chamados por @handle no prompt.
Posso usar o GPT Image 2 pelo Claude ou ChatGPT?
Sim. Conecte o servidor MCP do Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça o GPT Image 2 pelo nome. Seu assistente lê as opções com get_model e informa o preço antes de gerar.
Por quanto tempo os resultados do GPT Image 2 ficam armazenados?
Resultados e entradas ficam salvos por 30 dias. Baixe o que quiser guardar para o seu próprio armazenamento.

Comece a criar com o Mage

Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.

CharactersComunidade