Bilder

Bild erstellen

Erstellt ein Bild basierend auf einem Prompt

POST
/v1/images/generations

Übersicht

Verwenden Sie GET /v1/models?recommended_for=image, um aktuelle Bildmodelle abzurufen, und übergeben Sie dann das ausgewählte model explizit.

Jedes Modell akzeptiert eigene Operationen und Felder. GET /v1/models/{model} (Modell abrufen) liefert den Endpunkt für jede Operation in tokenlab.request_format_summary.request_endpoint_by_operation sowie die akzeptierten Felder, Werte und Limits für jede Operation in tokenlab.request_format_details.operation_constraints. Ein Feld, das das Modell nicht auflistet, kann 400 unsupported_parameter zurückgeben. Eine Operation, die an den falschen Endpunkt gesendet wird, gibt 400 unsupported_endpoint zurück.

Bild-Tasks und Ergebnisse:

  • Modelle, die async unter ihren unterstützten Parametern auflisten, können zuerst einen Task erstellen: Senden Sie async: true und pollen Sie anschließend GET /v1/tasks/{id}.
  • Bild-Links werden 30 Tage lang gespeichert; siehe Datenaufbewahrung.
  • Senden Sie einen Idempotency-Key-Header, um eine Erstellungsanfrage nach einem Timeout sicher zu wiederholen; siehe Sichere Wiederholungsversuche mit einem Idempotenz-Schlüssel.

gpt-image-2 ist ein Token-basiert abgerechnetes GPT-Image-Modell. TokenLab folgt der offiziellen Nutzungsaufschlüsselung von OpenAI für Texteingabe-, Bildeingabe-, gemeldete gecachte Eingabe- und Bildausgabe-Tokens; es wird nicht als festes Modell pro Bild abgerechnet.

Für die Bildgenerierung mit gpt-image-2 werden die öffentlichen Parameter prompt, n, size, quality, response_format, async, background, output_format, output_compression oder compression, moderation und user unterstützt. background akzeptiert auto oder opaque; transparent wird nicht unterstützt. Lassen Sie size oder quality weg, damit TokenLab auto verwendet; benutzerdefinierte size-Werte müssen dem unten dokumentierten flexiblen WIDTHxHEIGHT-Format entsprechen.

input_fidelity gehört derzeit nicht zu den von TokenLab unterstützten Feldern für gpt-image-2; lassen Sie es weg, da die Anfrage andernfalls 400 unsupported_parameter zurückgibt.

SVG- und GIF-Ausgabe

gpt-image-2.6-flare und gpt-image-2.6-sunburst können anstelle eines Rasterbildes ein SVG oder ein animiertes GIF zurückgeben. Andere Modelle lehnen diese Formate ab.

  • SVG: Senden Sie output_format: "svg" und svg: {"model": "..."}. Das Bildmodell erstellt zunächst ein Referenzbild, anschließend schreibt das Author-Modell das SVG daraus. svg.model ist erforderlich; die Modelldetails listen die akzeptierten Werte unter parameter_options (svg.model) auf. Sie können auch svg.reasoning.effort senden. SVG funktioniert nur an diesem Endpunkt, mit n: 1 und ohne partial_images oder output_compression.
  • GIF: Senden Sie output_format: "gif". frame_count (2 bis 16, Standard 9) legt die Anzahl der Frames fest, und frame_duration_ms (20 bis 2000, Standard 200) legt die Dauer jedes Frames fest. size ist die Größe eines einzelnen Frames. GIF akzeptiert keine partial_images oder output_compression.

Das Ergebnis befindet sich in data[].b64_json oder data[].url, genau wie bei anderen Bildern. Dekodieren Sie ein SVG als UTF-8-XML-Text und speichern Sie es als .svg; speichern Sie ein GIF als .gif.

Abrechnung: Bild-Token werden zu den Token-Preisen des Modells abgerechnet, und die GIF-Frames werden als Bild-Ausgabe-Token berechnet. Eine SVG-Anfrage berechnet zusätzlich die Token des Author-Modells, die in der Antwort unter svg_usage ausgewiesen werden, zu den auf der Modellseite angegebenen Preisen für die SVG-Erstellung.

Hinweise zum Modellverhalten

