De imagen a imagen (edición de imágenes)

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 El endpoint de imagen a imagen usa un cuerpo de solicitud multipart/form-data. Sube una o varias imágenes de referencia y envía el prompt y los parámetros como campos de formulario.

Usa https://www.bettertoken.ai/v1 como Base URL. Envía tu BetterToken API Key mediante Authorization: Bearer YOUR_API_KEY.

Puedes completar los campos del formulario y subir imágenes de referencia en el Playground de la derecha. Después, envía la solicitud directamente a https://www.bettertoken.ai/v1/images/edits.

No uses un cuerpo JSON normal para las solicitudes de imagen a imagen. Envía los campos de texto y archivo mediante multipart/form-data.

Valores recomendados

Envía estos campos de forma explícita en cada solicitud:

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

Usa image para una sola imagen de referencia. Para varias imágenes de referencia, repite el campo image[].

Una imagen de referencia

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'

Varias imágenes de referencia

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'

Ejemplo con 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"]

Tamaños recomendados

`size`	Proporción	Uso
`auto`	Automática	Selección automática del tamaño
`1024x1024`	`1:1`	Imágenes cuadradas, avatares, portadas y recursos
`1536x1024`	`3:2`	Pósteres horizontales, banners y escenas
`1024x1536`	`2:3`	Portadas móviles y pósteres verticales
`1536x1152`	`4:3`	Imágenes horizontales estándar, productos y gráficos de contenido
`1152x1536`	`3:4`	Imágenes verticales estándar, portadas móviles y pósteres verticales
`2048x2048`	`1:1`	Imágenes cuadradas de alta resolución
`2048x1152`	`16:9`	Imágenes horizontales de alta resolución
`3840x2160`	`16:9`	Imágenes horizontales 4K
`2160x3840`	`9:16`	Imágenes verticales 4K

size representa la proporción y el nivel de tamaño esperados. El servidor puede asignar o ajustar los píxeles devueltos. Usa las dimensiones de la imagen decodificada en lugar de recortar la salida por la fuerza al valor solicitado.

Guarda la imagen

Una respuesta correcta sigue la estructura de imagen compatible con OpenAI:

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

Lee data[0].b64_json y guárdalo como contenido de imagen en base64. Define siempre output_format: "png" para poder guardar la imagen decodificada como .png.

Flujo de respuesta

Este endpoint es síncrono. Después de enviar POST /images/edits, mantén abierta la solicitud HTTP hasta que responda el servidor. Cuando la generación se completa, el contenido de la imagen se devuelve en data[0].b64_json. El endpoint no devuelve un task_id, y no existe un endpoint separado para consultar el estado o descargar el resultado.

Documentación relacionada

Autorizaciones

Authorization

string

header

requerido

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

Cuerpo

multipart/form-data

model

enum<string>

predeterminado:YOUR_MODEL_ID

requerido

固定使用 YOUR_MODEL_ID。

Opciones disponibles:

YOUR_MODEL_ID

Ejemplo:

"YOUR_MODEL_ID"

prompt

string

requerido

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

Ejemplo:

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

image

file

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

image[]

file[]

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

predeterminado:1

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

Ejemplo:

"1"

size

enum<string>

predeterminado: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。实际返回像素可能由服务端映射或调整，客户端应以解码后的真实图片尺寸为准。

Opciones disponibles:

auto,

1024x1024,

1536x1024,

1024x1536,

1536x1152,

1152x1536,

2048x2048,

2048x1152,

3840x2160,

2160x3840

Ejemplo:

"1024x1024"

response_format

enum<string>

predeterminado:b64_json

推荐固定为 b64_json。

Opciones disponibles:

b64_json

Ejemplo:

"b64_json"

output_format

enum<string>

predeterminado:png

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

Opciones disponibles:

png

Ejemplo:

"png"

Respuesta

Image generation result.

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

created

integer

Ejemplo:

1710000000

data

object[]

Show child attributes

​Valores recomendados

​Una imagen de referencia

​Varias imágenes de referencia

​Ejemplo con Python

​Tamaños recomendados

​Guarda la imagen

​Flujo de respuesta

​Documentación relacionada

Autorizaciones

Cuerpo

Respuesta

Valores recomendados

Una imagen de referencia

Varias imágenes de referencia

Ejemplo con Python

Tamaños recomendados

Guarda la imagen

Flujo de respuesta

Documentación relacionada