Resumo rápido
A API do GPT Image 2 executa o GPT Image 2 e mais 2 variantes pelo Mage em POST https://api.mage.space/v1/gpt_image_2/generate. Uma requisição nas configurações padrão custa 9 Gems (cerca de US$ 0,009), sem assinatura. O GPT Image 2 aceita personagens e referências salvos por @handle no prompt.
Imagem
Saída
3
Variantes
9
Gems por imagem, padrão
$0.009
Aproximadamente, 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. O filtro de segurança da OpenAI se aplica.
GPT Image 2, GPT Image 2.5 Flare e GPT Image 2.5 Sunburst, da OpenAI, para geração e edições. 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_id | Nome | Padrão |
|---|---|---|
| gpt-image-2 | GPT Image 2 | Sim |
| gpt-image-2.5-flare | GPT Image 2.5 Flare | |
| gpt-image-2.5-sunburst | GPT Image 2.5 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.
| Campo | Valores |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1K, 2K |
Entradas
Entradas de mídia aceitas pelo GPT Image 2
Envie cada uma como URL https, data URL ou upload de até 100 MB.
| Campo | Função |
|---|---|
| image | A imagem de referência. |
| additional_images | Imagens 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.
Mais modelos de imagem
Outras APIs de geração de imagens no Mage
Imagem · a partir de 75 Gems
API do Grok Image
Grok Imagine, em três níveis de qualidade
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 135 Gems
API do Mango
Nossa família de imagens principal
Imagem · a partir de 68 Gems
API do Nano Banana 2
Texto nítido e legível, até 4K
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). O padrã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.