OpenAI: DALL·E 3
DALL·E 3 generuje obrazy z pisemnego opisu sceny. Używaj dokładnego identyfikatora modelu openai/dall-e-3 lub jego aliasu dall-e-3 z metodą generowania obrazów, a następnie zapisuj każdy zwrócony adres URL obrazu i towarzyszący wynik. Udokumentowane żądanie początkowe tworzy jeden obraz 1024x1024 z tekstu.
- Ailoot Ultra · Images
POST /v1/images/generationsopenai/dall-e-3 - Ailoot Ultra · Images
POST /v1/images/generationsdall-e-3
O modelu
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
DALL·E 3 to model OpenAI tworzący obrazy z tekstu. Użyj pisemnego opisu do stworzenia ilustracji, koncepcji sceny lub kierunku wizualnego projektu. Opisz temat, otoczenie, kompozycję, oświetlenie i sposób przedstawienia w polu prompt. Na przykład opis koncepcji może żądać roweru dostawczego obok małego sklepu o zmierzchu, widzianego z ulicy, z wyraźnym tematem na pierwszym planie i oszczędną paletą kolorów.
Wyślij POST /v1/images/generations z treścią application/json. Dokładny publiczny identyfikator modelu to openai/dall-e-3; dopuszczony alias dall-e-3 wybiera tę samą kartę modelu. Udokumentowana forma początkowa zawiera model, prompt, n:1 i size:"1024x1024". n jest opcjonalną liczbą całkowitą i domyślnie wynosi 1. Wyślij stream:false lub pomiń stream, aby uzyskać kompletny wynik JSON. Użyj niepustej treści tekstowej w polu prompt i skup to żądanie na jednym kompletnym opisie obrazu. Oferowaną metodą jest generowanie obrazu z tekstu.
Wyraźnie określ wymagania istotne dla miejsca wykorzystania. Ilustracja redakcyjna może nazywać główną ideę i przedmioty, które ją wyrażają. Koncepcja sceny może określać pozycję kamery, porę dnia i części kompozycji wymagające przestrzeni wokół. Oddziel dokładne brzmienie tekstu, który musi pojawić się na obrazie, od opisów sceny, a następnie sprawdź wyrenderowane napisy i układ wizualny przed użyciem wybranego wyniku.
Odpowiedź generowania jest JSON z sygnaturą czasu created i tablicą data. Udokumentowany element wyniku zawiera url i może zawierać revised_prompt, prompt_filter_results i content_filter_results. Zachowaj te pola wraz z kompletną odpowiedzią i pobierz obraz z każdego zwróconego podpisanego adresu URL Ailoot. Podpisane łącza do plików Ailoot są ważne przez 24 godziny od wystawienia. Zachowaj dokładny zwrócony adres URL wraz z jego ciągiem zapytania do chwili zapisania pliku; ustal format zapisanego obrazu na podstawie rzeczywistej odpowiedzi lub bajtów pliku.
Traktuj zwrócony plik obrazu jako użyteczny zasób projektowy, a JSON jako towarzyszący mu zapis generowania. Oceń obraz względem dostarczonego opisu przed umieszczeniem go na stronie, w prezentacji lub aplikacji. Jeśli odpowiedź jest niepełna lub wynik wysłania jest niepewny, zachowaj identyfikator pierwotnego żądania i zwrócone informacje podczas sprawdzania istniejącej próby, zamiast tworzyć kolejny obraz wyłącznie w celu odzyskania brakującego wyniku. Aby pobrać zapisane wyniki, użyj tego samego klucza API do GET /v1/media/assets?family=image i przejdź przez każdy next_cursor. Identyfikator zasobu występuje w każdym zwróconym adresie URL /v1/media/assets/{asset_id}/content i w jego zapisie w bibliotece multimediów. Wywołaj GET /v1/media/assets/{asset_id} dla każdego wybranego zapisu i pobierz jego dokładny content_url. Jeśli żądanie pliku zwróci 404 z kodem link_expired, odczytaj ponownie ten sam zasób, aby uzyskać odświeżone łącze. Odświeżenie łącza zasobu nie wymaga kolejnego żądania generowania obrazu.
Ailoot Ultra · Images POST /v1/images/generations openai/dall-e-3
openai/dall-e-3openai/dall-e-3dall-e-3
Start
DALL·E 3 generuje obrazy z pisemnego opisu sceny. Używaj dokładnego identyfikatora modelu openai/dall-e-3 lub jego aliasu dall-e-3 z metodą generowania obrazów, a następnie zapisuj każdy zwrócony adres URL obrazu i towarzyszący wynik. Udokumentowane żądanie początkowe tworzy jeden obraz 1024x1024 z tekstu.
- Akceptowane dane wejściowe
- Tekst
- Wyniki
- Obrazy
Dostępne w Ailoot · dane wejściowe i metody
Ailoot Ultra · Images POST /v1/images/generations
- Wejście
text- Wyjście
image- Format wyjściowy
- Plik obrazu
| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity openai/dall-e-3 | Domyślnie— |
Poleprompt | Typstring | WymaganieWymagane | Wartości i limity | Domyślnie— |
Polestream | Typboolean | WymaganieOpcjonalne | Wartości i limity false | Domyślniefalse |
Polen | Typinteger | WymaganieOpcjonalne | Wartości i limity 1 | Domyślnie— |
Polesize | Typstring | WymaganieOpcjonalne | Wartości i limity 1024x1024 | Domyślnie— |
Parametry i cykl życia metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt |
Parametroptional | Kontraktstream, n, size |
Parametrmaterial_types | Kontrakttext |
Parametrconditions | KontraktUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Cykl życia: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Cennik
Jak obliczana jest ostateczna opłata
Wyświetlane stawki służą do oszacowania kosztu przed generowaniem. Ostateczna opłata jest obliczana na podstawie kosztu zarejestrowanego dla pierwotnego generowania. Zmierzony czas trwania wyniku i prognozowane ilości nie stanowią ostatecznej ilości podlegającej rozliczeniu.
Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.
- Tryb szybki
- Nie określono Gdy wybrany jest tryb szybki
- Tryb flex
- Nie określono Gdy wybrany jest tryb flex
- Maksymalna intensywność rozumowania
- Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)
Szacunkowe stawki do porównania
Ceny według konfiguracji
Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.
| Konfiguracja | Tabela stawek | Przewidywana ilość | Opłata |
|---|---|---|---|
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Przewidywana ilość— | Opłata Wejście · Tokeny wejściowe · Szacunek tylko do porównania — / 1K tokenów Wyjście · Tokeny wyjściowe · Szacunek tylko do porównania — / 1K tokenów Wejście · Odczyt cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache, 1 godz. · Szacunek tylko do porównania — / 1K tokenów |
| KonfiguracjaEstimated generation cost | Tabela stawek— | Przewidywana ilośćszacunek dla jednego generowania | Opłata Wejście · Szacowany koszt generowania · Szacunek tylko do porównania $0.32768 szacunek przed generowaniem This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
Przykładowe żądania
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.
Odbieranie i zapisywanie wyników
Ailoot Ultra · Images
Pobierz każdy zwrócony obraz lub zapisz jego zawartość Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Zachowaj wszystkie ukończone wyniki
Zapisz każdy ukończony obraz; pobierz każdy zwrócony URL lub zdekoduj zawartość Base64.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Jeśli trzeba sprawdzić pierwotną odpowiedź
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliasy
Aliasy modelu
Ailoot Ultra openai/dall-e-3, dall-e-3
Aliasy ścieżek metod
Użyj ścieżek metod podanych powyżej.
Powiązane ID modeli
Ailoot Ultra · Images POST /v1/images/generations dall-e-3
dall-e-3openai/dall-e-3dall-e-3
Start
DALL·E 3 generuje obrazy z pisemnego opisu sceny. Używaj dokładnego identyfikatora modelu openai/dall-e-3 lub jego aliasu dall-e-3 z metodą generowania obrazów, a następnie zapisuj każdy zwrócony adres URL obrazu i towarzyszący wynik. Udokumentowane żądanie początkowe tworzy jeden obraz 1024x1024 z tekstu.
- Akceptowane dane wejściowe
- Tekst
- Wyniki
- Obrazy
Dostępne w Ailoot · dane wejściowe i metody
Ailoot Ultra · Images POST /v1/images/generations
- Wejście
text- Wyjście
image- Format wyjściowy
- Plik obrazu
| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity dall-e-3 | Domyślnie— |
Poleprompt | Typstring | WymaganieWymagane | Wartości i limity | Domyślnie— |
Polestream | Typboolean | WymaganieOpcjonalne | Wartości i limity false | Domyślniefalse |
Polen | Typinteger | WymaganieOpcjonalne | Wartości i limity 1 | Domyślnie— |
Polesize | Typstring | WymaganieOpcjonalne | Wartości i limity 1024x1024 | Domyślnie— |
Parametry i cykl życia metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt |
Parametroptional | Kontraktstream, n, size |
Parametrmaterial_types | Kontrakttext |
Parametrconditions | KontraktUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Cykl życia: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Cennik
Jak obliczana jest ostateczna opłata
Wyświetlane stawki służą do oszacowania kosztu przed generowaniem. Ostateczna opłata jest obliczana na podstawie kosztu zarejestrowanego dla pierwotnego generowania. Zmierzony czas trwania wyniku i prognozowane ilości nie stanowią ostatecznej ilości podlegającej rozliczeniu.
Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.
- Tryb szybki
- Nie określono Gdy wybrany jest tryb szybki
- Tryb flex
- Nie określono Gdy wybrany jest tryb flex
- Maksymalna intensywność rozumowania
- Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)
Szacunkowe stawki do porównania
Ceny według konfiguracji
Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.
| Konfiguracja | Tabela stawek | Przewidywana ilość | Opłata |
|---|---|---|---|
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Przewidywana ilość— | Opłata Wejście · Tokeny wejściowe · Szacunek tylko do porównania — / 1K tokenów Wyjście · Tokeny wyjściowe · Szacunek tylko do porównania — / 1K tokenów Wejście · Odczyt cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache, 1 godz. · Szacunek tylko do porównania — / 1K tokenów |
| KonfiguracjaEstimated generation cost | Tabela stawek— | Przewidywana ilośćszacunek dla jednego generowania | Opłata Wejście · Szacowany koszt generowania · Szacunek tylko do porównania $0.32768 szacunek przed generowaniem This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
Przykładowe żądania
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.
Odbieranie i zapisywanie wyników
Ailoot Ultra · Images
Pobierz każdy zwrócony obraz lub zapisz jego zawartość Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Zachowaj wszystkie ukończone wyniki
Zapisz każdy ukończony obraz; pobierz każdy zwrócony URL lub zdekoduj zawartość Base64.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Jeśli trzeba sprawdzić pierwotną odpowiedź
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliasy
Aliasy modelu
Ailoot Ultra openai/dall-e-3, dall-e-3
Aliasy ścieżek metod
Użyj ścieżek metod podanych powyżej.
Powiązane ID modeli
FAQ · OpenAI: DALL·E 3
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/images/generations·openai/dall-e-3:text→imagePOST /v1/images/generations·dall-e-3:text→image- Jakich pól używa żądanie?
POST /v1/images/generations·openai/dall-e-3:model,prompt,stream,n,sizePOST /v1/images/generations·dall-e-3:model,prompt,stream,n,size