Modelle der Google Gemini-Bildfamilie teilen nicht denselben Selektor-Vertrag:

  • gemini-3.1-flash-image, gemini-nano-banana-2.1, gemini-3-pro-image, nano-banana-2.1 und nano-banana-pro unterstützen aspect_ratio sowie resolution (1k, 2k, 4k) für ihre öffentlichen text-to-image-, image-to-image- und image-edit-Operationen.
  • nano-banana-2 unterstützt aspect_ratio und resolution (1k, 2k, 4k) sowohl für text-to-image- als auch für image-to-image-Generierung.
  • gemini-3.1-flash-lite-image und nano-banana-2-lite unterstützen text-to-image, image-to-image und image-edit ausschließlich bei einer 1k-Auflösung.
  • nano-banana unterstützt aspect_ratio, bietet jedoch keine öffentliche resolution-Auswahl.
  • Verwenden Sie für image-to-image mit gemini-3.1-flash-image, gemini-nano-banana-2.1, gemini-3.1-flash-lite-image oder gemini-3-pro-image diesen Endpunkt mit operation: "image-to-image" und Referenzbildern. Senden Sie image-edit-Anfragen für diese Modelle an /v1/images/edits.
  • Für Referenzbild-Anfragen mit Nano Banana verwenden Sie nano-banana-2, nano-banana-2.1, nano-banana-2-lite oder nano-banana-pro an diesem Endpunkt (/v1/images/generations) mit operation: "image-to-image" und image_urls. Auch image-edit-Anfragen für nano-banana-2, nano-banana-2.1, nano-banana-2-lite und nano-banana-pro nutzen diesen Endpunkt mit operation: "image-edit". Senden Sie Nano Banana-Referenzbild-Anfragen nicht an /v1/images/edits.
  • Referenzbilder können an diesem Endpunkt als JSON-image_url / image_urls oder als Multipart-image-Datei übergeben werden. images[] und file_id werden unter /v1/images/generations nicht akzeptiert; erstellen Sie /v1/files-Referenzen nur für /v1/images/edits-Modelle, die images[].file_id dokumentieren.

Bevorzugen Sie für Google-Bildfamilien aspect_ratio und senden Sie resolution nur dann, wenn das Modell dies explizit unterstützt.

xAI Grok Imagine-Bildmodelle (grok-imagine-image und grok-imagine-image-2.0) unterstützen aspect_ratio sowie resolution (1k, 2k). Text-to-image verwendet diesen Endpunkt. Deren image-to-image- und image-edit-Anfragen verwenden /v1/images/edits.

hy-image-v3.5-preview erstellt über diesen Endpunkt ein Bild mit 1024x1024 pro Anfrage aus Text und unterstützt ausschließlich response_format: "url". Die Bearbeitung von Referenzbildern erfolgt über /v1/images/edits.

Request-Body

Synchroner Anfrage-Timeout: Einige Bildanfragen geben das finale Bild inline zurück und warten, bis die Generierung abgeschlossen ist. Anfragen mit hoher Auflösung oder hoher Qualität können nahezu eine Minute oder länger dauern; setzen Sie den Timeout Ihres HTTP-Clients daher auf mindestens 120s. Wenn die Erstellungsantwort status: "pending", task_id oder poll_url enthält, pollen Sie stattdessen GET /v1/tasks/{task_id}.

modelstringerforderlich

Zu verwendendes Modell (zum Beispiel gpt-image-2, flux-pro-1.1 oder nano-banana-pro). Rufen Sie GET /v1/models?recommended_for=image ab, um die aktuelle Liste der empfohlenen Modelle zu erhalten.

promptstringerforderlich

Textbeschreibung des gewünschten Bildes, bis zu 32.000 Zeichen. Erforderlich für jedes Modell, in dessen Details prompt aufgeführt ist.

operationstring

text-to-image, image-to-image oder image-edit. Wenn weggelassen, ist es image-to-image, falls die Anfrage ein Referenzbild enthält, andernfalls text-to-image. Setzen Sie image-edit für Modelle, deren Bearbeitungsoperation auf diesem Endpunkt liegt, wie beispielsweise nano-banana-pro. text-to-image mit einem Referenzbild gibt 400 invalid_parameter zurück.

image_urlstring

