Imágenes
Crear variación de imagen
Crea una variación de una imagen determinada
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.
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.
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.
1Número de imágenes a generar (1-10, según el modelo).
Tamaño de la imagen generada. Los valores admitidos dependen del modelo seleccionado.
El formato en el que se devuelven las imágenes generadas. Debe ser url o b64_json.
Un identificador único que representa a su usuario final para la supervisión de abusos.
Respuesta
Marca de tiempo Unix de cuándo se crearon las imágenes.
Array de variaciones de imagen generadas.
Cada objeto contiene:
url(string): URL de la imagen de variación (si response_format esurl)b64_json(string): Imagen codificada en Base64 (si response_format esb64_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
{
"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 Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Encabezados
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