OpenAI: DALL·E 3
DALL·E 3 generoi kuvia kirjallisesta näkymäkuvauksesta. Käytä täsmällistä mallitunnusta openai/dall-e-3 tai sen aliasta dall-e-3 kuvagenerointimenetelmässä ja tallenna sitten jokainen palautettu kuvan URL ja mukana tuleva tulos. Dokumentoitu aloituspyyntö tuottaa tekstistä yhden 1024x1024-kuvan.
- Ailoot Ultra · Images
POST /v1/images/generationsopenai/dall-e-3 - Ailoot Ultra · Images
POST /v1/images/generationsdall-e-3
Tietoa mallista
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
DALL·E 3 on OpenAI:n tekstistä kuvaksi -malli. Luo kirjallisella kuvauksella kuvitus, näkymäkonsepti tai visuaalinen suunta suunnitelmalle. Kuvaile kehotteessa kohde, ympäristö, sommittelu, valaistus ja käsittely. Esimerkiksi konseptikuvaus voi pyytää jakelupolkupyörää pienen kaupan viereen hämärässä kadulta katsottuna, selkeää etualan kohdetta ja hillittyä väripalettia.
Lähetä POST /v1/images/generations application/json-rungolla. Täsmällinen julkinen mallitunnus on openai/dall-e-3; hyväksytty alias dall-e-3 valitsee saman mallikortin. Dokumentoitu aloitusrakenne sisältää model, prompt, n:1 ja size:"1024x1024". n on valinnainen kokonaisluku, jonka oletusarvo on 1. Lähetä stream:false tai jätä stream pois saadaksesi koko JSON-tuloksen. Käytä ei-tyhjää tekstikehotetta ja rajaa pyyntö yhteen kokonaiseen kuvakuvaukseen. Tarjottu menetelmä on kuvagenerointi tekstistä.
Ilmaise sijoittelulle tärkeät vaatimukset selkeästi. Toimituksellinen kuvitus voi nimetä keskeisen ajatuksen ja sitä ilmentävät esineet. Näkymäkonsepti voi määrittää kameran sijainnin, vuorokaudenajan ja ne sommittelun osat, joiden ympärille tarvitaan tilaa. Pidä kuvassa näytettävä täsmällinen sanamuoto erillään näkymän kuvauksista ja tarkista sitten muodostunut teksti ja visuaalinen asettelu ennen valitun tuloksen käyttämistä.
Generointivastaus on JSON, jossa on created-aikaleima ja data-taulukko. Dokumentoitu tuloskohde sisältää url-arvon ja voi sisältää revised_prompt-, prompt_filter_results- ja content_filter_results-kentät. Säilytä nämä kentät koko vastauksen kanssa ja lataa kuva jokaisesta palautetusta allekirjoitetusta Ailoot-URL-osoitteesta. Ailootin allekirjoitetut tiedostolinkit ovat voimassa 24 tuntia myöntämisestä. Säilytä täsmällinen palautettu URL kyselymerkkijonoineen tiedoston tallentamiseen asti; määritä tallennetun kuvan muoto todellisesta vastauksesta tai tiedoston tavuista.
Käsittele palautettua kuvatiedostoa käyttökelpoisena suunnitteluresurssina ja JSONia sen mukana tulevana generointitietueena. Tarkista kuva annettua kuvausta vasten ennen sen sijoittamista sivulle, esitykseen tai sovellukseen. Jos vastaus jää kesken tai lähetyksen lopputulos on epävarma, säilytä alkuperäisen pyynnön tunniste ja palautetut tiedot olemassa olevaa yritystä tarkistaessasi sen sijaan, että loisit uuden kuvan vain puuttuvan tuloksen palauttamiseksi. Nouda tallennetut tulokset samalla API-avaimella kutsulla GET /v1/media/assets?family=image ja käy läpi jokainen next_cursor. Resurssin tunnus näkyy kussakin palautetussa /v1/media/assets/{asset_id}/content-URL-osoitteessa ja sen mediakirjastotietueessa. Lue GET /v1/media/assets/{asset_id} kullekin valitulle tietueelle ja lataa sen täsmällinen content_url. Jos tiedostopyyntö palauttaa 404 ja koodin link_expired, lue sama resurssi uudelleen saadaksesi päivitetyn linkin. Resurssilinkin päivittäminen ei vaadi uutta kuvagenerointipyyntöä.
Ailoot Ultra · Images POST /v1/images/generations openai/dall-e-3
openai/dall-e-3openai/dall-e-3dall-e-3
Aloitus
DALL·E 3 generoi kuvia kirjallisesta näkymäkuvauksesta. Käytä täsmällistä mallitunnusta openai/dall-e-3 tai sen aliasta dall-e-3 kuvagenerointimenetelmässä ja tallenna sitten jokainen palautettu kuvan URL ja mukana tuleva tulos. Dokumentoitu aloituspyyntö tuottaa tekstistä yhden 1024x1024-kuvan.
- Hyväksytyt syötteet
- Teksti
- Tulokset
- Kuvat
Saatavilla Ailootissa · syötteet & menetelmät
Ailoot Ultra · Images POST /v1/images/generations
- Syötetyypit
text- Tulostyypit
image- Tulosteen muoto
- Kuvatiedosto
| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat openai/dall-e-3 | Oletus— |
Kenttäprompt | Tyyppistring | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttästream | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat false | Oletusfalse |
Kenttän | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat 1 | Oletus— |
Kenttäsize | Tyyppistring | VaatimusValinnainen | Arvot & rajat 1024x1024 | Oletus— |
Menetelmän parametrit ja elinkaari
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, prompt |
Parametrioptional | Sopimusstream, n, size |
Parametrimaterial_types | Sopimustext |
Parametriconditions | SopimusUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Elinkaari: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Hinnoittelu
Lopullisen veloituksen laskenta
Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
- Nopea tila
- Ei määritetty Kun nopea tila on valittu
- Flex-tila
- Ei määritetty Kun flex-tila on valittu
- Päättelyn enimmäisteho
- Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä
Arvioidut vertailuhinnat
Hinnat asetusten mukaan
Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.
| Asetukset | Hinnasto | Ennustettu määrä | Veloitus |
|---|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Ennustettu määrä— | Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten — / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten — / 1K tokenia |
| AsetuksetEstimated generation cost | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Veloitus Syöte · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.32768 arvio ennen generointia This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →
Esimerkkipyynnöt
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.
Vastaanota ja tallenna tulokset
Ailoot Ultra · Images
Lataa jokainen palautettu kuva tai tallenna sen Base64-sisältö
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Säilytä kaikki valmistuneet tulokset
Tallenna jokainen valmistunut kuva; nouda jokainen palautettu URL tai pura sen Base64-sisältö.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Jos alkuperäinen vastaus on tarkistettava
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliakset
Mallin aliakset
Ailoot Ultra openai/dall-e-3, dall-e-3
Menetelmäpolkujen aliakset
Käytä yllä näytettyjä menetelmäpolkuja.
Liittyvät kutsujan ID:t
Ailoot Ultra · Images POST /v1/images/generations dall-e-3
dall-e-3openai/dall-e-3dall-e-3
Aloitus
DALL·E 3 generoi kuvia kirjallisesta näkymäkuvauksesta. Käytä täsmällistä mallitunnusta openai/dall-e-3 tai sen aliasta dall-e-3 kuvagenerointimenetelmässä ja tallenna sitten jokainen palautettu kuvan URL ja mukana tuleva tulos. Dokumentoitu aloituspyyntö tuottaa tekstistä yhden 1024x1024-kuvan.
- Hyväksytyt syötteet
- Teksti
- Tulokset
- Kuvat
Saatavilla Ailootissa · syötteet & menetelmät
Ailoot Ultra · Images POST /v1/images/generations
- Syötetyypit
text- Tulostyypit
image- Tulosteen muoto
- Kuvatiedosto
| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat dall-e-3 | Oletus— |
Kenttäprompt | Tyyppistring | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttästream | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat false | Oletusfalse |
Kenttän | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat 1 | Oletus— |
Kenttäsize | Tyyppistring | VaatimusValinnainen | Arvot & rajat 1024x1024 | Oletus— |
Menetelmän parametrit ja elinkaari
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, prompt |
Parametrioptional | Sopimusstream, n, size |
Parametrimaterial_types | Sopimustext |
Parametriconditions | SopimusUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Elinkaari: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Hinnoittelu
Lopullisen veloituksen laskenta
Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
- Nopea tila
- Ei määritetty Kun nopea tila on valittu
- Flex-tila
- Ei määritetty Kun flex-tila on valittu
- Päättelyn enimmäisteho
- Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä
Arvioidut vertailuhinnat
Hinnat asetusten mukaan
Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.
| Asetukset | Hinnasto | Ennustettu määrä | Veloitus |
|---|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Ennustettu määrä— | Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten — / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten — / 1K tokenia |
| AsetuksetEstimated generation cost | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Veloitus Syöte · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.32768 arvio ennen generointia This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →
Esimerkkipyynnöt
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.
Vastaanota ja tallenna tulokset
Ailoot Ultra · Images
Lataa jokainen palautettu kuva tai tallenna sen Base64-sisältö
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Säilytä kaikki valmistuneet tulokset
Tallenna jokainen valmistunut kuva; nouda jokainen palautettu URL tai pura sen Base64-sisältö.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Jos alkuperäinen vastaus on tarkistettava
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliakset
Mallin aliakset
Ailoot Ultra openai/dall-e-3, dall-e-3
Menetelmäpolkujen aliakset
Käytä yllä näytettyjä menetelmäpolkuja.
Liittyvät kutsujan ID:t
FAQ · OpenAI: DALL·E 3
- Mitä syötteitä ja tuloksia on saatavilla?
POST /v1/images/generations·openai/dall-e-3:text→imagePOST /v1/images/generations·dall-e-3:text→image- Mitä kenttiä pyyntö käyttää?
POST /v1/images/generations·openai/dall-e-3:model,prompt,stream,n,sizePOST /v1/images/generations·dall-e-3:model,prompt,stream,n,size