Bildanfragen

Verwenden Sie Bildantworten mit einer vorhersehbaren API-Anfrage.

Überprüfen Sie die Verarbeitung von Bildanfragen über den OpenAI-kompatiblen Bildendpunkt mit zurückgegebenen URLs oder b64_json-Nutzlasten und sorgen Sie gleichzeitig dafür, dass Eingabeaufforderungen sicher, Anmeldeinformationen serverseitig und die Bildnutzung sichtbar bleiben.

Anforderungsform anzeigen Überprüfen Sie die Authentifizierung

Zuletzt aktualisiert: July 12, 2026. Examples Nutzung safe placeholders und tun nicht enthalten real API-Schluessels, Geheimnisse, customer Nutzdaten, oder sensibel Prompts.

Standardpfad

Beginnen Sie mit einem Bild, einer standardmäßigen quadratischen Größe und einem URL-Antwortformat. Fügen Sie größere Größen oder Base64 nur dann hinzu, wenn der Arbeitsablauf sie benötigt.

Einrichtung-Pfad

Vier Schritte von der Eingabeaufforderung bis zur zurückgegebenen Asset-Form.

Step 1

Serverseitig authentifizieren

Verwenden Sie einen API-Schlüssel mit dem Bereich „images:write“ aus vertrauenswürdigem serverseitigem Code.

Abschnitt öffnen

Step 2

Senden Sie eine Aufforderung

Veröffentlichen Sie eine sichere Eingabeaufforderung, Bildanzahl, -größe und ein Antwortformat an den Bildendpunkt.

Abschnitt öffnen

Step 3

Zurückgegebene Assets lesen

Verwenden Sie zurückgegebene URLs oder b64_json-Nutzlasten entsprechend dem von Ihrer App angeforderten Antwortformat.

Abschnitt öffnen

Step 4

Bildnutzung ansehen

Bildanfragen zeichnen das Anfragevolumen auf, fordern Token auf und geben Bildelemente für Protokolle und Ratenbegrenzungsüberprüfungen zurück.

Abschnitt öffnen

Endpunkt

Veröffentlichen Sie Eingabeaufforderungen an den Bildendpunkt.

Verwenden Sie die Bildroute /v1 mit einem bereichsbezogenen serverseitigen Schlüssel, bevor Bildworkflows Kunden erreichen. Bewahren Sie zeitnahe Inhalte sicher auf und vermeiden Sie die Platzierung sensibler Daten in Bildanfragen.

Anforderungen und Hinweise zum Bildanforderungsendpunkt.
Artikel	Wert	Notizen
Methode	POST	Senden Sie JSON an den Bildendpunkt.
Endpunkt	https://unlimitedcodex.com/v1/images/generations	Verwenden Sie den OpenAI-kompatiblen /v1-Bildpfad.
Autorisierung	Inhabertoken	Verwenden Sie einen bereichsbezogenen API-Schlüssel mit images:write-Zugriff.
Inhaltstyp	application/json	Der Anforderungstext muss gültig sein: JSON.

Form anfordern

Halten Sie die erste Anfrage klein.

Beginnen Sie mit einer Bild- und URL-Ausgabe, während Sie den Ablauf validieren. Erhöhen Sie Anzahl, Größe oder Inline-Base64 erst, nachdem Ihre Benutzeroberfläche und die Tarifverwaltung bereit sind.

Bildanforderungsfelder, Status und Notizen.
Feld	Status	Notizen
Modell	Empfohlen	Übergeben Sie explizit einen Bildmodellwert. Verwenden Sie den Modellwert aus Ihren gelieferten Einrichtung-Details.
Aufforderung	Erforderlich	Senden Sie eine nicht leere Eingabeaufforderung mit bis zu 4000 Zeichen. Vermeiden Sie Geheimnisse, regulierte Daten und kundenidentifizierende Details.
n	Optional	Fordern Sie 1 bis 4 Bilder an. Der Standardwert ist 1.
Größe	Optional	Verwenden Sie 256 x 256, 512 x 512, 1024 x 1024, 1024 x 1792 oder 1792 x 1024. Der Standardwert ist 1024 x 1024.
Antwortformat	Optional	Verwenden Sie URL für eine abrufbare Asset-Referenz oder b64_json für Inline-Base64-Daten.

const response = await fetch("https://unlimitedcodex.com/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.UCX_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "ucx-image-1",
    prompt: "A clean product illustration of an API usage dashboard.",
    n: 1,
    size: "1024x1024",
    response_format: "url"
  })
});

const body = await response.json();

if (!response.ok) {
  throw new Error(body.error?.code ?? "image_request_failed");
}

const firstImageUrl = body.data[0].url;

Antwortform

Lesen Sie das von Ihrer App angeforderte Asset-Format.

Die Antwort umfasst Anforderungsmetadaten und ein Datenelement pro zurückgegebenem Bild. Verwenden Sie URL oder b64_json basierend auf dem Antwortformat.

