Zum Hauptinhalt springen

Übersicht

Dieser Endpunkt bleibt für legacy OpenAI-kompatible Variations-Clients erhalten. Für aktuelle Image-to-Image-Workflows ist er nicht empfohlen; verwenden Sie nach Möglichkeit /v1/images/edits mit gpt-image-2 oder /v1/images/generations mit einem Image-to-Image-Modell wie nano-banana-pro. Erfordert multipart/form-data.

Anfragekörper

Timeout für synchrone Anfragen: Einige geroutete Bildanbieter geben das endgültige Bild inline zurück und warten dafür, bis die Generierung abgeschlossen ist. Hochauflösende oder hochwertige Anfragen können fast eine Minute oder länger dauern; setzen Sie das Timeout Ihres HTTP-Clients daher auf mindestens 120s. Wenn die Create-Antwort status: "pending", task_id oder poll_url enthält, folgen Sie stattdessen der zurückgegebenen poll_url.
image
file
erforderlich
Das Bild als Basis für die Variation. Muss eine gültige PNG-Datei sein, kleiner als 50MB und quadratisch.
model
string
erforderlich
Erforderliche Modell-ID für legacy variationskompatible Routen. Es gibt keinen impliziten Standard; für aktuelle Image-to-Image-Workflows bevorzugen Sie /v1/images/edits oder /v1/images/generations mit einem aktuellen Modell.
n
integer
Standard:"1"
Die Anzahl der zu generierenden Bilder. Muss zwischen 1 und 10 liegen.
size
string
Die Größe der erzeugten Bilder für legacy variationskompatible Routen. Unterstützte Werte hängen vom ausgewählten Modell ab.
response_format
string
Standard:"url"
Das Format der zurückgegebenen Bilder. Muss url oder b64_json sein.
user
string
Eine eindeutige Kennung für Ihren Endbenutzer zur Missbrauchsüberwachung.

Antwort

created
integer
Unix-Zeitstempel der Bilderstellung.
data
array
Array der generierten Bildvariationen.Jedes Objekt enthält:
  • url (string): URL des Variationsbildes (wenn response_format url ist)
  • b64_json (string): Base64-kodiertes Bild (wenn response_format b64_json ist)
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://..."
    }
  ]
}

Hinweise

Dies ist ein legacy Kompatibilitätsendpunkt. Er ist nicht im aktuellen empfohlenen Bildmodellkatalog enthalten. Für neue Integrationen verwenden Sie /v1/images/edits mit gpt-image-2 oder /v1/images/generations mit operation: "image-to-image" und einem aktuellen Image-to-Image-Modell.