Saltar al contenido principal

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.
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
requerido
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.
n
integer
predeterminado:"1"
El numero de imagenes a generar. Debe estar entre 1 y 10.
size
string
Tamaño de las imágenes generadas para rutas legacy compatibles con variaciones. Los valores admitidos dependen del modelo seleccionado.
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 "model=your-legacy-variation-model" \
  -F "image=@cat.png" \
  -F "n=2" \
  -F "size=1024x1024"
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.tokenlab.sh/v1"
)

response = client.images.create_variation(
    model="your-legacy-variation-model",
    image=open("cat.png", "rb"),
    n=2,
    size="1024x1024"
)

for image in response.data:
    print(image.url)
import OpenAI from 'openai';
import fs from 'fs';

const client = new OpenAI({
  apiKey: 'sk-your-api-key',
  baseURL: 'https://api.tokenlab.sh/v1'
});

const response = await client.images.createVariation({
  model: 'your-legacy-variation-model',
  image: fs.createReadStream('cat.png'),
  n: 2,
  size: '1024x1024'
});

response.data.forEach(image => console.log(image.url));
package main

import (
    "bytes"
    "fmt"
    "io"
    "mime/multipart"
    "net/http"
    "os"
)

func main() {
    body := &bytes.Buffer{}
    writer := multipart.NewWriter(body)

    writer.WriteField("model", "your-legacy-variation-model")

    file, _ := os.Open("cat.png")
    defer file.Close()
    part, _ := writer.CreateFormFile("image", "cat.png")
    io.Copy(part, file)

    writer.WriteField("n", "2")
    writer.WriteField("size", "1024x1024")
    writer.Close()

    req, _ := http.NewRequest("POST", "https://api.tokenlab.sh/v1/images/variations", body)
    req.Header.Set("Authorization", "Bearer sk-your-api-key")
    req.Header.Set("Content-Type", writer.FormDataContentType())

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    result, _ := io.ReadAll(resp.Body)
    fmt.Println(string(result))
}
<?php
$ch = curl_init('https://api.tokenlab.sh/v1/images/variations');

$image = new CURLFile('cat.png', 'image/png', 'cat.png');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer sk-your-api-key'
    ],
    CURLOPT_POSTFIELDS => [
        'model' => 'your-legacy-variation-model',
        'image' => $image,
        'n' => 2,
        'size' => '1024x1024'
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
foreach ($data['data'] as $image) {
    echo $image['url'] . "\n";
}
{
  "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.