Imágenes

Crear variación de imagen

Crea una variación de una imagen determinada

POST
/v1/images/variations

Descripción general

Este endpoint es compatible con clientes existentes de OpenAI Variations. Para nuevas funciones de imagen a imagen (image-to-image), utilice /v1/images/edits o /v1/images/generations con un modelo de imagen a imagen actual. Las solicitudes utilizan multipart/form-data.

Cuerpo de la solicitud

Este endpoint es síncrono: la respuesta contiene la imagen final y nunca una tarea. Configure el tiempo de espera (timeout) de su cliente HTTP en al menos 120s.

imagefileobligatorio

Imagen de origen multipart. El archivo y el cuerpo completo de la solicitud deben ocupar como máximo 50 MiB cada uno (las subidas más grandes devuelven 413). Los formatos y dimensiones compatibles dependen del modelo seleccionado. Solo se acepta un modelo cuyos detalles mapeen image-to-image a /v1/images/variations; cualquier otro modelo devuelve 400.

modelstringobligatorio

ID del modelo. Este endpoint no tiene un modelo predeterminado. Los ejemplos utilizan el marcador de posición your-legacy-variation-model: sustitúyalo por un modelo cuyos detalles incluyan este endpoint.

nintegerpredeterminado: 1

Número de imágenes a generar (1-10, según el modelo).

sizestring

Tamaño de la imagen generada. Los valores admitidos dependen del modelo seleccionado.

response_formatstring

El formato en el que se devuelven las imágenes generadas. Debe ser url o b64_json.

userstring

Un identificador único que representa a su usuario final para la supervisión de abusos.

Respuesta

createdinteger

Marca de tiempo Unix de cuándo se crearon las imágenes.

dataarray

Array de variaciones de imagen generadas.

Cada objeto contiene:

  • url (string): URL de la imagen de variación (si response_format es url)
  • b64_json (string): Imagen codificada en Base64 (si response_format es b64_json)

Solicitud

curl -X POST "https://api.tokenlab.sh/v1/images/variations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=your-legacy-variation-model" \
  -F "image=@cat.png" \
  -F "n=2" \
  -F "size=1024x1024"

Respuesta

Response
{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}

Notas

Este es un endpoint de compatibilidad heredado (legacy). No está incluido en el catálogo actual de modelos de imagen recomendados. Para nuevas integraciones, utilice /v1/images/edits con gpt-image-2, o /v1/images/generations con operation: "image-to-image" y un modelo actual de imagen a imagen.

Autorización

BearerAuth
AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Encabezados

X-TokenLab-Delivery-Policy?string

Política de entrega por solicitud. Sustituye los valores predeterminados de la API key y del Workspace. Auto intenta primero con TokenLab Verified y puede cambiar una vez a Official solo antes de la salida, la aceptación de la solicitud o la creación de recursos persistentes.

Valores permitidos

  • "auto"
  • "verified"
  • "official"

Cuerpo de la solicitud

multipart/form-data

Respuesta

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json