Imagem para imagem (edição de imagens)

curl 'https://www.bettertoken.ai/v1/images/edits' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'model=YOUR_MODEL_ID' \
  -F 'prompt=参考这张图片，生成一张更精致的方形产品主视觉，保持主体风格一致。' \
  -F 'n=1' \
  -F 'size=1024x1024' \
  -F 'response_format=b64_json' \
  -F 'output_format=png' \
  -F 'image=@reference.png'

{
  "created": 1710000000,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...(truncated)"
    }
  ]
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

POST

images

edits

curl 'https://www.bettertoken.ai/v1/images/edits' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'model=YOUR_MODEL_ID' \
  -F 'prompt=参考这张图片，生成一张更精致的方形产品主视觉，保持主体风格一致。' \
  -F 'n=1' \
  -F 'size=1024x1024' \
  -F 'response_format=b64_json' \
  -F 'output_format=png' \
  -F 'image=@reference.png'

{
  "created": 1710000000,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...(truncated)"
    }
  ]
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

POST /v1/images/edits O endpoint de imagem para imagem usa um corpo de solicitação multipart/form-data. Envie uma ou mais imagens de referência e informe prompt e parâmetros como campos de formulário.

Use https://www.bettertoken.ai/v1 como Base URL. Envie sua BetterToken API Key por Authorization: Bearer YOUR_API_KEY.

Você pode preencher os campos e enviar imagens de referência no Playground à direita da página e enviar a solicitação diretamente para https://www.bettertoken.ai/v1/images/edits.

Não use um corpo JSON comum em solicitações de imagem para imagem. Envie campos de texto e de arquivo com multipart/form-data.

Valores recomendados

Envie estes campos explicitamente em todas as solicitações:

model=gpt-image-2
n=1
response_format=b64_json
output_format=png

Use image para uma única referência. Para várias referências, repita os campos image[].

Uma imagem de referência

curl 'https://www.bettertoken.ai/v1/images/edits' \
  -H 'Authorization: Bearer sk-***REDACTED***' \
  -F 'model=gpt-image-2' \
  -F 'prompt=Use this reference image to create a more polished square product hero image while keeping the main style consistent.' \
  -F 'n=1' \
  -F 'size=1024x1024' \
  -F 'response_format=b64_json' \
  -F 'output_format=png' \
  -F 'image=@reference.png'

Várias imagens de referência

curl 'https://www.bettertoken.ai/v1/images/edits' \
  -H 'Authorization: Bearer sk-***REDACTED***' \
  -F 'model=gpt-image-2' \
  -F 'prompt=Combine these reference images into one consistent promotional poster.' \
  -F 'n=1' \
  -F 'size=1024x1024' \
  -F 'response_format=b64_json' \
  -F 'output_format=png' \
  -F 'image[]=@reference-1.png' \
  -F 'image[]=@reference-2.jpg' \
  -F 'image[]=@reference-3.png'

Exemplo em Python

import requests

url = "https://www.bettertoken.ai/v1/images/edits"
headers = {
    "Authorization": "Bearer sk-***REDACTED***",
}

data = {
    "model": "gpt-image-2",
    "prompt": "Use this reference image to create a more polished square product hero image while keeping the main style consistent.",
    "n": "1",
    "size": "1024x1024",
    "response_format": "b64_json",
    "output_format": "png",
}

with open("reference.png", "rb") as image_file:
    files = {
        "image": ("reference.png", image_file, "image/png"),
    }
    response = requests.post(url, headers=headers, data=data, files=files, timeout=300)

response.raise_for_status()
result = response.json()
b64_json = result["data"][0]["b64_json"]

Tamanhos recomendados