Öffentliche Bild-URL für die Image-to-Image-Generierung. Setzen Sie bei Nano Banana-Referenzbild-Anfragen operation auf image-to-image; nano-banana-pro kann resolution enthalten.

image_urlsstring[]

Öffentliche Referenzbild-URLs, bis zu 16. Verwenden Sie dies für ein oder mehrere Referenzbilder in JSON-Anfragen. file_id und images[] werden auf diesem Endpunkt nicht unterstützt.

reference_image_urlsstring[]

Zusätzliche Referenzbild-URLs, bis zu 16, für Modelle, die primäre Eingaben von Referenzen unterscheiden.

imagefile

Multipart-Referenzbilddatei für die Image-to-Image-Generierung. Verwenden Sie dies, wenn das Quellbild privat oder durch Header geschützt ist. Dies unterscheidet sich von einer /v1/files file_id, die auf diesem Endpunkt nicht akzeptiert wird.

nintegerStandard: 1

Anzahl der zu generierenden Bilder (1–10, modellabhängig).

sizestring

Bildgröße. Verwenden Sie dies für Bildfamilien im OpenAI-Stil und andere Modelle, die exakte Pixelgrößen akzeptieren.

Für gpt-image-2 akzeptiert size den Wert auto oder WIDTHxHEIGHT. Benutzerdefinierte Abmessungen müssen beide ein Vielfaches von 16 sein, die längste Kante darf maximal 3840px betragen, das Verhältnis von langer zu kurzer Seite darf höchstens 3:1 sein und die Gesamtzahl der Pixel muss zwischen 655,360 und 8,294,400 liegen. aspect_ratio und resolution sind für gpt-image-2 derzeit nicht Teil der TokenLab-Modelldetails.

Für Google-Bildmodelle mit Auflösungsstufen (gemini-3.1-flash-image, gemini-nano-banana-2.1, gemini-3-pro-image, gemini-3.1-flash-lite-image, nano-banana-2, nano-banana-2.1 und nano-banana-pro) akzeptiert size eine Ausgabegröße aus der Größentabelle des Modells, wie z. B. 1376x768 (16:9 bei 1K), oder eine Auflösungsstufe: 1K, 2K oder 4K. TokenLab sendet eine Stufe als resolution, sodass die Anfrage und deren Preis mit resolution identisch sind. Eine Stufe, die das Modell nicht unterstützt (beispielsweise 2K bei gemini-3.1-flash-lite-image), oder eine Stufe, die von resolution abweicht, gibt 400 mit dem Code invalid_image_size_contract und den allowed_resolutions des Modells zurück. Für diese Modelle wird die Kombination aus aspect_ratio und resolution empfohlen.

aspect_ratiostring

Modellabhängiger Selektor für das Seitenverhältnis.

Gängige Werte der Google-Bildfamilie umfassen 1:1, 16:9, 9:16, 3:2 und 2:3.

resolutionstring

Modellabhängige Ausgabeauflösung. gemini-3.1-flash-image, gemini-nano-banana-2.1, gemini-3-pro-image, nano-banana-2, nano-banana-2.1 und nano-banana-pro unterstützen 1k, 2k und 4k; Grok Imagine-Bildmodelle unterstützen 1k und 2k. Lassen Sie dieses Feld weg, es sei denn, das ausgewählte Modell und die Operation unterstützen es explizit.

qualitystring

Bildqualität. GPT-Image-Modelle wie gpt-image-2 verwenden auto, low, medium oder high. Andere Modelle können andere Werte verwenden; prüfen Sie die Modelldetails, bevor Sie einen Wert senden, der vom Standard abweicht.

output_formatstring

Dateiformat des Bildes: png, jpeg oder webp. gpt-image-2.6-flare und gpt-image-2.6-sunburst unterstützen zudem svg und gif; siehe SVG- und GIF-Ausgabe.

svgobject

SVG-Einstellungen, nur bei output_format: "svg". model (erforderlich) wählt das Autorenmodell aus, das das SVG erstellt. reasoning.effort legt optional dessen Reasoning-Aufwand fest.

frame_countintegerStandard: 9

Anzahl der GIF-Frames, von 2 bis 16. Nur bei output_format: "gif".

frame_duration_msintegerStandard: 200

Dauer jedes GIF-Frames in Millisekunden, von 20 bis 2000. Nur bei output_format: "gif".

