Source: https://ailoot.ai/models/fr-ca/recraft-recraft-v3/ Canonical: https://ailoot.ai/models/fr-ca/recraft-recraft-v3/ Language: fr-ca # Recraft: Recraft V3 [Markdown](https://ailoot.ai/models/fr-ca/recraft-recraft-v3/index.md) · [JSON](https://ailoot.ai/models/fr-ca/recraft-recraft-v3/facts.json) ## [Recraft: Recraft V3](https://ailoot.ai/models/fr-ca/recraft-recraft-v3/) Recraft 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. - [**Ailoot Ultra · Images** `POST /v1/images/generations` `recraft/recraft-v3`](https://ailoot.ai/models/fr-ca/recraft-recraft-v3/#method-0) À 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. 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. #### Le texte comme partie de la composition 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. #### Style, palette et direction artistique 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. #### Images matricielles et variante SVG distincte 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. #### Monter et terminer une création existante 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. #### Limites de prompt, de taille et d’image source 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. **Ailoot Ultra · Images** `POST /v1/images/generations` `recraft/recraft-v3` [`recraft/recraft-v3`](https://ailoot.ai/models/fr-ca/#m=recraft%2Frecraft-v3&route=Ultra&caller=recraft%2Frecraft-v3&fmt=images) Recraft /`recraft/recraft-v3` ### Pour commencer Recraft 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. Entrées acceptées Texte · Images Résultats Images ### Disponible dans Ailoot · entrées et méthodes **Ailoot Ultra · Images** `POST /v1/images/generations` Entrée `text`, `image` Sortie `image` Format de sortie Fichier image | Champ | Type | Exigence | Valeurs et limites | Par défaut | | --- | --- | --- | --- | --- | | Champ`model` | Type`string` | ExigenceObligatoire | Valeurs et limites recraft/recraft-v3 | Par défaut— | | Champ`prompt` | Type`string` | ExigenceObligatoire | Valeurs et limites Longueur minimale: 1 | Par défaut— | | Champ`n` | Type`integer` | ExigenceFacultatif | Valeurs et limites Minimum: 1 Maximum: 6 | Par défaut— | | Champ`aspect_ratio` | Type`string` | ExigenceFacultatif | Valeurs et limites 1:1, 4:3, 3:4, 16:9, 9:16, auto | Par défaut— | | Champ`input_references` | Type`array` | ExigenceFacultatif | Valeurs et limites Nombre minimal d’éléments: 0 Nombre maximal d’éléments: 1 | Par défaut— | Combinaisons d’éléments d’entrée **Texte vers image** · Obligatoire : prompt Paramètres et cycle de vie de la méthode | Paramètre | Contrat | | --- | --- | | Paramètre`content_type` | Contratapplication/json | | Paramètre`required` | Contratmodel, prompt | | Paramètre`material_types` | Contrattext, image | | Paramètre`optional_controls` | Contrataspect\_ratio, n, input\_references | | Paramètre`exact_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ètre`reference_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. ### 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 | 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 →](https://ailoot.ai/docs/fr-ca/billing/reserve/) #### Détails du tarif de référence 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. Configurations tarifaires des images #### Prix par configuration | 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. | ### Exemples de requêtes #### Ailoot Ultra · Images curlPython SDKNode.js SDK ```bash 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={'model': 'recraft/recraft-v3', 'prompt': 'a red panda astronaut floating in space, studio lighting'} 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 python3 - <<'PY_RESULT' import base64, json, os, subprocess from pathlib import Path from urllib.parse import urlsplit, urljoin def save_images(items): if not items: raise SystemExit("No completed images; retain the full response") for index, item in enumerate(items): encoded=item.get("b64_json") uri=item.get("url", "") if not encoded and uri.startswith("data:image/"): header, separator, encoded=uri.partition(",") if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI") if encoded: raw=base64.b64decode(encoded,validate=True) elif uri: uri=urljoin("https://api.ailoot.ai",uri) parsed=urlsplit(uri) if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password: raise SystemExit("Invalid returned image URL") owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content") args=["curl","--fail-with-body","--silent","--show-error",uri] if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]] temporary=Path(f"image-{index}.bin") subprocess.run(args+["-o",str(temporary)],check=True) raw=temporary.read_bytes() temporary.unlink() else: raise SystemExit("Image has neither bytes nor URL") if not raw: raise SystemExit("Empty image result") 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"