Aparência
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ção | Endpoint | Modo |
|---|---|---|
| Geração de imagens | POST /v1/images/generations | Síncrono |
| Tarefa de geração de imagens | POST /v1/async/images/generations | Assíncrono |
| Edição de imagens | POST /v1/images/edits | Síncrono |
| Tarefa de edição de imagens | POST /v1/async/images/edits | Assíncrono |
ID do modelo
| ID do modelo | Melhor para |
|---|---|
gpt-image-1.5 | Geraçã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 tamanho | Tamanhos suportados | low | medium | high / auto |
|---|---|---|---|---|
| 1K | 1024x1024, 1536x1024, 1024x1536, auto | 1 | 4 | 14 |
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.
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
model | string | Sim | gpt-image-1.5. ID diferencia maiúsculas. |
prompt | string | Sim | Descreva 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. |
n | integer | Não | Padrão 1; aceita apenas o inteiro 1. |
size | string | Não | auto (padrão), 1024x1024, 1536x1024 ou 1024x1536. GPT Image 1.5 só aceita 1K; não 2K/4K. |
image | string / string[] | Para edição | URL HTTP(S) pública ou lista de URLs; obrigatória em /images/edits. Até 14 URLs; não aceita Base64. |
quality | string | Não | auto (padrão), low, medium ou high; maior qualidade pode demorar mais. |
providerOptions | object | Não | Opções específicas; consulte a tabela abaixo. |
providerOptions
Todos estes campos ficam dentro de providerOptions, não ao lado de model.
| Campo | Tipo | Descrição |
|---|---|---|
output_format | string | Formato da imagem de saída: png (padrão, mantém transparência), jpeg (arquivos menores, sem alfa) ou webp (suporta transparência). |
background | string | Modo 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. |
moderation | string | Intensidade da moderação de conteúdo: auto (padrão) ou low (mais permissiva). |
output_compression | integer | Nível de compressão da saída 0–100; apenas para saídas jpeg e webp. |
mask_url | string | URL 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_check | boolean | Moderaçã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"
}
]
}