OpenAI: DALL·E 3
DALL·E 3 generiert Bilder aus einer schriftlichen Szenenbeschreibung. Verwenden Sie die genaue Modell-ID openai/dall-e-3 oder den Alias dall-e-3 mit der Bildgenerierungsmethode und speichern Sie anschliessend jede zurückgegebene Bild-URL und das begleitende Ergebnis. Eine dokumentierte Ausgangsanfrage erzeugt ein 1024x1024-Bild aus Text.
- Ailoot Ultra · Images
POST /v1/images/generationsopenai/dall-e-3 - Ailoot Ultra · Images
POST /v1/images/generationsdall-e-3
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
DALL·E 3 ist OpenAIs Modell zur Bilderzeugung aus Text. Verwenden Sie eine schriftliche Aufgabenbeschreibung, um eine Illustration, ein Szenenkonzept oder eine visuelle Richtung für eine Gestaltung zu erstellen. Beschreiben Sie im Prompt Motiv, Umgebung, Komposition, Beleuchtung und Gestaltung. Beispielsweise kann eine Konzeptbeschreibung ein Lieferfahrrad neben einem kleinen Geschäft in der Abenddämmerung verlangen, von der Strasse aus gesehen, mit einem klaren Vordergrundmotiv und einer zurückhaltenden Farbpalette.
Senden Sie POST /v1/images/generations mit einem application/json-Body. Die genaue öffentliche Modell-ID lautet openai/dall-e-3; der zugelassene Alias dall-e-3 wählt dieselbe Modellkarte. Die dokumentierte Ausgangsstruktur enthält model, prompt, n:1 und size:"1024x1024". n ist eine optionale Ganzzahl mit dem Standardwert 1. Senden Sie stream:false oder lassen Sie stream weg, um das vollständige JSON-Ergebnis zu erhalten. Verwenden Sie einen nicht leeren Textprompt und richten Sie diese Anfrage auf eine vollständige Bildbeschreibung aus. Die angebotene Methode ist die Bildgenerierung aus Text.
Formulieren Sie die für die Platzierung wichtigen Anforderungen ausdrücklich. Eine redaktionelle Illustration kann den Kerngedanken und die Objekte benennen, die ihn ausdrücken. Ein Szenenkonzept kann Kameraposition, Tageszeit und die Teile der Komposition bestimmen, die Raum um sich benötigen. Trennen Sie den genauen Wortlaut, der im Bild erscheinen muss, von Beschreibungen der Szene und prüfen Sie anschliessend die dargestellte Schrift und visuelle Anordnung, bevor Sie das ausgewählte Ergebnis verwenden.
Die Generierungsantwort ist JSON mit einem created-Zeitstempel und einem data-Array. Das dokumentierte Ergebniselement enthält url und kann revised_prompt, prompt_filter_results und content_filter_results enthalten. Bewahren Sie diese Felder mit der vollständigen Antwort auf und laden Sie das Bild unter jeder zurückgegebenen signierten Ailoot-URL herunter. Signierte Ailoot-Dateilinks sind ab Ausstellung 24 Stunden gültig. Behalten Sie die genaue zurückgegebene URL einschliesslich ihrer Abfragezeichenfolge, bis die Datei gespeichert ist; bestimmen Sie das gespeicherte Bildformat anhand der tatsächlichen Antwort oder der Dateibytes.
Behandeln Sie die zurückgegebene Bilddatei als verwendbares Gestaltungs-Asset und das JSON als begleitenden Generierungsdatensatz. Prüfen Sie das Bild anhand der bereitgestellten Aufgabenbeschreibung, bevor Sie es in eine Seite, Präsentation oder Anwendung einfügen. Ist die Antwort unvollständig oder der Sendeausgang ungewiss, bewahren Sie die ursprüngliche Anfragekennung und die zurückgegebenen Informationen auf, während Sie den bestehenden Versuch prüfen, statt nur zur Wiederherstellung des fehlenden Ergebnisses ein weiteres Bild zu erstellen. Verwenden Sie zum Abrufen gespeicherter Ergebnisse denselben API-Schlüssel für GET /v1/media/assets?family=image und folgen Sie jedem next_cursor. Die Asset-ID erscheint in jeder zurückgegebenen URL /v1/media/assets/{asset_id}/content und in ihrem Medienbibliotheksdatensatz. Lesen Sie GET /v1/media/assets/{asset_id} für jeden ausgewählten Datensatz und laden Sie dessen genaue content_url herunter. Wenn die Dateianfrage 404 mit dem Code link_expired zurückgibt, lesen Sie dasselbe Asset erneut, um einen aktualisierten Link zu erhalten. Das Aktualisieren eines Asset-Links erfordert keine weitere Bildgenerierungsanfrage.
Ailoot Ultra · Images POST /v1/images/generations openai/dall-e-3
openai/dall-e-3openai/dall-e-3dall-e-3
Einstieg
DALL·E 3 generiert Bilder aus einer schriftlichen Szenenbeschreibung. Verwenden Sie die genaue Modell-ID openai/dall-e-3 oder den Alias dall-e-3 mit der Bildgenerierungsmethode und speichern Sie anschliessend jede zurückgegebene Bild-URL und das begleitende Ergebnis. Eine dokumentierte Ausgangsanfrage erzeugt ein 1024x1024-Bild aus Text.
- Zulässige Eingaben
- Text
- Ergebnisse
- Bilder
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Images POST /v1/images/generations
- Eingabe
text- Ausgabe
image- Ausgabeformat
- Bilddatei
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits openai/dall-e-3 | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits | Standard— |
Feldstream | Typboolean | AnforderungOptional | Werte und Limits false | Standardfalse |
Feldn | Typinteger | AnforderungOptional | Werte und Limits 1 | Standard— |
Feldsize | Typstring | AnforderungOptional | Werte und Limits 1024x1024 | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parameteroptional | Vertragstream, n, size |
Parametermaterial_types | Vertragtext |
Parameterconditions | VertragUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Gebühr |
|---|---|---|---|
| KonfigurationToken-Basistarife | TarifstaffelGrundtarif | Prognostizierte Menge— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationEstimated generation cost | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Gebühr Eingabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.32768 Schätzung vor der Generierung This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "openai/dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Ergebnisse abrufen und speichern
Ailoot Ultra · Images
Laden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Bild; rufen Sie jede zurückgegebene URL ab oder dekodieren Sie seinen Base64-Inhalt.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Wenn die ursprüngliche Antwort geprüft werden muss
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliasnamen
Modellaliasnamen
Ailoot Ultra openai/dall-e-3, dall-e-3
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
Ailoot Ultra · Images POST /v1/images/generations dall-e-3
dall-e-3openai/dall-e-3dall-e-3
Einstieg
DALL·E 3 generiert Bilder aus einer schriftlichen Szenenbeschreibung. Verwenden Sie die genaue Modell-ID openai/dall-e-3 oder den Alias dall-e-3 mit der Bildgenerierungsmethode und speichern Sie anschliessend jede zurückgegebene Bild-URL und das begleitende Ergebnis. Eine dokumentierte Ausgangsanfrage erzeugt ein 1024x1024-Bild aus Text.
- Zulässige Eingaben
- Text
- Ergebnisse
- Bilder
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Images POST /v1/images/generations
- Eingabe
text- Ausgabe
image- Ausgabeformat
- Bilddatei
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits dall-e-3 | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits | Standard— |
Feldstream | Typboolean | AnforderungOptional | Werte und Limits false | Standardfalse |
Feldn | Typinteger | AnforderungOptional | Werte und Limits 1 | Standard— |
Feldsize | Typstring | AnforderungOptional | Werte und Limits 1024x1024 | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parameteroptional | Vertragstream, n, size |
Parametermaterial_types | Vertragtext |
Parameterconditions | VertragUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Gebühr |
|---|---|---|---|
| KonfigurationToken-Basistarife | TarifstaffelGrundtarif | Prognostizierte Menge— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationEstimated generation cost | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Gebühr Eingabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.32768 Schätzung vor der Generierung This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Ergebnisse abrufen und speichern
Ailoot Ultra · Images
Laden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Bild; rufen Sie jede zurückgegebene URL ab oder dekodieren Sie seinen Base64-Inhalt.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Wenn die ursprüngliche Antwort geprüft werden muss
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliasnamen
Modellaliasnamen
Ailoot Ultra openai/dall-e-3, dall-e-3
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · OpenAI: DALL·E 3
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/images/generations·openai/dall-e-3:text→imagePOST /v1/images/generations·dall-e-3:text→image- Welche Felder verwendet die Anfrage?
POST /v1/images/generations·openai/dall-e-3:model,prompt,stream,n,sizePOST /v1/images/generations·dall-e-3:model,prompt,stream,n,size