Editar una imagen

imagen En cola Se ejecuta en segundo plano — recibes un enlace cuando está listo.

Cambia una foto describiendo el cambio — sustituye el fondo, cambia el estilo, combina dos referencias — sin máscaras ni capas.

Pensado para

Retoque de producto
Cambio de fondo
Variaciones de estilo

Cómo funciona

Tú aportas

Una o dos imágenes de referencia y una frase que diga qué debe cambiar y qué debe quedarse igual.

Recibes

Una imagen editada que conserva las partes que no mencionaste.

Qué significa para ti

Di qué cambiar con palabras sencillas — el resto se queda como está.
Aporta hasta dos referencias para combinar o igualar un estilo.
Precio por megapíxel, como nuestras otras imágenes.

Pruébalo

Usar la API

Detalles

Qué puedes ajustar

Ajuste	Tipo y límites	Qué significa
`prompt` obligatorio	texto, 1–2000 caracteres	What to change, in plain language (no masks needed).
`image_size` opcional	grupo	Output dimensions; omitted = matched to the reference. Billed megapixels = ceil(width x height / 1e6), capped at 4 MP by unit bounds.
`image_size.width` obligatorio	número entero, 256–2048
`image_size.height` obligatorio	número entero, 256–2048
`image_urls` obligatorio	lista	One or two reference images: uploaded file_urls from /v1/uploads (validated for ownership) or external image URLs. Two at most — reference megapixels are part of the wholesale cost.
`output_format` opcional	texto, uno de: jpeg, png	File type of the result; jpeg when omitted.

Qué recibes: Una imagen (PNG o JPEG)
Límites: megapixels: 1–4
Cómo se ejecuta: En cola — Se ejecuta en segundo plano — recibes un enlace cuando está listo.
Alias: oneup/image-edit

Para desarrolladores

La misma solicitud como llamada a la API, con la entrada de ejemplo de esta capacidad:

curl -X POST https://api.oneupai.com/v1/queue/submit/oneup/image-edit \
  -H "Authorization: Bearer $ONEUP_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "swap the background for a bright kitchen, keep the product exactly as is",
  "image_urls": [
    "https://example.com/product.jpg"
  ]
}'

Ver esquema de entrada (JSON)

{
  "type": "object",
  "required": [
    "prompt",
    "image_urls"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "What to change, in plain language (no masks needed)."
    },
    "image_size": {
      "type": "object",
      "required": [
        "width",
        "height"
      ],
      "properties": {
        "width": {
          "type": "integer",
          "maximum": 2048,
          "minimum": 256
        },
        "height": {
          "type": "integer",
          "maximum": 2048,
          "minimum": 256
        }
      },
      "description": "Output dimensions; omitted = matched to the reference. Billed megapixels = ceil(width x height / 1e6), capped at 4 MP by unit bounds.",
      "additionalProperties": false
    },
    "image_urls": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 2048,
        "minLength": 1
      },
      "maxItems": 2,
      "minItems": 1,
      "description": "One or two reference images: uploaded file_urls from /v1/uploads (validated for ownership) or external image URLs. Two at most — reference megapixels are part of the wholesale cost."
    },
    "output_format": {
      "enum": [
        "jpeg",
        "png"
      ],
      "type": "string",
      "description": "File type of the result; jpeg when omitted."
    }
  },
  "additionalProperties": false
}

Documentación de la API

Otras capacidades de imagen

Imagen rápida

Convierte una descripción breve en una imagen, rápido.

1 crédito por megapíxel

Imagen premium

Nuestra imagen de máxima calidad a partir de una descripción — para tomas principales y portadas.

6 créditos (primer megapíxel) + 3 por adicional