response_formatstring

Format, in dem die Bilder zurückgegeben werden: url oder b64_json.

  • Weggelassen: Wenn das Modell Bild-Bytes zurückgibt, befindet sich jedes Bild in data[].b64_json sowie zusätzlich in data[].url, wenn TokenLab es gespeichert hat. Wenn das Modell einen Link zurückgibt, befindet sich jedes Bild in data[].url.
  • url: Jedes Bild befindet sich ausschließlich in data[].url.
  • b64_json: Jedes Bild befindet sich ausschließlich in data[].b64_json als Base64-Daten.

Links sind TokenLab-Medien-Ergebnis-URLs. Sie bleiben 30 Tage lang gültig. Siehe Datenaufbewahrung.

asyncbooleanStandard: false

Auf true setzen, um zuerst eine Aufgabe zu erstellen. Dies wird nur von Modellen akzeptiert, die async in ihren unterstützten Parametern auflisten, zum Beispiel gpt-image-2, flux-pro-1.1, nano-banana-pro und seedream-5.0-lite; bei jedem anderen Modell gibt die Anfrage 400 unsupported_async_mode zurück. Abgeschlossene asynchrone Bildaufgaben geben unabhängig vom angeforderten response_format URLs zurück; verwenden Sie synchrone Anfragen, wenn Sie b64_json benötigen.

stylestring

Optionaler Stil-Selektor. Senden Sie diesen nur, wenn das ausgewählte Modell ihn explizit dokumentiert; lassen Sie ihn für gpt-image-2 weg, es sei denn, die Modell-Metadaten geben etwas anderes an.

userstring

Eine eindeutige Kennung für den Endbenutzer.

Einige Modelle akzeptieren auch Felder wie negative_prompt, seed, width, height, steps, guidance_scale oder mask_url. Senden Sie diese nur, wenn sie in den Details des Modells aufgeführt sind. stream: true wird nicht unterstützt und gibt 400 unsupported_parameter zurück.

Antwort

Inline Response

createdinteger

Unix-Zeitstempel der Erstellung.

dataarray

Array der generierten Bilder.

Jedes Objekt enthält:

  • url (string): TokenLab-Medien-Ergebnis-URL des Bildes, 30 Tage gültig. Nicht vorhanden, wenn response_format b64_json ist. Wenn response_format weggelassen wird, fehlt dies, falls TokenLab das Bild nicht speichern konnte.
  • b64_json (string): Base64-Bilddaten. Vorhanden, wenn response_format b64_json ist oder wenn es weggelassen wird und das Modell Bild-Bytes zurückgibt.
  • revised_prompt (string): Optionale Überarbeitung des Prompts, wenn das ausgewählte Modell eine solche zurückgibt
usageobject

Token-Anzahlen (input_tokens, output_tokens, total_tokens und deren Details) für nach Token abgerechnete Modelle wie gpt-image-2, sofern verfügbar.

svg_usageobject

Token-Anzahl des SVG-Authoring-Modells (model, input_tokens, output_tokens, reasoning_tokens, total_tokens). Nur bei SVG-Ausgabe vorhanden. Diese Token sind nicht in usage enthalten und werden zu den Preisen für das SVG-Authoring abgerechnet.

Async Task Response

Setzen Sie async: true bei einem Modell, das dies unterstützt, um einen Task zu erstellen, anstatt in der Erstellungsanfrage auf das finale Bild zu warten. Die Antwort enthält status: "pending", task_id und poll_url. Pollen Sie /v1/tasks/{task_id}, bis der Task den Status completed oder failed erreicht.

Asynchrone Bild-Tasks geben ausschließlich finale Bild-URLs zurück. Wenn Sie rohe b64_json-Bilddaten benötigen, verwenden Sie eine synchrone Anfrage.

Bei der Erstellung des Tasks kann die Abrechnung den geschätzten Betrag reservieren. Abgeschlossene Tasks werden nach tatsächlicher Nutzung abgerechnet, und fehlgeschlagene oder abgelaufene Tasks werden freigegeben oder erstattet.

createdinteger

Unix-Zeitstempel der Erstellung.

task_idstring

Eindeutige Task-Kennung für das Polling.

statusstring

Ursprünglicher Status: pending.

poll_urlstring

