OpenAI: DALL·E 3
DALL·E 3 genera immagini da un brief scritto della scena. Usa l'ID esatto openai/dall-e-3 o il suo alias dall-e-3 con il metodo di generazione di immagini, quindi salva ogni URL di immagine restituito e il risultato allegato. Una richiesta iniziale documentata produce un'immagine 1024x1024 da testo.
- Ailoot Ultra · Images
POST /v1/images/generationsopenai/dall-e-3 - Ailoot Ultra · Images
POST /v1/images/generationsdall-e-3
Informazioni sul modello
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
DALL·E 3 è il modello di OpenAI da testo a immagine. Usa un brief scritto per creare un'illustrazione, un concept di scena o una direzione visiva per un design. Descrivi nel prompt il soggetto, l'ambiente, la composizione, l'illuminazione e il trattamento. Ad esempio, un brief di concept può chiedere una bicicletta da consegna accanto a un piccolo negozio al crepuscolo, vista dalla strada, con un soggetto chiaro in primo piano e una tavolozza cromatica sobria.
Invia POST /v1/images/generations con un corpo application/json. L'ID pubblico esatto del modello è openai/dall-e-3; l'alias ammesso dall-e-3 seleziona la stessa scheda del modello. La forma iniziale documentata fornisce model, prompt, n:1 e size:"1024x1024". n è un intero facoltativo e ha 1 come valore predefinito. Invia stream:false oppure ometti stream per il risultato JSON completo. Usa un prompt testuale non vuoto e mantieni questa richiesta concentrata su un unico brief di immagine completo. Il metodo offerto è la generazione di immagini da testo.
Rendi espliciti i requisiti che contano per la destinazione. Un'illustrazione editoriale può indicare l'idea centrale e gli oggetti che la esprimono. Un concept di scena può specificare la posizione della camera, il momento della giornata e quali parti della composizione richiedono spazio intorno. Mantieni la formulazione esatta che deve apparire nell'immagine distinta dalle descrizioni della scena, quindi esamina le scritte renderizzate e la disposizione visiva prima di usare il risultato selezionato.
La risposta di generazione è JSON con un timestamp created e un array data. L'elemento di risultato documentato include url e può includere revised_prompt, prompt_filter_results e content_filter_results. Conserva questi campi insieme alla risposta completa e scarica l'immagine da ogni URL Ailoot firmato restituito. I link ai file firmati da Ailoot durano 24 ore dall'emissione. Mantieni l'URL esatto restituito, inclusa la stringa di query, finché il file non viene salvato; determina il formato dell'immagine salvata dalla risposta effettiva o dai byte del file.
Considera il file immagine restituito come la risorsa di design utilizzabile e il JSON come il relativo registro di generazione. Confronta l'immagine con il brief fornito prima di inserirla in una pagina, una presentazione o un'applicazione. Se la risposta è incompleta o l'esito dell'invio è incerto, conserva l'identificatore della richiesta originale e le informazioni restituite mentre verifichi il tentativo esistente, invece di creare un'altra immagine soltanto per recuperare il risultato mancante. Per recuperare i risultati salvati, usa la stessa chiave API per GET /v1/media/assets?family=image e segui ogni next_cursor. L'ID della risorsa appare in ogni URL /v1/media/assets/{asset_id}/content restituito e nel relativo record della libreria multimediale. Leggi GET /v1/media/assets/{asset_id} per ciascun record selezionato e scarica il suo content_url esatto. Se la richiesta del file restituisce 404 con codice link_expired, leggi nuovamente la stessa risorsa per ottenere un link aggiornato. Aggiornare il link di una risorsa non richiede un'altra richiesta di generazione di immagini.
Ailoot Ultra · Images POST /v1/images/generations openai/dall-e-3
openai/dall-e-3openai/dall-e-3dall-e-3
Introduzione
DALL·E 3 genera immagini da un brief scritto della scena. Usa l'ID esatto openai/dall-e-3 o il suo alias dall-e-3 con il metodo di generazione di immagini, quindi salva ogni URL di immagine restituito e il risultato allegato. Una richiesta iniziale documentata produce un'immagine 1024x1024 da testo.
- Input accettati
- Testo
- Risultati
- Immagini
Disponibile in Ailoot · input e metodi
Ailoot Ultra · Images POST /v1/images/generations
- Tipi di input
text- Tipi di output
image- Formato di output
- File immagine
| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti openai/dall-e-3 | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti | Predefinito— |
Campostream | Tipoboolean | RequisitoFacoltativo | Valori e limiti false | Predefinitofalse |
Campon | Tipointeger | RequisitoFacoltativo | Valori e limiti 1 | Predefinito— |
Camposize | Tipostring | RequisitoFacoltativo | Valori e limiti 1024x1024 | Predefinito— |
Parametri e ciclo di vita del metodo
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, prompt |
Parametrooptional | Contrattostream, n, size |
Parametromaterial_types | Contrattotext |
Parametroconditions | ContrattoUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Ciclo di vita: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tariffe
Calcolo del costo finale
Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
- Modalità rapida
- Non specificato Quando è selezionata la modalità rapida
- Modalità flex
- Non specificato Quando è selezionata la modalità flex
- Sforzo massimo di ragionamento
- Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)
Tariffe stimate per il confronto
Prezzi per configurazione
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Listino delle tariffe | Quantità prevista | Costo |
|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Costo Input · Token in input · Stima solo a fini di confronto — / 1K token Output · Token in output · Stima solo a fini di confronto — / 1K token Input · Lettura dalla cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto — / 1K token |
| ConfigurazioneEstimated generation cost | Listino delle tariffe— | Quantità previstastima per una generazione | Costo Input · Costo di generazione stimato · Stima solo a fini di confronto $0.32768 stima prima della generazione This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
Esempi di richieste
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.
Ricevi e salva i risultati
Ailoot Ultra · Images
Scarica ogni immagine restituita o salvane il contenuto Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Conserva tutti i risultati completati
Salva ogni immagine completata; recupera ogni URL restituito oppure decodificane il contenuto 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.
Se occorre verificare la risposta originale
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Alias
Alias del modello
Ailoot Ultra openai/dall-e-3, dall-e-3
Alias dei percorsi dei metodi
Usa i percorsi dei metodi indicati sopra.
ID di chiamata correlati
Ailoot Ultra · Images POST /v1/images/generations dall-e-3
dall-e-3openai/dall-e-3dall-e-3
Introduzione
DALL·E 3 genera immagini da un brief scritto della scena. Usa l'ID esatto openai/dall-e-3 o il suo alias dall-e-3 con il metodo di generazione di immagini, quindi salva ogni URL di immagine restituito e il risultato allegato. Una richiesta iniziale documentata produce un'immagine 1024x1024 da testo.
- Input accettati
- Testo
- Risultati
- Immagini
Disponibile in Ailoot · input e metodi
Ailoot Ultra · Images POST /v1/images/generations
- Tipi di input
text- Tipi di output
image- Formato di output
- File immagine
| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti dall-e-3 | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti | Predefinito— |
Campostream | Tipoboolean | RequisitoFacoltativo | Valori e limiti false | Predefinitofalse |
Campon | Tipointeger | RequisitoFacoltativo | Valori e limiti 1 | Predefinito— |
Camposize | Tipostring | RequisitoFacoltativo | Valori e limiti 1024x1024 | Predefinito— |
Parametri e ciclo di vita del metodo
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, prompt |
Parametrooptional | Contrattostream, n, size |
Parametromaterial_types | Contrattotext |
Parametroconditions | ContrattoUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Ciclo di vita: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tariffe
Calcolo del costo finale
Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
- Modalità rapida
- Non specificato Quando è selezionata la modalità rapida
- Modalità flex
- Non specificato Quando è selezionata la modalità flex
- Sforzo massimo di ragionamento
- Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)
Tariffe stimate per il confronto
Prezzi per configurazione
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Listino delle tariffe | Quantità prevista | Costo |
|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Costo Input · Token in input · Stima solo a fini di confronto — / 1K token Output · Token in output · Stima solo a fini di confronto — / 1K token Input · Lettura dalla cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto — / 1K token |
| ConfigurazioneEstimated generation cost | Listino delle tariffe— | Quantità previstastima per una generazione | Costo Input · Costo di generazione stimato · Stima solo a fini di confronto $0.32768 stima prima della generazione This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
Esempi di richieste
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.
Ricevi e salva i risultati
Ailoot Ultra · Images
Scarica ogni immagine restituita o salvane il contenuto Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Conserva tutti i risultati completati
Salva ogni immagine completata; recupera ogni URL restituito oppure decodificane il contenuto 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.
Se occorre verificare la risposta originale
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Alias
Alias del modello
Ailoot Ultra openai/dall-e-3, dall-e-3
Alias dei percorsi dei metodi
Usa i percorsi dei metodi indicati sopra.
ID di chiamata correlati
FAQ · OpenAI: DALL·E 3
- Quali input e risultati sono disponibili?
POST /v1/images/generations·openai/dall-e-3:text→imagePOST /v1/images/generations·dall-e-3:text→image- Quali campi usa la richiesta?
POST /v1/images/generations·openai/dall-e-3:model,prompt,stream,n,sizePOST /v1/images/generations·dall-e-3:model,prompt,stream,n,size