Skip to content

GPT Image 1.5 ​

gpt-image-1.5 é útil quando aderência ao prompt, renderização de texto, composição limpa ou qualidade comercial de saída importam. Ele usa os mesmos campos de imagem compatíveis com OpenAI que os outros modelos de imagem da Pixapi.

Superfície da API ​

OperaçãoEndpointModo
Geração de imagensPOST /v1/images/generationsSíncrono
Tarefa de geração de imagensPOST /v1/async/images/generationsAssíncrono
Edição de imagensPOST /v1/images/editsSíncrono
Tarefa de edição de imagensPOST /v1/async/images/editsAssíncrono

ID do modelo ​

ID do modeloMelhor para
gpt-image-1.5Geração e edição de imagens GPT com forte aderência ao prompt.

Preços ​

GPT Image 1.5 só admite tamanhos de saída 1K (1024x1024, 1536x1024, 1024x1536 ou size=auto). Os créditos variam com a qualidade. quality=auto é cobrado como high. Para saídas 2K ou 4K, use gpt-image-2.

Nível de tamanhoTamanhos suportadoslowmediumhigh / auto
1K1024x1024, 1536x1024, 1024x1536, auto1414

O costCredits exibido para uma requisição é igual ao valor da matriz multiplicado por n.

Campos de requisição ​

Envie os campos comuns no nível superior e os controles específicos dentro de providerOptions.

CampoTipoObrigatórioDescrição
modelstringSimgpt-image-1.5. ID diferencia maiúsculas.
promptstringSimDescreva o tema, a composição, o estilo e as alterações. A Pixapi mantém os primeiros 2.000 caracteres; o prompt também é obrigatório na edição.
nintegerNãoPadrão 1; aceita apenas o inteiro 1.
sizestringNãoauto (padrão), 1024x1024, 1536x1024 ou 1024x1536. GPT Image 1.5 só aceita 1K; não 2K/4K.
imagestring / string[]Para ediçãoURL HTTP(S) pública ou lista de URLs; obrigatória em /images/edits. Até 14 URLs; não aceita Base64.
qualitystringNãoauto (padrão), low, medium ou high; maior qualidade pode demorar mais.
providerOptionsobjectNãoOpções específicas; consulte a tabela abaixo.

providerOptions ​

Todos estes campos ficam dentro de providerOptions, não ao lado de model.

CampoTipoDescrição
output_formatstringFormato da imagem de saída: png (padrão, mantém transparência), jpeg (arquivos menores, sem alfa) ou webp (suporta transparência).
backgroundstringModo de fundo: auto (padrão), opaque ou transparent. transparent só pode ser combinado com output_format: "png" ou output_format: "webp"; JPEG não suporta canal alfa.
moderationstringIntensidade da moderação de conteúdo: auto (padrão) ou low (mais permissiva).
output_compressionintegerNível de compressão da saída 0–100; apenas para saídas jpeg e webp.
mask_urlstringURL pública da máscara PNG. Exige image e dimensões iguais à primeira imagem. Pixels transparentes indicam a área editável; PNG com canal alfa, abaixo de 4 MB.
nsfw_checkbooleanModeração opcional do prompt e das imagens; padrão false.

Regras de entrada ​

A Pixapi aceita uma saída e até 14 referências. Os pixels de saída são escolhidos com size.

Exemplo de geração ​

bash
curl https://api.pixapi.ai/v1/images/generations \
  -H "Authorization: Bearer $PIXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1.5",
    "prompt": "A polished launch visual for a developer API product",
    "n": 1,
    "size": "1024x1024"
  }'
py
import os
import requests

response = requests.post(
    "https://api.pixapi.ai/v1/images/generations",
    headers={
        "Authorization": f"Bearer {os.environ['PIXAPI_KEY']}",
        "Content-Type": "application/json",
    },
    json={
    "model": "gpt-image-1.5",
    "prompt": "A polished launch visual for a developer API product",
    "n": 1,
    "size": "1024x1024"
},
)
response.raise_for_status()
print(response.json())
js
const response = await fetch('https://api.pixapi.ai/v1/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PIXAPI_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "model": "gpt-image-1.5",
  "prompt": "A polished launch visual for a developer API product",
  "n": 1,
  "size": "1024x1024"
}),
});

if (!response.ok) {
  throw new Error(await response.text());
}

console.log(await response.json());
go
package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  body := []byte(`{
  "model": "gpt-image-1.5",
  "prompt": "A polished launch visual for a developer API product",
  "n": 1,
  "size": "1024x1024"
}`)

  req, err := http.NewRequest(
    "POST",
    "https://api.pixapi.ai/v1/images/generations",
    bytes.NewBuffer(body),
  )
  if err != nil {
    panic(err)
  }
  req.Header.Set("Authorization", "Bearer "+os.Getenv("PIXAPI_KEY"))
  req.Header.Set("Content-Type", "application/json")

  resp, err := http.DefaultClient.Do(req)
  if err != nil {
    panic(err)
  }
  defer resp.Body.Close()

  result, _ := io.ReadAll(resp.Body)
  fmt.Println(string(result))
}

Exemplo de edição ​

bash
curl https://api.pixapi.ai/v1/images/edits \
  -H "Authorization: Bearer $PIXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1.5",
    "prompt": "Replace the background with a bright studio setup",
    "image": "https://cdn.example.com/input.png",
    "n": 1,
    "size": "1024x1024"
  }'
py
import os
import requests

response = requests.post(
    "https://api.pixapi.ai/v1/images/edits",
    headers={
        "Authorization": f"Bearer {os.environ['PIXAPI_KEY']}",
        "Content-Type": "application/json",
    },
    json={
    "model": "gpt-image-1.5",
    "prompt": "Replace the background with a bright studio setup",
    "image": "https://cdn.example.com/input.png",
    "n": 1,
    "size": "1024x1024"
},
)
response.raise_for_status()
print(response.json())
js
const response = await fetch('https://api.pixapi.ai/v1/images/edits', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PIXAPI_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "model": "gpt-image-1.5",
  "prompt": "Replace the background with a bright studio setup",
  "image": "https://cdn.example.com/input.png",
  "n": 1,
  "size": "1024x1024"
}),
});

if (!response.ok) {
  throw new Error(await response.text());
}

console.log(await response.json());
go
package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  body := []byte(`{
  "model": "gpt-image-1.5",
  "prompt": "Replace the background with a bright studio setup",
  "image": "https://cdn.example.com/input.png",
  "n": 1,
  "size": "1024x1024"
}`)

  req, err := http.NewRequest(
    "POST",
    "https://api.pixapi.ai/v1/images/edits",
    bytes.NewBuffer(body),
  )
  if err != nil {
    panic(err)
  }
  req.Header.Set("Authorization", "Bearer "+os.Getenv("PIXAPI_KEY"))
  req.Header.Set("Content-Type", "application/json")

  resp, err := http.DefaultClient.Do(req)
  if err != nil {
    panic(err)
  }
  defer resp.Body.Close()

  result, _ := io.ReadAll(resp.Body)
  fmt.Println(string(result))
}

Resposta ​

json
{
  "created": 1766880000,
  "data": [
    {
      "url": "https://cdn.pixapi.ai/generated/gpt-image-1.5.png"
    }
  ]
}