Recraft V3 est un modèle de génération d’images conçu pour le design graphique ainsi que pour les scènes photographiques et illustrées. Un brief écrit décrit le sujet, le décor et la composition; le résultat est une image. V3 développe le rendu de texte et le photoréalisme de Recraft tout en conservant la cohérence de style à partir d’images d’exemple sans réentraînement.
V3 travaille avec le texte dans l’image, y compris les textes plus longs et les caractères de taille moyenne. Recraft décrit une étape de mise en page qui établit les mots et leurs positions avant la génération d’image. La mise en page peut être produite automatiquement à partir du brief ou organisée manuellement dans l’environnement de design de Recraft. Cela aide à relier un titre, une illustration et un texte complémentaire dans une composition. Le fabricant documente aussi des coordonnées explicites de mise en page du texte, exprimées relativement à l’image plutôt que dans une grille fixe de pixels. Chaque élément textuel contient un seul mot et quatre points de coin en coordonnées normalisées : (0, 0) est le coin supérieur gauche et (1, 1) le coin inférieur droit. Les coordonnées peuvent dépasser cette plage, auquel cas la forme est recadrée. Les mots explicites de mise en page doivent respecter les restrictions de caractères documentées.
Pour une affiche ou une couverture, fournissez les mots exacts et décrivez leur hiérarchie : quelle ligne mène, où elle se trouve et comment l’image la soutient. Vérifiez l’orthographe et l’espacement rendus lorsque vous sélectionnez un résultat.
V3 comprend des styles prédéfinis de photographie, d’illustration et d’emblème, ainsi qu’une bibliothèque distincte de styles vectoriels. Recraft V3 Raw est le style par défaut du modèle matriciel; Vector art est celui de la variante vectorielle. Le photoréalisme vise une apparence photographique, tandis que l’illustration permet les textures stylisées, l’ombrage et les transitions de couleurs plus complexes. Les styles vectoriels favorisent les formes, les palettes limitées et les aplats ou dégradés simples.
Les styles personnalisés peuvent être construits à partir d’images de référence, de styles compatibles existants ou d’une combinaison. Ils fournissent une direction visuelle réutilisable dans une série d’images. Les commandes de mélange documentées permettent aux références et aux styles sources de porter des poids distincts; le nombre de poids correspond au nombre de sources. PaletteMatch et MaxWeight sont les deux politiques de mélange indiquées. Le fabricant permet jusqu’à 10 images de référence de style et utilise le mode de correspondance de style standard pour V3. Un style personnalisé stocké et les références de style directes sont des entrées alternatives, et un style personnalisé doit correspondre au modèle utilisé pour la génération.
Les couleurs préférées et une couleur d’arrière-plan guident la palette. Jusqu’à 10 couleurs RGB sont documentées, avec chaque composante de 0 à 255. Les poids relatifs facultatifs vont de 0 à 1; ils doivent être fournis pour chaque couleur ou pour aucune, et leur total ne peut dépasser 1. Le niveau artistique va de 0 pour un traitement statique et épuré à 5 pour des compositions plus dynamiques et excentriques. Un prompt négatif décrit les éléments indésirables; une commande distincte sans texte désactive les mises en page textuelles intégrées. Un seed aléatoire est disponible pour la reproductibilité. Ces commandes donnent différents leviers pour la scène, son style et sa mise en page visuelle.
Recraft documente deux variantes V3. Le modèle matriciel produit du WebP sans perte ou du PNG et convient aux détails photographiques, à l’ombrage et à l’illustration texturée. Recraft V3 Vector produit du SVG : des tracés et formes qui peuvent changer d’échelle sans résolution fixe en pixels. Il convient aux pictogrammes, aux concepts de logos, aux insignes et aux créations vectorielles détaillées. La conversion de matriciel en vectoriel est une opération distincte de la génération directe d’une création vectorielle.
Les deux variantes ont leur propre identité. Une image d’apparence vectorielle et une véritable sortie SVG constituent des choix différents. Choisissez la sortie prévue lorsque vous préparez un processus de design, au lieu de traiter le nom V3 partagé comme la preuve que chaque opération renvoie le même type de fichier.
La documentation V3 de Recraft indique la génération d’image en image, la retouche localisée, l’extension de l’image et le remplacement ou la génération d’arrière-plan. Le travail d’image en image combine une image existante à un nouveau brief. La retouche localisée régénère la zone sélectionnée au moyen d’une image et d’un masque correspondant; l’extension ajoute du contenu au-delà du cadre original. Les opérations d’arrière-plan traitent l’environnement d’un sujet.
L’ensemble d’outils comprend aussi l’effacement, le retrait d’arrière-plan, la vectorisation et deux approches d’agrandissement. L’agrandissement créatif peut introduire de nouveaux détails; l’agrandissement net vise une version plus grande et plus précise du contenu existant. Ce sont des opérations distinctes avec leurs propres entrées et résultats, plutôt que des sens supplémentaires du nom de modèle matriciel ou vectoriel.
La spécification de génération V3 du fabricant accepte un prompt jusqu’à 1000 caractères et de 1 à 6 images par requête. Elle prend en charge 14 ratios : 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9 et 9:16. Les exemples matriciels documentés comprennent 1024x1024, 1820x1024 et 1024x1820. Les dimensions matricielles exactes doivent provenir de la liste prise en charge; le SVG utilise les ratios sans taille fixe en pixels. Lorsque la taille est omise, le système du fabricant la choisit à partir du prompt.
Pour les opérations avec image d’entrée, le fabricant indique PNG, JPG et WebP, avec SVG lorsque l’opération particulière l’autorise. Les fichiers doivent faire moins de 20 Mo, ne pas dépasser 16 MP et avoir un côté long d’au plus 4096 pixels. Le côté court mesure au moins 256 pixels, avec une exception de 32 pixels pour l’agrandissement net. Les masques correspondent à la taille de l’image et utilisent du noir et du blanc purs; les références de style ont une limite combinée de 64 Mo.
Pour un projet d’API Ailoot, transformez la tâche en un brief d’image ciblé : les mots exacts, l’agencement des objets, le style visuel et la composition voulue. Une affiche, une scène de produit et une série d’icônes nécessitent des briefs différents; préservez les distinctions pertinentes de variante V3 et d’opération lorsque vous décidez de l’usage de chaque résultat.
", "aboutText": "Recraft V3 est un modèle de génération d’images conçu pour le design graphique ainsi que pour les scènes photographiques et illustrées. Un brief écrit décrit le sujet, le décor et la composition; le résultat est une image. V3 développe le rendu de texte et le photoréalisme de Recraft tout en conservant la cohérence de style à partir d’images d’exemple sans réentraînement.\n\n### Le texte comme partie de la composition\n\nV3 travaille avec le texte dans l’image, y compris les textes plus longs et les caractères de taille moyenne. Recraft décrit une étape de mise en page qui établit les mots et leurs positions avant la génération d’image. La mise en page peut être produite automatiquement à partir du brief ou organisée manuellement dans l’environnement de design de Recraft. Cela aide à relier un titre, une illustration et un texte complémentaire dans une composition. Le fabricant documente aussi des coordonnées explicites de mise en page du texte, exprimées relativement à l’image plutôt que dans une grille fixe de pixels. Chaque élément textuel contient un seul mot et quatre points de coin en coordonnées normalisées : (0, 0) est le coin supérieur gauche et (1, 1) le coin inférieur droit. Les coordonnées peuvent dépasser cette plage, auquel cas la forme est recadrée. Les mots explicites de mise en page doivent respecter les restrictions de caractères documentées.\n\nPour une affiche ou une couverture, fournissez les mots exacts et décrivez leur hiérarchie : quelle ligne mène, où elle se trouve et comment l’image la soutient. Vérifiez l’orthographe et l’espacement rendus lorsque vous sélectionnez un résultat.\n\n### Style, palette et direction artistique\n\nV3 comprend des styles prédéfinis de photographie, d’illustration et d’emblème, ainsi qu’une bibliothèque distincte de styles vectoriels. Recraft V3 Raw est le style par défaut du modèle matriciel; Vector art est celui de la variante vectorielle. Le photoréalisme vise une apparence photographique, tandis que l’illustration permet les textures stylisées, l’ombrage et les transitions de couleurs plus complexes. Les styles vectoriels favorisent les formes, les palettes limitées et les aplats ou dégradés simples.\n\nLes styles personnalisés peuvent être construits à partir d’images de référence, de styles compatibles existants ou d’une combinaison. Ils fournissent une direction visuelle réutilisable dans une série d’images. Les commandes de mélange documentées permettent aux références et aux styles sources de porter des poids distincts; le nombre de poids correspond au nombre de sources. PaletteMatch et MaxWeight sont les deux politiques de mélange indiquées. Le fabricant permet jusqu’à 10 images de référence de style et utilise le mode de correspondance de style standard pour V3. Un style personnalisé stocké et les références de style directes sont des entrées alternatives, et un style personnalisé doit correspondre au modèle utilisé pour la génération.\n\nLes couleurs préférées et une couleur d’arrière-plan guident la palette. Jusqu’à 10 couleurs RGB sont documentées, avec chaque composante de 0 à 255. Les poids relatifs facultatifs vont de 0 à 1; ils doivent être fournis pour chaque couleur ou pour aucune, et leur total ne peut dépasser 1. Le niveau artistique va de 0 pour un traitement statique et épuré à 5 pour des compositions plus dynamiques et excentriques. Un prompt négatif décrit les éléments indésirables; une commande distincte sans texte désactive les mises en page textuelles intégrées. Un seed aléatoire est disponible pour la reproductibilité. Ces commandes donnent différents leviers pour la scène, son style et sa mise en page visuelle.\n\n### Images matricielles et variante SVG distincte\n\nRecraft documente deux variantes V3. Le modèle matriciel produit du WebP sans perte ou du PNG et convient aux détails photographiques, à l’ombrage et à l’illustration texturée. Recraft V3 Vector produit du SVG : des tracés et formes qui peuvent changer d’échelle sans résolution fixe en pixels. Il convient aux pictogrammes, aux concepts de logos, aux insignes et aux créations vectorielles détaillées. La conversion de matriciel en vectoriel est une opération distincte de la génération directe d’une création vectorielle.\n\nLes deux variantes ont leur propre identité. Une image d’apparence vectorielle et une véritable sortie SVG constituent des choix différents. Choisissez la sortie prévue lorsque vous préparez un processus de design, au lieu de traiter le nom V3 partagé comme la preuve que chaque opération renvoie le même type de fichier.\n\n### Monter et terminer une création existante\n\nLa documentation V3 de Recraft indique la génération d’image en image, la retouche localisée, l’extension de l’image et le remplacement ou la génération d’arrière-plan. Le travail d’image en image combine une image existante à un nouveau brief. La retouche localisée régénère la zone sélectionnée au moyen d’une image et d’un masque correspondant; l’extension ajoute du contenu au-delà du cadre original. Les opérations d’arrière-plan traitent l’environnement d’un sujet.\n\nL’ensemble d’outils comprend aussi l’effacement, le retrait d’arrière-plan, la vectorisation et deux approches d’agrandissement. L’agrandissement créatif peut introduire de nouveaux détails; l’agrandissement net vise une version plus grande et plus précise du contenu existant. Ce sont des opérations distinctes avec leurs propres entrées et résultats, plutôt que des sens supplémentaires du nom de modèle matriciel ou vectoriel.\n\n### Limites de prompt, de taille et d’image source\n\nLa spécification de génération V3 du fabricant accepte un prompt jusqu’à 1000 caractères et de 1 à 6 images par requête. Elle prend en charge 14 ratios : 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9 et 9:16. Les exemples matriciels documentés comprennent 1024x1024, 1820x1024 et 1024x1820. Les dimensions matricielles exactes doivent provenir de la liste prise en charge; le SVG utilise les ratios sans taille fixe en pixels. Lorsque la taille est omise, le système du fabricant la choisit à partir du prompt.\n\nPour les opérations avec image d’entrée, le fabricant indique PNG, JPG et WebP, avec SVG lorsque l’opération particulière l’autorise. Les fichiers doivent faire moins de 20 Mo, ne pas dépasser 16 MP et avoir un côté long d’au plus 4096 pixels. Le côté court mesure au moins 256 pixels, avec une exception de 32 pixels pour l’agrandissement net. Les masques correspondent à la taille de l’image et utilisent du noir et du blanc purs; les références de style ont une limite combinée de 64 Mo.\n\nPour un projet d’API Ailoot, transformez la tâche en un brief d’image ciblé : les mots exacts, l’agencement des objets, le style visuel et la composition voulue. Une affiche, une scène de produit et une série d’icônes nécessitent des briefs différents; préservez les distinctions pertinentes de variante V3 et d’opération lorsque vous décidez de l’usage de chaque résultat.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "a6f18f3664b7075940bd1e2fd78d3b5ef0eafafe539c98da9a4c63568b4a8a37", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr-ca", "methods": [ { "html": "recraft/recraft-v3Recraft V3 crée des photographies, des illustrations et des mises en page graphiques avec une composition tenant compte du texte et des commandes de style. Ses variantes matricielle et SVG distinctes conviennent aux affiches, aux ensembles d’images de marque, aux icônes et aux designs où les mots et la structure visuelle doivent fonctionner ensemble.
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.
Recraft V3 est un modèle de génération d’images conçu pour le design graphique ainsi que pour les scènes photographiques et illustrées. Un brief écrit décrit le sujet, le décor et la composition; le résultat est une image. V3 développe le rendu de texte et le photoréalisme de Recraft tout en conservant la cohérence de style à partir d’images d’exemple sans réentraînement.
V3 travaille avec le texte dans l’image, y compris les textes plus longs et les caractères de taille moyenne. Recraft décrit une étape de mise en page qui établit les mots et leurs positions avant la génération d’image. La mise en page peut être produite automatiquement à partir du brief ou organisée manuellement dans l’environnement de design de Recraft. Cela aide à relier un titre, une illustration et un texte complémentaire dans une composition. Le fabricant documente aussi des coordonnées explicites de mise en page du texte, exprimées relativement à l’image plutôt que dans une grille fixe de pixels. Chaque élément textuel contient un seul mot et quatre points de coin en coordonnées normalisées : (0, 0) est le coin supérieur gauche et (1, 1) le coin inférieur droit. Les coordonnées peuvent dépasser cette plage, auquel cas la forme est recadrée. Les mots explicites de mise en page doivent respecter les restrictions de caractères documentées.
Pour une affiche ou une couverture, fournissez les mots exacts et décrivez leur hiérarchie : quelle ligne mène, où elle se trouve et comment l’image la soutient. Vérifiez l’orthographe et l’espacement rendus lorsque vous sélectionnez un résultat.
V3 comprend des styles prédéfinis de photographie, d’illustration et d’emblème, ainsi qu’une bibliothèque distincte de styles vectoriels. Recraft V3 Raw est le style par défaut du modèle matriciel; Vector art est celui de la variante vectorielle. Le photoréalisme vise une apparence photographique, tandis que l’illustration permet les textures stylisées, l’ombrage et les transitions de couleurs plus complexes. Les styles vectoriels favorisent les formes, les palettes limitées et les aplats ou dégradés simples.
Les styles personnalisés peuvent être construits à partir d’images de référence, de styles compatibles existants ou d’une combinaison. Ils fournissent une direction visuelle réutilisable dans une série d’images. Les commandes de mélange documentées permettent aux références et aux styles sources de porter des poids distincts; le nombre de poids correspond au nombre de sources. PaletteMatch et MaxWeight sont les deux politiques de mélange indiquées. Le fabricant permet jusqu’à 10 images de référence de style et utilise le mode de correspondance de style standard pour V3. Un style personnalisé stocké et les références de style directes sont des entrées alternatives, et un style personnalisé doit correspondre au modèle utilisé pour la génération.
Les couleurs préférées et une couleur d’arrière-plan guident la palette. Jusqu’à 10 couleurs RGB sont documentées, avec chaque composante de 0 à 255. Les poids relatifs facultatifs vont de 0 à 1; ils doivent être fournis pour chaque couleur ou pour aucune, et leur total ne peut dépasser 1. Le niveau artistique va de 0 pour un traitement statique et épuré à 5 pour des compositions plus dynamiques et excentriques. Un prompt négatif décrit les éléments indésirables; une commande distincte sans texte désactive les mises en page textuelles intégrées. Un seed aléatoire est disponible pour la reproductibilité. Ces commandes donnent différents leviers pour la scène, son style et sa mise en page visuelle.
Recraft documente deux variantes V3. Le modèle matriciel produit du WebP sans perte ou du PNG et convient aux détails photographiques, à l’ombrage et à l’illustration texturée. Recraft V3 Vector produit du SVG : des tracés et formes qui peuvent changer d’échelle sans résolution fixe en pixels. Il convient aux pictogrammes, aux concepts de logos, aux insignes et aux créations vectorielles détaillées. La conversion de matriciel en vectoriel est une opération distincte de la génération directe d’une création vectorielle.
Les deux variantes ont leur propre identité. Une image d’apparence vectorielle et une véritable sortie SVG constituent des choix différents. Choisissez la sortie prévue lorsque vous préparez un processus de design, au lieu de traiter le nom V3 partagé comme la preuve que chaque opération renvoie le même type de fichier.
La documentation V3 de Recraft indique la génération d’image en image, la retouche localisée, l’extension de l’image et le remplacement ou la génération d’arrière-plan. Le travail d’image en image combine une image existante à un nouveau brief. La retouche localisée régénère la zone sélectionnée au moyen d’une image et d’un masque correspondant; l’extension ajoute du contenu au-delà du cadre original. Les opérations d’arrière-plan traitent l’environnement d’un sujet.
L’ensemble d’outils comprend aussi l’effacement, le retrait d’arrière-plan, la vectorisation et deux approches d’agrandissement. L’agrandissement créatif peut introduire de nouveaux détails; l’agrandissement net vise une version plus grande et plus précise du contenu existant. Ce sont des opérations distinctes avec leurs propres entrées et résultats, plutôt que des sens supplémentaires du nom de modèle matriciel ou vectoriel.
La spécification de génération V3 du fabricant accepte un prompt jusqu’à 1000 caractères et de 1 à 6 images par requête. Elle prend en charge 14 ratios : 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9 et 9:16. Les exemples matriciels documentés comprennent 1024x1024, 1820x1024 et 1024x1820. Les dimensions matricielles exactes doivent provenir de la liste prise en charge; le SVG utilise les ratios sans taille fixe en pixels. Lorsque la taille est omise, le système du fabricant la choisit à partir du prompt.
Pour les opérations avec image d’entrée, le fabricant indique PNG, JPG et WebP, avec SVG lorsque l’opération particulière l’autorise. Les fichiers doivent faire moins de 20 Mo, ne pas dépasser 16 MP et avoir un côté long d’au plus 4096 pixels. Le côté court mesure au moins 256 pixels, avec une exception de 32 pixels pour l’agrandissement net. Les masques correspondent à la taille de l’image et utilisent du noir et du blanc purs; les références de style ont une limite combinée de 64 Mo.
Pour un projet d’API Ailoot, transformez la tâche en un brief d’image ciblé : les mots exacts, l’agencement des objets, le style visuel et la composition voulue. Une affiche, une scène de produit et une série d’icônes nécessitent des briefs différents; préservez les distinctions pertinentes de variante V3 et d’opération lorsque vous décidez de l’usage de chaque résultat.
POST /v1/images/generationstext, imageimage| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites recraft/recraft-v3 | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Longueur minimale: 1 | Par défaut— |
Champn | Typeinteger | ExigenceFacultatif | Valeurs et limites Minimum: 1 Maximum: 6 | Par défaut— |
Champaspect_ratio | Typestring | ExigenceFacultatif | Valeurs et limites 1:1, 4:3, 3:4, 16:9, 9:16, auto | Par défaut— |
Champinput_references | Typearray | ExigenceFacultatif | Valeurs et limites Nombre minimal d’éléments: 0 Nombre maximal d’éléments: 1 | Par défaut— |
Texte vers image · Obligatoire : prompt
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, prompt |
Paramètrematerial_types | Contrattext, image |
Paramètreoptional_controls | Contrataspect_ratio, n, input_references |
Paramètreexact_supported_parameters | Contrat{"aspect_ratio":{"type":"enum","values":["1:1","4:3","3:4","16:9","9:16","auto"]},"n":{"type":"range","min":1,"max":6},"input_references":{"type":"range","min":0,"max":1}} |
Paramètrereference_material_rule | ContratUniquement les références d’image réelles du client; les conditions du point de terminaison du fournisseur s’y appliquent. |
Alias de méthode : /v1/images
Cycle de vie : synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id effectivement renvoyé ou enregistrement de la bibliothèque multimédia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Utilisez le modèle exact et les champs d’entrée documentés.
Conservez la réponse complète, chaque sortie réelle et les identifiants d’origine retournés.
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.
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 | Unité de facturation | Coût |
|---|---|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Quantité prévisionnelle— | Unité de facturation— | Coût Entrée · Jetons en entrée · Estimation à des fins de comparaison uniquement — / 1K jetons Sortie · Jetons en sortie · Estimation à des fins de comparaison uniquement — / 1K jetons Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement — / 1K jetons Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement — / 1K jetons Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement — / 1K jetons |
| ConfigurationUltra | Barème tarifaire— | Quantité prévisionnelle— | Unité de facturationpar image en sortie | Coût Sortie · image en sortie · Estimation à des fins de comparaison uniquement $0.08 par image en sortie |
| ConfigurationCoût de génération estimé | Barème tarifaire— | Quantité prévisionnelleestimation pour une génération | Unité de facturation— | Coût Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.08 estimation avant génération Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée. |
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 →
Les barèmes de référence du modèle ne modifient ni la sélection de méthode, ni les devis, ni les coûts. Les frais actifs utilisent les tarifs de la méthode Ailoot sélectionnée.
| Configuration | Conditions de facturation | Coût |
|---|---|---|
| ConfigurationImage de sortie | Conditions de facturationAucune variante tarifaire n’est déclarée. | Coût Sortie · Image de sortie $0.08 par image Les lignes équivalentes décrivent la même facturation; elles n’ajoutent pas une deuxième facturation. |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'recraft/recraft-v3', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nfrom openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\n\nrequest={'model': 'recraft/recraft-v3', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "recraft/recraft-v3", "prompt": "a red panda astronaut floating in space, studio lighting"};\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\nTéléchargez chaque image renvoyée ou enregistrez son contenu Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Enregistrez chaque image terminée ; récupérez chaque URL renvoyée ou décodez son contenu Base64.
Conservez chaque élément de données et l’utilisation complète; prenez possession de toutes les images réellement retournées et enregistrez-les. Aucune URL ni aucun identifiant inventé.
Si le résultat d’une génération ou d’une retouche d’image nécessite une vérification, conservez l’operation_id/X-Client-Request-ID d’origine et les informations renvoyées sur le résultat. Récupérez les résultats existants qui vous appartiennent via la bibliothèque multimédia, à l’aide des valeurs task_id ou asset_id réelles. Ne soumettez pas à nouveau la requête de génération/retouche et ne construisez pas d’URL d’interrogation du statut à partir d’operation_id.
| Champ | Type |
|---|---|
Champcreated | Typeinteger |
Champdata[].url | Typestring |
Champdata[].b64_json | Typebase64 string |
Champusage | Typeobject |
Ailoot Ultra recraft/recraft-v3
/v1/images