`size`	Proporção	Caso de uso
`auto`	Automática	Seleção automática de tamanho
`1024x1024`	`1:1`	Imagens quadradas, avatares, capas e materiais
`1536x1024`	`3:2`	Pôsteres, banners e cenas horizontais
`1024x1536`	`2:3`	Capas e pôsteres verticais para celular
`1536x1152`	`4:3`	Imagens horizontais padrão, imagens de produto e gráficos de conteúdo
`1152x1536`	`3:4`	Imagens verticais padrão, capas de celular e pôsteres verticais
`2048x2048`	`1:1`	Imagens quadradas de alta resolução
`2048x1152`	`16:9`	Imagens horizontais de alta resolução
`3840x2160`	`16:9`	Imagens horizontais em 4K
`2160x3840`	`9:16`	Imagens verticais em 4K

size representa a proporção esperada e a faixa de tamanho. Os pixels retornados podem ser mapeados ou ajustados pelo servidor. Use as dimensões da imagem decodificada em vez de cortar à força a saída para o valor solicitado.

Salve a imagem

Uma resposta bem-sucedida segue o formato de resposta de imagem compatível com OpenAI:

{
  "created": 1710000000,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...(truncated)"
    }
  ]
}

Leia data[0].b64_json e salve-o como conteúdo de imagem base64. Sempre defina output_format: "png" para salvar a imagem decodificada como .png.

Fluxo de resposta

Este endpoint é síncrono. Depois de enviar POST /images/edits, mantenha a solicitação HTTP aberta até o servidor responder. Quando a geração for concluída, o conteúdo da imagem será retornado em data[0].b64_json. O endpoint não retorna task_id, nem há endpoint separado para consultar status ou baixar o resultado.

Documentos relacionados

Autorizações

Authorization

string

header

obrigatório

Use your BetterToken API Key as a bearer token. Do not expose API keys in frontend browser code, screenshots, logs, tickets, or Git repositories.

Corpo

multipart/form-data

model

enum<string>

padrão:YOUR_MODEL_ID

obrigatório

固定使用 YOUR_MODEL_ID。

Opções disponíveis:

YOUR_MODEL_ID

Exemplo:

"YOUR_MODEL_ID"

prompt

string

obrigatório

图片编辑或参考图生成说明。

Exemplo:

"参考这张图片，生成一张更精致的方形产品主视觉，保持主体风格一致。"

image

file

单张参考图字段名。单参考图时使用 image。

image[]

file[]

多张参考图字段名。多参考图时重复提交 image[]。

padrão:1

推荐固定为 1。多张图片建议发起多次独立请求。

Exemplo:

"1"

size

enum<string>

padrão:1024x1024

图片尺寸和比例档位。auto 为自动；1024x1024 和 2048x2048 为 1:1；1536x1024 为 3:2；1024x1536 为 2:3；1536x1152 为 4:3；1152x1536 为 3:4；2048x1152 和 3840x2160 为 16:9；2160x3840 为 9:16。实际返回像素可能由服务端映射或调整，客户端应以解码后的真实图片尺寸为准。

Opções disponíveis:

auto,

1024x1024,

1536x1024,

1024x1536,

1536x1152,

1152x1536,

2048x2048,

2048x1152,

3840x2160,

2160x3840

Exemplo:

"1024x1024"

response_format

enum<string>

padrão:b64_json

推荐固定为 b64_json。

Opções disponíveis:

b64_json

Exemplo:

"b64_json"

output_format

enum<string>

padrão:png

推荐固定为 png。不要依赖 jpeg 或 webp 直接返回对应格式。

Opções disponíveis:

png

Exemplo:

"png"

Resposta

Image generation result.

OpenAI-compatible image response. Clients should read data[0].b64_json and allow additional fields such as revised_prompt.

created

integer

Exemplo:

1710000000

data

object[]

Show child attributes

​Valores recomendados

​Uma imagem de referência

​Várias imagens de referência

​Exemplo em Python

​Tamanhos recomendados

​Salve a imagem

​Fluxo de resposta

​Documentos relacionados

Autorizações

Corpo

Resposta

Valores recomendados

Uma imagem de referência

Várias imagens de referência

Exemplo em Python

Tamanhos recomendados

Salve a imagem

Fluxo de resposta

Documentos relacionados