Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

Descripcion general

Crea una variacion de una imagen dada. Requiere el tipo de contenido 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.
image
file
requerido
La imagen a usar como base para la variacion. Debe ser un archivo PNG valido, menor de 50MB y cuadrado.
model
string
predeterminado:"dall-e-2"
El modelo a usar para las variaciones de imagen. Actualmente solo se admite dall-e-2.
n
integer
predeterminado:"1"
El numero de imagenes a generar. Debe estar entre 1 y 10.
size
string
El tamano de las imagenes generadas. Debe ser uno de 256x256, 512x512 o 1024x1024.
response_format
string
predeterminado:"url"
El formato en que se devuelven las imagenes generadas. Debe ser url o b64_json.
user
string
Un identificador unico que representa a su usuario final para monitoreo de abuso.

Respuesta

created
integer
Marca de tiempo Unix de cuando se crearon las imagenes.
data
array
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)
curl -X POST "https://api.tokenlab.sh/v1/images/variations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "image=@cat.png" \
  -F "n=2" \
  -F "size=1024x1024"
{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}

Notas

Las variaciones de imagen solo estan disponibles con DALL-E 2. El modelo generara nuevas imagenes que son similares en estilo y contenido a la imagen original.