Relative URL zum Abrufen der Ergebnisse (Polling), zum Beispiel /v1/tasks/{id}.

dataarray

Leer, solange der Task aussteht. Abgeschlossene Bild-Tasks geben generierte Bild-URLs in data[].url zurück.

Wenn Sie status: "pending" erhalten, rufen Sie GET /v1/tasks/{task_id} auf, um das Ergebnis abzurufen.

Anfrage

cURL
curl -X POST "https://api.tokenlab.sh/v1/images/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image",
    "prompt": "A cinematic portrait of a white cat sitting on a rainy windowsill",
    "aspect_ratio": "16:9",
    "resolution": "2k"
  }'
Python
from openai import OpenAI

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

response = client.images.generate(
    model="gemini-3-pro-image",
    prompt="A cinematic portrait of a white cat sitting on a rainy windowsill",
    extra_body={"aspect_ratio": "16:9", "resolution": "2k"}
)

print(response.data[0].url)
JavaScript
import OpenAI from 'openai';

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

const response = await client.images.generate({
  model: 'gemini-3-pro-image',
  prompt: 'A cinematic portrait of a white cat sitting on a rainy windowsill',
  aspect_ratio: '16:9',
  resolution: '2k'
});

console.log(response.data[0].url);
PHP
<?php
$ch = curl_init('https://api.tokenlab.sh/v1/images/generations');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Authorization: Bearer sk-your-api-key'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'model' => 'gemini-3-pro-image',
        'prompt' => 'A cinematic portrait of a white cat sitting on a rainy windowsill',
        'aspect_ratio' => '16:9',
        'resolution' => '2k'
    ])
]);

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

$data = json_decode($response, true);
echo $data['data'][0]['url'];

Beispiel für eine Bildfamilie nur mit Seitenverhältnis: Senden Sie für nano-banana aspect_ratio, lassen Sie jedoch resolution weg:

{
  "model": "nano-banana",
  "prompt": "A clean editorial product shot of a citrus soda can",
  "aspect_ratio": "16:9"
}

Beispiel für Nano Banana Pro mit Referenzbild: Senden Sie die Anfrage an /v1/images/generations, nicht an /v1/images/edits. resolution ist optional und kann auf 1k, 2k oder 4k gesetzt werden:

{
  "model": "nano-banana-pro",
  "prompt": "Create a clean cinematic character image based on the reference images",
  "operation": "image-to-image",
  "image_urls": ["https://example.com/reference-1.png"],
  "aspect_ratio": "1:1",
  "resolution": "2k"
}

Beispiel für einen direkten Multipart-Upload für private oder lokale Quellbilder. Übergeben Sie keine file_id an /v1/images/generations:

curl -X POST "https://api.tokenlab.sh/v1/images/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=nano-banana-pro" \
  -F "prompt=Create a clean cinematic character image based on this reference" \
  -F "operation=image-to-image" \
  -F "image=@reference.png" \
  -F "aspect_ratio=1:1" \
  -F "resolution=2k"

Antwort

{
  "created": 1706000000,
  "data": [
    {
      "url": "https://...",
      "revised_prompt": "A fluffy white cat with bright eyes sitting peacefully on a wooden windowsill, watching raindrops stream down the glass window..."
    }
  ]
}

Fehler

Fehlerhafte Anfragen geben 400 (413 bei zu großen Uploads) mit einem error.code zurück. Häufige Codes bei Bildanfragen:

CodeUrsache
unsupported_parameterDas Modell führt das Feld nicht auf oder stream ist true
unsupported_operationDas Modell verfügt über keine solche operation
unsupported_endpointDie Operation für dieses Modell befindet sich auf einem anderen Endpunkt, wie z. B. /v1/images/edits
unsupported_async_modeDas Modell unterstützt async: true nicht
invalid_resolution, invalid_aspect_ratio, invalid_parameter_value, too_many_itemsEin Wert liegt außerhalb des vom Modell Akzeptierten. Der Fehler nennt die zulässigen Werte
invalid_image_size_contractEine size oder Stufe, die das Modell nicht unterstützt, oder eine, die mit resolution in Konflikt steht
prompt_too_longDer Prompt ist länger als das Modell akzeptiert
request_too_large, file_too_largeEin Upload überschreitet das Größenlimit (50 MiB pro Datei, 200 MiB für alle Eingaben)

