OpenAI: DALL·E 3
DALL·E 3 génère des images à partir d’un brief de scène écrit. Utilisez l’ID exact openai/dall-e-3 ou son alias dall-e-3 avec la méthode de génération d’images, puis enregistrez chaque URL d’image renvoyée et le résultat qui l’accompagne. Une requête de départ documentée produit une image 1024x1024 à partir de texte.
- Ailoot Ultra · Images
POST /v1/images/generationsopenai/dall-e-3 - Ailoot Ultra · Images
POST /v1/images/generationsdall-e-3
À propos du modèle
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
DALL·E 3 est le modèle de génération d’images à partir de texte d’OpenAI. Utilisez un brief écrit pour créer une illustration, un concept de scène ou une direction visuelle pour un design. Décrivez le sujet, l’environnement, la composition, l’éclairage et le traitement dans le prompt. Par exemple, un brief de concept peut demander un vélo de livraison à côté d’une petite boutique au crépuscule, vu depuis la rue, avec un sujet de premier plan clair et une palette de couleurs sobre.
Envoyez POST /v1/images/generations avec un corps application/json. L’ID public exact du modèle est openai/dall-e-3 ; l’alias admis dall-e-3 sélectionne la même fiche de modèle. La structure de départ documentée fournit model, prompt, n:1 et size:"1024x1024". n est un entier facultatif qui vaut 1 par défaut. Envoyez stream:false, ou omettez stream, pour obtenir le résultat JSON complet. Utilisez un prompt textuel non vide et gardez cette requête centrée sur un seul brief d’image complet. La méthode proposée est la génération d’images à partir de texte.
Formulez explicitement les exigences qui comptent pour l’emplacement. Une illustration éditoriale peut nommer l’idée centrale et les objets qui l’expriment. Un concept de scène peut préciser la position de la caméra, le moment de la journée et les parties de la composition qui doivent disposer d’espace autour d’elles. Gardez le texte exact qui doit apparaître dans l’image distinct des descriptions de la scène, puis examinez les inscriptions rendues et la disposition visuelle avant d’utiliser le résultat sélectionné.
La réponse de génération est du JSON avec un horodatage created et un tableau data. L’élément de résultat documenté comprend url et peut inclure revised_prompt, prompt_filter_results et content_filter_results. Conservez ces champs avec la réponse complète et téléchargez l’image à chaque URL Ailoot signée renvoyée. Les liens de fichiers signés Ailoot durent 24 heures à compter de leur émission. Gardez l’URL renvoyée exacte, y compris sa chaîne de requête, jusqu’à l’enregistrement du fichier ; déterminez le format de l’image enregistrée à partir de la réponse réelle ou des octets du fichier.
Traitez le fichier image renvoyé comme la ressource de design utilisable et le JSON comme son enregistrement de génération associé. Examinez l’image par rapport au brief fourni avant de l’intégrer à une page, une présentation ou une application. Si la réponse est incomplète ou si l’issue de l’envoi est incertaine, conservez l’identifiant de requête d’origine et les informations renvoyées pendant la vérification de la tentative existante au lieu de créer une autre image uniquement pour récupérer le résultat manquant. Pour récupérer les résultats enregistrés, utilisez la même clé API pour appeler GET /v1/media/assets?family=image et suivez chaque next_cursor. L’ID de la ressource apparaît dans chaque URL /v1/media/assets/{asset_id}/content renvoyée et dans son enregistrement de médiathèque. Appelez GET /v1/media/assets/{asset_id} pour chaque enregistrement sélectionné et téléchargez son content_url exact. Si la requête de fichier renvoie 404 avec le code link_expired, relisez cette même ressource pour obtenir un lien actualisé. L’actualisation d’un lien de ressource ne nécessite pas de nouvelle requête de génération d’image.
Ailoot Ultra · Images POST /v1/images/generations openai/dall-e-3
openai/dall-e-3openai/dall-e-3dall-e-3
Premiers pas
DALL·E 3 génère des images à partir d’un brief de scène écrit. Utilisez l’ID exact openai/dall-e-3 ou son alias dall-e-3 avec la méthode de génération d’images, puis enregistrez chaque URL d’image renvoyée et le résultat qui l’accompagne. Une requête de départ documentée produit une image 1024x1024 à partir de texte.
- Entrées acceptées
- Texte
- Résultats
- Images
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · Images POST /v1/images/generations
- Entrée
text- Sortie
image- Format de sortie
- Fichier image
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites openai/dall-e-3 | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champstream | Typeboolean | ExigenceFacultatif | Valeurs et limites false | Par défautfalse |
Champn | Typeinteger | ExigenceFacultatif | Valeurs et limites 1 | Par défaut— |
Champsize | Typestring | ExigenceFacultatif | Valeurs et limites 1024x1024 | Par défaut— |
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, prompt |
Paramètreoptional | Contratstream, n, size |
Paramètrematerial_types | Contrattext |
Paramètreconditions | ContratUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Cycle de vie : synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarifs
Calcul du coût final
Les tarifs affichés servent à estimer le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée mesurée du résultat et les quantités prévisionnelles ne constituent pas la quantité finale facturable.
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
- Mode rapide
- Non précisé Lorsque le mode rapide est sélectionné
- Mode Flex
- Non précisé Lorsque le mode flex est sélectionné
- Effort de raisonnement maximal
- Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)
Tarifs estimés à des fins de comparaison
Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Quantité prévisionnelle | Coût |
|---|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Quantité prévisionnelle— | Coût Entrée · Tokens en entrée · Estimation à des fins de comparaison uniquement — / 1K tokens Sortie · Tokens en sortie · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement — / 1K tokens |
| ConfigurationEstimated generation cost | Barème tarifaire— | Quantité prévisionnelleEstimation pour une génération | Coût Entrée · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.32768 estimation avant génération This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
Exemples de requêtes
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.
Recevoir et enregistrer les résultats
Ailoot Ultra · Images
Téléchargez chaque image renvoyée ou enregistrez son contenu Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Conserver tous les résultats terminés
Enregistrez chaque image terminée ; récupérez chaque URL renvoyée ou décodez son contenu 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.
Si la réponse d’origine doit être vérifiée
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Alias
Alias du modèle
Ailoot Ultra openai/dall-e-3, dall-e-3
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
Ailoot Ultra · Images POST /v1/images/generations dall-e-3
dall-e-3openai/dall-e-3dall-e-3
Premiers pas
DALL·E 3 génère des images à partir d’un brief de scène écrit. Utilisez l’ID exact openai/dall-e-3 ou son alias dall-e-3 avec la méthode de génération d’images, puis enregistrez chaque URL d’image renvoyée et le résultat qui l’accompagne. Une requête de départ documentée produit une image 1024x1024 à partir de texte.
- Entrées acceptées
- Texte
- Résultats
- Images
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · Images POST /v1/images/generations
- Entrée
text- Sortie
image- Format de sortie
- Fichier image
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites dall-e-3 | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champstream | Typeboolean | ExigenceFacultatif | Valeurs et limites false | Par défautfalse |
Champn | Typeinteger | ExigenceFacultatif | Valeurs et limites 1 | Par défaut— |
Champsize | Typestring | ExigenceFacultatif | Valeurs et limites 1024x1024 | Par défaut— |
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, prompt |
Paramètreoptional | Contratstream, n, size |
Paramètrematerial_types | Contrattext |
Paramètreconditions | ContratUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Cycle de vie : synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarifs
Calcul du coût final
Les tarifs affichés servent à estimer le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée mesurée du résultat et les quantités prévisionnelles ne constituent pas la quantité finale facturable.
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
- Mode rapide
- Non précisé Lorsque le mode rapide est sélectionné
- Mode Flex
- Non précisé Lorsque le mode flex est sélectionné
- Effort de raisonnement maximal
- Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)
Tarifs estimés à des fins de comparaison
Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Quantité prévisionnelle | Coût |
|---|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Quantité prévisionnelle— | Coût Entrée · Tokens en entrée · Estimation à des fins de comparaison uniquement — / 1K tokens Sortie · Tokens en sortie · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement — / 1K tokens |
| ConfigurationEstimated generation cost | Barème tarifaire— | Quantité prévisionnelleEstimation pour une génération | Coût Entrée · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.32768 estimation avant génération This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
Exemples de requêtes
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.
Recevoir et enregistrer les résultats
Ailoot Ultra · Images
Téléchargez chaque image renvoyée ou enregistrez son contenu Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Conserver tous les résultats terminés
Enregistrez chaque image terminée ; récupérez chaque URL renvoyée ou décodez son contenu 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.
Si la réponse d’origine doit être vérifiée
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Alias
Alias du modèle
Ailoot Ultra openai/dall-e-3, dall-e-3
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · OpenAI: DALL·E 3
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/images/generations·openai/dall-e-3:text→imagePOST /v1/images/generations·dall-e-3:text→image- Quels champs la requête utilise-t-elle ?
POST /v1/images/generations·openai/dall-e-3:model,prompt,stream,n,sizePOST /v1/images/generations·dall-e-3:model,prompt,stream,n,size