Bildantwortfelder, Bedeutungen und Hinweise.
Feld	Bedeutung	Notizen
ID	Bildanforderungs-ID	Für Protokolle und Kundendienst-Eskalation verwenden.
erstellt	Unix-Zeitstempel	Gibt an, wann die Antwort erstellt wurde.
Modell	Modellzeichenfolge	Entspricht dem angeforderten Modellwert.
Größe	gewünschte Größe	Entspricht der vom Endpunkt akzeptierten Größe.
data[].url	Vermögenswert URL	Wird zurückgegeben, wenn das Antwortformat eine URL ist.
data[].b64_json	Base64-Asset-Daten	Wird zurückgegeben, wenn das Antwortformat b64_json ist.

{
  "id": "img_example",
  "created": 1783372800,
  "model": "ucx-image-1",
  "size": "1024x1024",
  "data": [
    {
      "url": "https://unlimitedcodex.com/v1/images/example.png",
      "revised_prompt": "A clean product illustration of an API usage dashboard."
    }
  ]
}

{
  "model": "ucx-image-1",
  "prompt": "A simple square app icon for an internal tool.",
  "n": 1,
  "size": "512x512",
  "response_format": "b64_json"
}

Grenzen und Fehler

Planen Sie die Bildnutzung und vollständige Antworten ein.

Bildanfrage-Arbeitsabläufe können zu stärkeren Nutzungsspitzen führen als reine Textanfragen. Überprüfen Sie vor dem Start von Kampagnen oder Batch-Jobs die Passgenauigkeit des Pakets und die Handhabung von 429-Fehlern.

Pakettarifbegrenzungen Überprüfen Sie Fehler

Der aktuelle Bildendpunkt streamt keinen Teilfortschritt. Die Antwort wird zurückgegeben, nachdem die Anfrage abgeschlossen ist.

Jedes zurückgegebene Bildelement wird zur Sichtbarkeit der Nutzung protokolliert und jeder Aufruf zählt als eine Anfrage.

Prompt-Text trägt auch zu Token- und Kostenvoranschlägen bei.

Verwenden Sie bei der Validierung eines Arbeitsabläufe kleine n-Werte und erhöhen Sie sie nur, wenn das Produkt mehrere Variationen benötigt.

Behandeln Sie 429-Rate-Antworten, bevor Hintergrundbildjobs einen für den Benutzer sichtbaren Fehler verursachen.

FAQ

Fragen zur Bildanfrage.

Welchen Bildendpunkt soll ich aufrufen?

Verwenden Sie POST /v1/images/generations mit einem Bearer-API-Schlüssel, einem Anforderungstext JSON, einem Modell, einer Eingabeaufforderung, einer optionalen Bildanzahl, einer optionalen Größe und einem optionalen Antwortformat.

Welchen Umfang benötigt ein Bildschlüssel?

Verwenden Sie einen API-Schlüssel mit dem Bereich images:write. Halten Sie es serverseitig und legen Sie es niemals in Browsercode, Mobilpaketen, Protokollen oder Supportnachrichten offen.

Können Bildanfragen den Fortschritt streamen?

Nein. Der aktuelle Endpunkt gibt eine vollständige Antwort zurück, nachdem die Anfrage abgeschlossen ist. Erstellen Sie benutzerorientierte Ladezustände und Timeout-Behandlung in Ihrer App.

Soll ich eine URL oder b64_json anfordern?

Verwenden Sie eine URL, wenn Ihre App eine Asset-Referenz abrufen oder speichern kann. Verwenden Sie b64_json, wenn Ihre App Inline-Bilddaten benötigt und größere Antworttexte verarbeiten kann.

Kostenlose Tools

Planen Sie das Volumen der Bildanfragen

Validieren Sie Nutzlasten, schätzen Sie die Kontingentauswirkungen ab, vergleichen Sie Paketkosten und erstellen Sie Anforderungsausschnitte vor dem Start.

Durchsuchen Sie alle Tools

Validator anfordern

Validieren Sie Chat, Einbettungen und Bildnutzlasten JSON anhand unlimitedcodex OpenAI-kompatibler Regeln.

Quotenschätzer

Konvertieren Sie MAU und geben Sie Annahmen in monatliche Token, Anfragen und Kontingentschwellenwarnungen um.

Kostenrechner

Schätzen Sie die monatlichen Ausgaben von OpenAI und vergleichen Sie sie mit wöchentlichen oder monatlichen Pauschalpaketen von unlimitedcodex.

Anfrage Entwickler

Erstellen Sie den Chat-Abschluss JSON visuell und exportieren Sie cURL-, JavaScript- oder Python-Snippets.

Naechster Schritt

Kombinieren Sie die Bearbeitung von Bildanfragen mit Ratenbegrenzungen und Fehlerbehandlung.

Bevor Kunden auf die Bildausgabe angewiesen sind, bestätigen Sie die Eingabeaufforderungsrichtlinie, die Bildverwendung, das Wiederholungsverhalten und die Antwortspeicherung.

Pakettarifbegrenzungen Überprüfen Sie die Einbettungen