Introduction

Texto

Imagen

GenerarPOSTEditarPOST

Vídeo

词元兽-TokenMons词元兽-TokenMons
EmpezarReferencia API
GeminiNano Banana

Nano Banana · Editar

Imagen / Gemini / Nano Banana / Editar

POST/v1/images/edits

Parámetros de solicitud

Authorization

Añade un header Authorization cuyo valor sea Bearer seguido de tu API key.

Authorization: Bearer ****************
Parámetros de bodymultipart/form-dataobligatorio
modelstringObligatorio
ID del modelo, fijo en `gemini-2.5-flash-image`
promptstringObligatorio
Instrucción de edición, p. ej. cambia el fondo a una noche nevada
imagefileObligatorio
Imagen(es) a editar; se puede enviar varias veces (`image` o `image[]`)
maskfileOpcional
Imagen de máscara que marca el área a modificar
nintegerOpcional
Número de imágenes, por defecto `1`
sizestringOpcional
Resolución, p. ej. `1024x1024`
response_formatstringOpcional
Formato de retorno. `url` solo aplica a modelos que lo admiten (p. ej. DALL-E); OpenAI gpt-image siempre devuelve `b64_json` e ignora este campo.
Ejemplo
{  "model": "gemini-2.5-flash-image",  "prompt": "cambia el fondo a una noche nevada",  "image": "dog.png",  "size": "1024x1024"}

Código de ejemplo

curl https://api.hotrouter.ai/v1/images/edits \  -H "Authorization: Bearer $API_KEY" \  -F "model=gemini-2.5-flash-image" \  -F "prompt=cambia el fondo a una noche nevada" \  -F "image=@dog.png" \  -F "size=1024x1024"

Respuesta

200 · Éxito
createdintegerOpcional
Marca de tiempo de creación (segundos)
dataarray[object]Obligatorio
Imágenes generadas
Ejemplo
{  "created": 1730000000,  "data": [    {      "b64_json": "<base64>"    }  ]}

GenerarPOST

Previous Page

GenerarPOST

Next Page

On this page

Parámetros de solicitudCódigo de ejemploRespuesta
{
  "model": "gemini-2.5-flash-image",
  "prompt": "cambia el fondo a una noche nevada",
  "image": "dog.png",
  "size": "1024x1024"
}
curl https://api.hotrouter.ai/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -F "model=gemini-2.5-flash-image" \
  -F "prompt=cambia el fondo a una noche nevada" \
  -F "image=@dog.png" \
  -F "size=1024x1024"
{
  "created": 1730000000,
  "data": [
    {
      "b64_json": "<base64>"
    }
  ]
}