Informationen zu Guthaben (402), Rate-Limits (429) und Wiederholungsregeln finden Sie unter Fehlerbehandlung.

Modell auswählen

Rufen Sie GET /v1/models?recommended_for=image ab oder nutzen Sie die Modellseite, um die aktuelle Verfügbarkeit, Funktionen und Preise einzusehen.

Legen Sie ein Modell im Code nicht als immer synchron oder immer asynchron fest. Eine Anfrage ohne async: true kann dennoch status: "pending" zurückgeben; wann immer die Erstellungsantwort status: "pending" oder status: "processing" enthält, pollen Sie GET /v1/tasks/{task_id} bis zum Abschluss.

Umgang mit Task-basierten Antworten

Prüfen Sie bei Bildmodellen stets, ob die Antwort status: "pending" / status: "processing" enthält:

import requests
import time

def generate_image(prompt, model="gpt-image-2"):
    # Create image request
    response = requests.post(
        "https://api.tokenlab.sh/v1/images/generations",
        headers={"Authorization": "Bearer sk-your-api-key"},
        json={"model": model, "prompt": prompt, "async": True},
        timeout=120
    )
    response.raise_for_status()
    data = response.json()

    # Check if task-based
    if data.get("status") in ("pending", "processing"):
        task_id = data["task_id"]
        print(f"Image task started: {task_id}")

        # Poll for result
        deadline = time.time() + 600
        while time.time() < deadline:
            status_resp = requests.get(
                f"https://api.tokenlab.sh/v1/tasks/{task_id}",
                headers={"Authorization": "Bearer sk-your-api-key"},
                timeout=30
            )
            status_resp.raise_for_status()
            status_data = status_resp.json()

            if status_data["status"] == "completed":
                return status_data["data"][0]["url"]
            elif status_data["status"] == "failed":
                raise Exception(status_data.get("error", "Generation failed"))

            time.sleep(3)
        raise TimeoutError(f"Image task {task_id} did not finish in time")
    else:
        # Inline response
        return data["data"][0]["url"]

# Usage
url = generate_image("a beautiful sunset over mountains", model="gpt-image-2")
print(f"Generated image: {url}")

Beispiel für Hy Image 3.5 Preview. Es akzeptiert ausschließlich size 1024x1024 und n 1:

{
  "model": "hy-image-v3.5-preview",
  "prompt": "A yellow lemon on a white table",
  "size": "1024x1024",
  "n": 1,
  "response_format": "url"
}

Autorisierung

BearerAuth
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Header

X-TokenLab-Delivery-Policy?string

Zustellungsrichtlinie pro Anfrage. Überschreibt die API-Key- und Workspace-Standardeinstellungen. Versucht automatisch zuerst TokenLab Verified und kann vor der Ausgabe, der Annahme der Anfrage oder der Erstellung persistenter Ressourcen einmalig auf Official umstellen.

Zulässige Werte

  • "auto"
  • "verified"
  • "official"
Idempotency-Key?string

Optionaler Schlüssel, der eine Bildanfrage sicher für Wiederholungsversuche macht, sofern die Anfrage eine Aufgabe erstellt hat. Senden Sie für jede Anfrage einen neuen eindeutigen Wert, wie z. B. eine UUID. Ein Wiederholungsversuch mit demselben Schlüssel und demselben Body gibt dann diese Aufgabe zurück und erstellt, versendet oder berechnet keine zweite Aufgabe. Bei einer Anfrage, die das Bild direkt zurückgibt, kann ein Wiederholungsversuch mit demselben Schlüssel einen Aufgabenstatus anstelle des Bildes oder 409 mit idempotent_response_not_replayable zurückgeben. Ein abweichender Body mit einem bereits akzeptierten Schlüssel wird abgelehnt; der Statuscode und Fehlercode für diesen Fall sind nicht garantiert. Ein Schlüssel mit mehr als 255 Zeichen wird ignoriert, und die Anfrage verfügt dann über keinen Idempotenz-Schutz. Siehe Sichere Wiederholungsversuche mit einem Idempotenz-Schlüssel.

Länge1 <= length <= 255

Anfragekörper

Antwort

application/json

application/json

application/json

application/json

application/json

application/json

application/json