Recraft V3 est un modèle de génération d’images conçu pour le design graphique ainsi que 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 du 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 du texte dans l’image, notamment des textes plus longs et des caractères de taille moyenne. Recraft décrit une étape de mise en page établissant les mots et leurs positions avant la génération de l’image. La mise en page peut être produite automatiquement à partir du brief ou disposée manuellement dans l’environnement de design de Recraft. Cela aide à relier un titre, une illustration et du texte d’accompagnement dans une composition. Le fabricant documente aussi des coordonnées explicites de mise en page textuelle, 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 textuelle doivent respecter les restrictions de caractères documentées.
Pour une affiche ou une couverture, fournissez le texte exact et décrivez sa hiérarchie : la ligne dominante, sa place et la façon dont l’image la soutient. Vérifiez l’orthographe et l’espacement rendus pour sélectionner 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 raster ; Vector art est celui de la variante vectorielle. Photorealism vise une apparence photographique, tandis que Illustration accueille les textures stylisées, les ombrages et les transitions de couleurs plus complexes. Les styles vectoriels privilégient les formes, les palettes limitées et les aplats ou dégradés simples.
Des styles personnalisés peuvent être construits à partir d’images de référence, de styles existants compatibles 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 séparés ; le nombre de poids correspond aux sources. PaletteMatch et MaxWeight sont les deux politiques de mélange indiquées. Le fabricant autorise jusqu’à 10 images de référence de style et utilise le mode de correspondance de style normal pour V3. Un style personnalisé enregistré et des références directes de style 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 de fond guident la palette. Jusqu’à 10 couleurs RGB sont documentées, chaque composante allant de 0 à 255. Des poids relatifs facultatifs vont de 0 à 1 ; ils doivent être fournis pour toutes les couleurs ou pour aucune, et leur total ne peut pas 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. Une graine aléatoire est disponible pour la reproductibilité. Ces commandes offrent différents leviers pour la scène, son style et sa mise en page visuelle.
Recraft documente deux variantes V3. Le modèle raster produit du WebP sans perte ou PNG et convient au détail photographique, aux ombrages et à l’illustration texturée. Recraft V3 Vector produit du SVG : des tracés et formes pouvant changer d’échelle sans résolution fixe en pixels. Il convient aux pictogrammes, concepts de logo, badges et créations vectorielles détaillées. La conversion de raster en vecteur est une opération distincte de la génération directe de créations vectorielles.
Les deux variantes ont leur propre identité. Une image d’apparence vectorielle et une véritable sortie SVG sont des choix différents. Sélectionnez la sortie prévue pour préparer un processus de design, au lieu de traiter le nom V3 partagé comme une preuve que chaque opération renvoie le même type de fichier.
La documentation V3 de Recraft liste la génération d’image à image, la retouche de zones, l’extension d’image et le remplacement ou la génération de fond. Le travail d’image à image combine une image existante avec un nouveau brief. La retouche de zones régénère la région sélectionnée avec une image et un masque correspondant ; l’extension ajoute du contenu au-delà du cadre original. Les opérations de fond traitent l’environnement d’un sujet.
L’ensemble d’outils associé comprend aussi l’effacement, la suppression du fond, 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 raster ou vectoriel.
La spécification de génération V3 du fabricant accepte un prompt jusqu’à 1000 caractères et 1 à 6 images par requête. Elle prend en charge 14 rapports de format : 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 raster documentés comprennent 1024x1024, 1820x1024 et 1024x1820. Les dimensions raster exactes doivent provenir de la liste prise en charge ; le SVG utilise des rapports de format 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 mesurer au maximum 4096 pixels sur leur côté le plus long. Le côté le plus court est d’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 blanc purs ; les références de style ont une limite cumulée de 64 Mo.
Pour un projet utilisant l’API Ailoot, transformez la tâche en un brief d’image ciblé : le texte exact, la disposition des objets, le style visuel et la composition souhaitée. Une affiche, une scène de produit et une série d’icônes exigent des briefs différents ; préservez les distinctions pertinentes de variante et d’opération V3 pour décider 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 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 du 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 du texte dans l’image, notamment des textes plus longs et des caractères de taille moyenne. Recraft décrit une étape de mise en page établissant les mots et leurs positions avant la génération de l’image. La mise en page peut être produite automatiquement à partir du brief ou disposée manuellement dans l’environnement de design de Recraft. Cela aide à relier un titre, une illustration et du texte d’accompagnement dans une composition. Le fabricant documente aussi des coordonnées explicites de mise en page textuelle, 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 textuelle doivent respecter les restrictions de caractères documentées.\n\nPour une affiche ou une couverture, fournissez le texte exact et décrivez sa hiérarchie : la ligne dominante, sa place et la façon dont l’image la soutient. Vérifiez l’orthographe et l’espacement rendus pour sélectionner 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 raster ; Vector art est celui de la variante vectorielle. Photorealism vise une apparence photographique, tandis que Illustration accueille les textures stylisées, les ombrages et les transitions de couleurs plus complexes. Les styles vectoriels privilégient les formes, les palettes limitées et les aplats ou dégradés simples.\n\nDes styles personnalisés peuvent être construits à partir d’images de référence, de styles existants compatibles 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 séparés ; le nombre de poids correspond aux sources. PaletteMatch et MaxWeight sont les deux politiques de mélange indiquées. Le fabricant autorise jusqu’à 10 images de référence de style et utilise le mode de correspondance de style normal pour V3. Un style personnalisé enregistré et des références directes de style 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 de fond guident la palette. Jusqu’à 10 couleurs RGB sont documentées, chaque composante allant de 0 à 255. Des poids relatifs facultatifs vont de 0 à 1 ; ils doivent être fournis pour toutes les couleurs ou pour aucune, et leur total ne peut pas 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. Une graine aléatoire est disponible pour la reproductibilité. Ces commandes offrent différents leviers pour la scène, son style et sa mise en page visuelle.\n\n### Images raster et variante SVG séparée\n\nRecraft documente deux variantes V3. Le modèle raster produit du WebP sans perte ou PNG et convient au détail photographique, aux ombrages et à l’illustration texturée. Recraft V3 Vector produit du SVG : des tracés et formes pouvant changer d’échelle sans résolution fixe en pixels. Il convient aux pictogrammes, concepts de logo, badges et créations vectorielles détaillées. La conversion de raster en vecteur est une opération distincte de la génération directe de créations vectorielles.\n\nLes deux variantes ont leur propre identité. Une image d’apparence vectorielle et une véritable sortie SVG sont des choix différents. Sélectionnez la sortie prévue pour préparer un processus de design, au lieu de traiter le nom V3 partagé comme une preuve que chaque opération renvoie le même type de fichier.\n\n### Retoucher et finaliser des créations existantes\n\nLa documentation V3 de Recraft liste la génération d’image à image, la retouche de zones, l’extension d’image et le remplacement ou la génération de fond. Le travail d’image à image combine une image existante avec un nouveau brief. La retouche de zones régénère la région sélectionnée avec une image et un masque correspondant ; l’extension ajoute du contenu au-delà du cadre original. Les opérations de fond traitent l’environnement d’un sujet.\n\nL’ensemble d’outils associé comprend aussi l’effacement, la suppression du fond, 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 raster 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 1 à 6 images par requête. Elle prend en charge 14 rapports de format : 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 raster documentés comprennent 1024x1024, 1820x1024 et 1024x1820. Les dimensions raster exactes doivent provenir de la liste prise en charge ; le SVG utilise des rapports de format 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 mesurer au maximum 4096 pixels sur leur côté le plus long. Le côté le plus court est d’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 blanc purs ; les références de style ont une limite cumulée de 64 Mo.\n\nPour un projet utilisant l’API Ailoot, transformez la tâche en un brief d’image ciblé : le texte exact, la disposition des objets, le style visuel et la composition souhaitée. Une affiche, une scène de produit et une série d’icônes exigent des briefs différents ; préservez les distinctions pertinentes de variante et d’opération V3 pour décider de l’usage de chaque résultat.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "66f677114ce7fe25eed39023f84485144e344f03d2674a3db47e1107f1cd2866", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr-ch", "methods": [ { "html": "recraft/recraft-v3Recraft V3 crée des photographies, des illustrations et des mises en page graphiques avec une composition attentive au texte et des commandes de style. Ses variantes raster et SVG distinctes conviennent aux affiches, ensembles d’images de marque, icônes et designs où le texte 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 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 du 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 du texte dans l’image, notamment des textes plus longs et des caractères de taille moyenne. Recraft décrit une étape de mise en page établissant les mots et leurs positions avant la génération de l’image. La mise en page peut être produite automatiquement à partir du brief ou disposée manuellement dans l’environnement de design de Recraft. Cela aide à relier un titre, une illustration et du texte d’accompagnement dans une composition. Le fabricant documente aussi des coordonnées explicites de mise en page textuelle, 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 textuelle doivent respecter les restrictions de caractères documentées.
Pour une affiche ou une couverture, fournissez le texte exact et décrivez sa hiérarchie : la ligne dominante, sa place et la façon dont l’image la soutient. Vérifiez l’orthographe et l’espacement rendus pour sélectionner 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 raster ; Vector art est celui de la variante vectorielle. Photorealism vise une apparence photographique, tandis que Illustration accueille les textures stylisées, les ombrages et les transitions de couleurs plus complexes. Les styles vectoriels privilégient les formes, les palettes limitées et les aplats ou dégradés simples.
Des styles personnalisés peuvent être construits à partir d’images de référence, de styles existants compatibles 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 séparés ; le nombre de poids correspond aux sources. PaletteMatch et MaxWeight sont les deux politiques de mélange indiquées. Le fabricant autorise jusqu’à 10 images de référence de style et utilise le mode de correspondance de style normal pour V3. Un style personnalisé enregistré et des références directes de style 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 de fond guident la palette. Jusqu’à 10 couleurs RGB sont documentées, chaque composante allant de 0 à 255. Des poids relatifs facultatifs vont de 0 à 1 ; ils doivent être fournis pour toutes les couleurs ou pour aucune, et leur total ne peut pas 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. Une graine aléatoire est disponible pour la reproductibilité. Ces commandes offrent différents leviers pour la scène, son style et sa mise en page visuelle.
Recraft documente deux variantes V3. Le modèle raster produit du WebP sans perte ou PNG et convient au détail photographique, aux ombrages et à l’illustration texturée. Recraft V3 Vector produit du SVG : des tracés et formes pouvant changer d’échelle sans résolution fixe en pixels. Il convient aux pictogrammes, concepts de logo, badges et créations vectorielles détaillées. La conversion de raster en vecteur est une opération distincte de la génération directe de créations vectorielles.
Les deux variantes ont leur propre identité. Une image d’apparence vectorielle et une véritable sortie SVG sont des choix différents. Sélectionnez la sortie prévue pour préparer un processus de design, au lieu de traiter le nom V3 partagé comme une preuve que chaque opération renvoie le même type de fichier.
La documentation V3 de Recraft liste la génération d’image à image, la retouche de zones, l’extension d’image et le remplacement ou la génération de fond. Le travail d’image à image combine une image existante avec un nouveau brief. La retouche de zones régénère la région sélectionnée avec une image et un masque correspondant ; l’extension ajoute du contenu au-delà du cadre original. Les opérations de fond traitent l’environnement d’un sujet.
L’ensemble d’outils associé comprend aussi l’effacement, la suppression du fond, 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 raster ou vectoriel.
La spécification de génération V3 du fabricant accepte un prompt jusqu’à 1000 caractères et 1 à 6 images par requête. Elle prend en charge 14 rapports de format : 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 raster documentés comprennent 1024x1024, 1820x1024 et 1024x1820. Les dimensions raster exactes doivent provenir de la liste prise en charge ; le SVG utilise des rapports de format 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 mesurer au maximum 4096 pixels sur leur côté le plus long. Le côté le plus court est d’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 blanc purs ; les références de style ont une limite cumulée de 64 Mo.
Pour un projet utilisant l’API Ailoot, transformez la tâche en un brief d’image ciblé : le texte exact, la disposition des objets, le style visuel et la composition souhaitée. Une affiche, une scène de produit et une série d’icônes exigent des briefs différents ; préservez les distinctions pertinentes de variante et d’opération V3 pour décider 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 image réelles du client ; elles sont régies par les conditions du point de terminaison du fournisseur. |
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 résultat réel et les identifiants d’origine renvoyé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 · 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 |
| 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 estimé de la génération | 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 en sortie | Conditions de facturationAucune variante tarifaire n’est déclarée. | Coût Sortie · Image en sortie $0.08 par image Les mentions équivalentes décrivent le même montant facturé ; elles n’ajoutent pas de frais supplémentaires. |
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 la consommation complète ; prenez possession de toutes les images effectivement renvoyées et enregistrez-les. Aucun lien ni 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