TokenLab
Obtener clave API
DocumentaciónReferencia APIIntegraciones

Imágenes

Crear variacion de imagen

Crea una variacion de una imagen dada

POST
/v1/images/variations

Descripcion general

Este endpoint se conserva para clientes legacy de variaciones compatibles con OpenAI. No es la ruta recomendada para flujos image-to-image actuales; usa /v1/images/edits con gpt-image-2 o /v1/images/generations con un modelo image-to-image como nano-banana-pro cuando sea posible. Requiere multipart/form-data.

Cuerpo de la solicitud

Tiempo de espera de solicitudes síncronas: algunos proveedores de imagen enrutados devuelven la imagen final inline y esperan a que termine la generación. Las solicitudes de alta resolución o alta calidad pueden tardar cerca de un minuto o más, así que configura el timeout de tu cliente HTTP en al menos 120s. Si la respuesta de creación incluye status: "pending", task_id o poll_url, sigue el poll_url devuelto en su lugar.

imagefileobligatorio

Imagen de origen multipart. El archivo y el cuerpo completo de la solicitud no deben superar 50 MiB cada uno. Los formatos y dimensiones dependen del modelo; sus detalles actuales deben incluir explícitamente /v1/images/variations.

modelstringobligatorio

Identificador de modelo obligatorio para rutas legacy compatibles con variaciones. No hay valor predeterminado implícito; para flujos image-to-image actuales, prefiere /v1/images/edits o /v1/images/generations con un modelo actual.

nintegerpredeterminado: 1

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

sizestring

Tamaño de las imágenes generadas para rutas legacy compatibles con variaciones. Los valores admitidos dependen del modelo seleccionado.

response_formatstring

El formato en que se devuelven las imagenes generadas. Debe ser url o b64_json.

userstring

Un identificador unico que representa a su usuario final para monitoreo de abuso.

Respuesta

createdinteger

Marca de tiempo Unix de cuando se crearon las imagenes.

dataarray

Array de variaciones de imagen generadas.

Cada objeto contiene:

  • url (string): URL de la imagen de variacion (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

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

Notas

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

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

Editar imagen

Anterior

Obtener estado de la imagen

Siguiente