{ "aboutHtml": "

Recraft V4 Pro Vector est le modèle SVG Pro de la génération V4 de Recraft. La famille se concentre sur le jugement visuel, les relations chromatiques cohérentes, la composition et l’interprétation détaillée des consignes créatives. La branche Pro vise des détails plus fins et des compositions plus exigeantes, tandis que cette édition Vector produit des créations SVG modifiables. Elle convient à une illustration graphique, un emblème ou un concept de lettrage nécessitant un fichier de travail vectoriel pour des ajustements de design ultérieurs.

Le code exact du modèle est recraftv4_pro_vector. Il se distingue du V4 Vector standard, du modèle matriciel V4 Pro et de la famille ultérieure V4.1. La référence de dimensions du producteur indique que tous les modèles vectoriels acceptent quatorze formats largeur/hauteur et que la sortie SVG n’a pas de taille fixe en pixels. Les dimensions matricielles 2048 × 2048 de V4 Pro ne constituent donc pas une limite de résolution en pixels de cette édition. Choisissez la composition et la forme souhaitées du visuel plutôt qu’une étiquette de taille matricielle.

Les recommandations V4 du fabricant mettent l’accent sur une logique graphique à plat pour le vectoriel et les logos. Décrivez le type de graphisme, la géométrie, la silhouette, les règles de trait, la palette et la disposition. Pour un emblème portuaire, demandez un graphisme détaillé avec une silhouette compacte de phare, une grande forme de vague, des espaces intérieurs généreux et deux couleurs en aplats. Précisez l’élément dominant et les détails secondaires. Une description structurelle est plus utile à un résultat vectoriel modifiable que des textures photographiques ou un vocabulaire de matériaux lorsque le design doit rester à plat.

La référence actuelle de génération exacte prend en charge des prompts de 10 000 caractères au maximum, une à six sorties, une graine aléatoire et des paramètres de couleurs préférées ou de couleur d’arrière-plan. Des styles personnalisés compatibles et des images de référence facultatifs peuvent établir un traitement visuel répété. La correspondance flexible permet une interprétation plus libre, tandis que la correspondance précise suit davantage le style. Utilisez des références visuellement cohérentes et explicitez le système de couleurs voulu ; les couleurs exactes des références ne sont pas garanties. Pour une génération avec style de référence, utilisez une à dix images PNG, JPG ou WebP, pour un total de 64 MB au maximum et moins de 20 MB chacune. Chaque référence doit avoir un côté court d’au moins 256 pixels, un côté long de 4 096 pixels au maximum et une résolution de 16 mégapixels au maximum. Utilisez soit ces références, soit un style enregistré compatible, et non les deux.

Recraft documente la transformation image-image pour les modèles matriciels et vectoriels V4. Fournissez une image existante et décrivez la modification souhaitée, avec strength de 0 à 1 pour déterminer l’éloignement du résultat généré par rapport à la source. Un modèle vectoriel renvoie du SVG. Cette opération n’accepte pas les paramètres de style V4 ; elle diffère donc de la création d’un nouveau graphisme avec une référence de style. Ses exigences d’entrée permettent des fichiers PNG, JPG, WebP ou SVG de moins de 20 MB, jusqu’à 16 MP, avec des côtés entre 256 et 4096 pixels.

V4 ne prend pas en charge les paramètres V3 negative_prompt, les noms de styles prédéfinis, text_layout, artistic_level ou no_text. Les recommandations du fabricant décrivent des phrases courtes et moyennes lisibles lorsque la hiérarchie est précisée, mais la typographie exacte nécessite toujours un examen du SVG terminé. Vérifiez la silhouette, le lettrage, les zones de couleur et les détails fins à la taille prévue, puis modifiez les formes ou les couleurs selon le design. Cette édition de génération vectorielle détaillée possède ses propres sorties et paramètres, et non les propriétés du modèle matriciel Pro.

Avec Ailoot, sélectionnez cet identifiant exact de modèle dans /v1/images/generations et fournissez le prompt créatif. Conservez toutes les entrées data renvoyées, que la réponse contienne une URL ou une image encodée, et enregistrez les octets réels avec le type de contenu renvoyé. Gardez usage et tout task_id de média avec le fichier, puis examinez ses formes, son lettrage et ses zones de couleur dans le design prévu.

", "aboutText": "Recraft V4 Pro Vector est le modèle SVG Pro de la génération V4 de Recraft. La famille se concentre sur le jugement visuel, les relations chromatiques cohérentes, la composition et l’interprétation détaillée des consignes créatives. La branche Pro vise des détails plus fins et des compositions plus exigeantes, tandis que cette édition Vector produit des créations SVG modifiables. Elle convient à une illustration graphique, un emblème ou un concept de lettrage nécessitant un fichier de travail vectoriel pour des ajustements de design ultérieurs.\n\nLe code exact du modèle est recraftv4_pro_vector. Il se distingue du V4 Vector standard, du modèle matriciel V4 Pro et de la famille ultérieure V4.1. La référence de dimensions du producteur indique que tous les modèles vectoriels acceptent quatorze formats largeur/hauteur et que la sortie SVG n’a pas de taille fixe en pixels. Les dimensions matricielles 2048 × 2048 de V4 Pro ne constituent donc pas une limite de résolution en pixels de cette édition. Choisissez la composition et la forme souhaitées du visuel plutôt qu’une étiquette de taille matricielle.\n\nLes recommandations V4 du fabricant mettent l’accent sur une logique graphique à plat pour le vectoriel et les logos. Décrivez le type de graphisme, la géométrie, la silhouette, les règles de trait, la palette et la disposition. Pour un emblème portuaire, demandez un graphisme détaillé avec une silhouette compacte de phare, une grande forme de vague, des espaces intérieurs généreux et deux couleurs en aplats. Précisez l’élément dominant et les détails secondaires. Une description structurelle est plus utile à un résultat vectoriel modifiable que des textures photographiques ou un vocabulaire de matériaux lorsque le design doit rester à plat.\n\nLa référence actuelle de génération exacte prend en charge des prompts de 10 000 caractères au maximum, une à six sorties, une graine aléatoire et des paramètres de couleurs préférées ou de couleur d’arrière-plan. Des styles personnalisés compatibles et des images de référence facultatifs peuvent établir un traitement visuel répété. La correspondance flexible permet une interprétation plus libre, tandis que la correspondance précise suit davantage le style. Utilisez des références visuellement cohérentes et explicitez le système de couleurs voulu ; les couleurs exactes des références ne sont pas garanties. Pour une génération avec style de référence, utilisez une à dix images PNG, JPG ou WebP, pour un total de 64 MB au maximum et moins de 20 MB chacune. Chaque référence doit avoir un côté court d’au moins 256 pixels, un côté long de 4 096 pixels au maximum et une résolution de 16 mégapixels au maximum. Utilisez soit ces références, soit un style enregistré compatible, et non les deux.\n\nRecraft documente la transformation image-image pour les modèles matriciels et vectoriels V4. Fournissez une image existante et décrivez la modification souhaitée, avec strength de 0 à 1 pour déterminer l’éloignement du résultat généré par rapport à la source. Un modèle vectoriel renvoie du SVG. Cette opération n’accepte pas les paramètres de style V4 ; elle diffère donc de la création d’un nouveau graphisme avec une référence de style. Ses exigences d’entrée permettent des fichiers PNG, JPG, WebP ou SVG de moins de 20 MB, jusqu’à 16 MP, avec des côtés entre 256 et 4096 pixels.\n\nV4 ne prend pas en charge les paramètres V3 negative_prompt, les noms de styles prédéfinis, text_layout, artistic_level ou no_text. Les recommandations du fabricant décrivent des phrases courtes et moyennes lisibles lorsque la hiérarchie est précisée, mais la typographie exacte nécessite toujours un examen du SVG terminé. Vérifiez la silhouette, le lettrage, les zones de couleur et les détails fins à la taille prévue, puis modifiez les formes ou les couleurs selon le design. Cette édition de génération vectorielle détaillée possède ses propres sorties et paramètres, et non les propriétés du modèle matriciel Pro.\n\nAvec Ailoot, sélectionnez cet identifiant exact de modèle dans /v1/images/generations et fournissez le prompt créatif. Conservez toutes les entrées data renvoyées, que la réponse contienne une URL ou une image encodée, et enregistrez les octets réels avec le type de contenu renvoyé. Gardez usage et tout task_id de média avec le fichier, puis examinez ses formes, son lettrage et ses zones de couleur dans le design prévu.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "02d7c27482729c0530bbeaebaa35b6154c0250f5bc25d8058d1d0855e4f43151", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr-ch", "methods": [ { "html": "
•

Recraft: Recraft V4 Pro Vector

Autre /recraft/recraft-v4-pro-vector

Premiers pas

Recraft V4 Pro Vector génère des créations SVG modifiables pour les compositions détaillées, les logos et l’illustration. Cette édition vectorielle Pro de V4 prend en charge des consignes de génération texte-image et des processus image-image distincts, sans attribuer aux SVG des dimensions en pixels propres aux images matricielles.

Entrées acceptées
Texte · Images
Résultats
Images
À 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 V4 Pro Vector est le modèle SVG Pro de la génération V4 de Recraft. La famille se concentre sur le jugement visuel, les relations chromatiques cohérentes, la composition et l’interprétation détaillée des consignes créatives. La branche Pro vise des détails plus fins et des compositions plus exigeantes, tandis que cette édition Vector produit des créations SVG modifiables. Elle convient à une illustration graphique, un emblème ou un concept de lettrage nécessitant un fichier de travail vectoriel pour des ajustements de design ultérieurs.

Le code exact du modèle est recraftv4_pro_vector. Il se distingue du V4 Vector standard, du modèle matriciel V4 Pro et de la famille ultérieure V4.1. La référence de dimensions du producteur indique que tous les modèles vectoriels acceptent quatorze formats largeur/hauteur et que la sortie SVG n’a pas de taille fixe en pixels. Les dimensions matricielles 2048 × 2048 de V4 Pro ne constituent donc pas une limite de résolution en pixels de cette édition. Choisissez la composition et la forme souhaitées du visuel plutôt qu’une étiquette de taille matricielle.

Les recommandations V4 du fabricant mettent l’accent sur une logique graphique à plat pour le vectoriel et les logos. Décrivez le type de graphisme, la géométrie, la silhouette, les règles de trait, la palette et la disposition. Pour un emblème portuaire, demandez un graphisme détaillé avec une silhouette compacte de phare, une grande forme de vague, des espaces intérieurs généreux et deux couleurs en aplats. Précisez l’élément dominant et les détails secondaires. Une description structurelle est plus utile à un résultat vectoriel modifiable que des textures photographiques ou un vocabulaire de matériaux lorsque le design doit rester à plat.

La référence actuelle de génération exacte prend en charge des prompts de 10 000 caractères au maximum, une à six sorties, une graine aléatoire et des paramètres de couleurs préférées ou de couleur d’arrière-plan. Des styles personnalisés compatibles et des images de référence facultatifs peuvent établir un traitement visuel répété. La correspondance flexible permet une interprétation plus libre, tandis que la correspondance précise suit davantage le style. Utilisez des références visuellement cohérentes et explicitez le système de couleurs voulu ; les couleurs exactes des références ne sont pas garanties. Pour une génération avec style de référence, utilisez une à dix images PNG, JPG ou WebP, pour un total de 64 MB au maximum et moins de 20 MB chacune. Chaque référence doit avoir un côté court d’au moins 256 pixels, un côté long de 4 096 pixels au maximum et une résolution de 16 mégapixels au maximum. Utilisez soit ces références, soit un style enregistré compatible, et non les deux.

Recraft documente la transformation image-image pour les modèles matriciels et vectoriels V4. Fournissez une image existante et décrivez la modification souhaitée, avec strength de 0 à 1 pour déterminer l’éloignement du résultat généré par rapport à la source. Un modèle vectoriel renvoie du SVG. Cette opération n’accepte pas les paramètres de style V4 ; elle diffère donc de la création d’un nouveau graphisme avec une référence de style. Ses exigences d’entrée permettent des fichiers PNG, JPG, WebP ou SVG de moins de 20 MB, jusqu’à 16 MP, avec des côtés entre 256 et 4096 pixels.

V4 ne prend pas en charge les paramètres V3 negative_prompt, les noms de styles prédéfinis, text_layout, artistic_level ou no_text. Les recommandations du fabricant décrivent des phrases courtes et moyennes lisibles lorsque la hiérarchie est précisée, mais la typographie exacte nécessite toujours un examen du SVG terminé. Vérifiez la silhouette, le lettrage, les zones de couleur et les détails fins à la taille prévue, puis modifiez les formes ou les couleurs selon le design. Cette édition de génération vectorielle détaillée possède ses propres sorties et paramètres, et non les propriétés du modèle matriciel Pro.

Avec Ailoot, sélectionnez cet identifiant exact de modèle dans /v1/images/generations et fournissez le prompt créatif. Conservez toutes les entrées data renvoyées, que la réponse contienne une URL ou une image encodée, et enregistrez les octets réels avec le type de contenu renvoyé. Gardez usage et tout task_id de média avec le fichier, puis examinez ses formes, son lettrage et ses zones de couleur dans le design prévu.

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
ChampTypeExigenceValeurs et limitesPar défaut
ChampmodelTypestringExigenceObligatoireValeurs et limites
recraft/recraft-v4-pro-vector
Conditions: Utilisez exactement ce sélecteur de routage Ailoot.
Par défaut—
ChamppromptTypestringExigenceObligatoireValeurs et limites
Conditions:
Par défaut—
ChampnTypeintegerExigenceFacultatifValeurs et limites
Minimum: 1
Maximum: 6
Conditions:
Par défaut—
Champaspect_ratioTypestringExigenceFacultatifValeurs et limites
1:1, 4:3, 3:4, 16:9, 9:16, auto
Conditions:
Par défaut—
Champoutput_formatTypestringExigenceFacultatifValeurs et limites
svg
Conditions:
Par défaut—
Champinput_referencesTypearrayExigenceFacultatifValeurs et limites
Conditions:
Par défaut—
ChampqualityTypestringExigenceFacultatifValeurs et limites
auto, low, medium, high, xhigh, max
Conditions:
Par défaut—
Combinaisons d’éléments d’entrée

Texte vers image

Paramètres et cycle de vie de la méthode
ParamètreContrat
Paramètrecontent_typeContratapplication/json
ParamètrerequiredContratmodel, prompt
ParamètreoptionalContratn, aspect_ratio, output_format, input_references, quality
Paramètrematerial_typesContrattext, image
ParamètreconditionsContratUtilisez exactement ce sélecteur de routage Ailoot., quality est un paramètre courant documenté ; les fournisseurs qui ne proposent pas de réglage de qualité l’ignorent. Aucune amélioration de la qualité n’est promise pour un modèle donné.

Cycle de vie : synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · task_id effectivement renvoyé ou enregistrement sélectionné dans la bibliothèque ; operation_id est un identifiant distinct

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.

ConfigurationBarème tarifaireQuantité prévisionnelleUnité de facturationCoût
ConfigurationTarifs de base des jetonsBarème tarifaireTarif de baseQuantité 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
Configurationimage en sortieBarème tarifaire—Quantité prévisionnelle—Unité de facturationpar image en sortieCoût
Sortie · image en sortie · Estimation à des fins de comparaison uniquement $0.6 par image en sortie
ConfigurationCoût estimé de la générationBarème tarifaire—Quantité prévisionnelleEstimation pour une générationUnité de facturation—Coût
Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.6 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 →

Exemples de requêtes

Ailoot Ultra · Images

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=json.loads('{"model": "recraft/recraft-v4-pro-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field."}')\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\n# Submit once. Retain the complete result, original identifiers and every response header.\n

Recevoir et enregistrer les résultats

Ailoot Ultra · Images

Téléchargez chaque image renvoyée ou enregistrez son contenu Base64

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.

Conservez la réponse complète et les en-têtes, les identifiants d’origine, chaque résultat réel et tous les champs de consommation et de comptabilisation. Enregistrez chaque ressource unique dont vous êtes propriétaire et conservez tous les rôles qui y font référence.

Si la réponse d’origine doit être vérifiée

Conservez le X-Client-Request-ID d’origine, la réponse et les en-têtes. Un résultat inconnu ou à l’état result_pending_check n’autorise pas une seconde création.

Champs de la réponse
ChampType
Champdata[].urlTypestring
Champdata[].b64_jsonTypestring
ChampusageTypeobject
Erreurs et étapes suivantes
RéponseConditionÉtape suivante
Réponse400 · invalid_request_errorConditionUn champ obligatoire, un sélecteur de modèle, un type ou une représentation des données d’entrée est invalide.Étape suivanteExaminez les détails de validation renvoyés avant de préparer une requête distincte.
RéponseConditionLa requête d’origine ou son résultat est inconnu ou nécessite un contrôle.Étape suivanteConservez les identifiants et les en-têtes d’origine ; consultez uniquement les enregistrements d’état ou de bibliothèque pris en charge. Ne soumettez pas une nouvelle fois la requête de création.

Alias

Alias du modèle

Ailoot Ultra recraft/recraft-v4-pro-vector

Alias des chemins de méthode

Utilisez les chemins de méthode indiqués ci-dessus.

ID d’appel associés

recraft/recraft-v4-pro-vector

", "method_identity": { "effective_request_model_id": "recraft/recraft-v4-pro-vector", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "recraft/recraft-v4-pro-vector", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|recraft%2Frecraft-v4-pro-vector", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response and headers, original identifiers, every actual output and all usage/accounting fields. Save each unique owned asset and retain every role pointing to it.", "authentication": { "header": "Authorization", "scheme": "Bearer", "value": "$AILOOT_API_KEY" }, "control_semantics": { "other_documented_controls": "Source generic image parsing preserves request JSON. Additional documented controls stay subject to the exact model; missing DTO fields do not create Source refusals.", "quality": "The saved common image schema documents this control and says providers without a quality knob ignore it.", "style": "Selected generic Source passes JSON fields through but the saved dedicated image request schema does not declare a style field. Its omission here is not a Source ban or a supported per-model promise." }, "errors": [ { "condition": "Un champ obligatoire, un sélecteur de modèle, un type ou une représentation des données d’entrée est invalide.", "http_status": 400, "recovery": "Examinez les détails de validation renvoyés avant de préparer une requête distincte.", "type": "invalid_request_error" }, { "condition": "La requête d’origine ou son résultat est inconnu ou nécessite un contrôle.", "http_status": null, "recovery": "Conservez les identifiants et les en-têtes d’origine ; consultez uniquement les enregistrements d’état ou de bibliothèque pris en charge. Ne soumettez pas une nouvelle fois la requête de création.", "type": null } ], "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned signed URL; never construct a token." }, "status": [ { "http": "GET", "id_source": "actual returned task_id or selected library record; operation_id is a separate identifier", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Conservez le X-Client-Request-ID d’origine, la réponse et les en-têtes. Un résultat inconnu ou à l’état result_pending_check n’autorise pas une seconde création.", "unknown_no_replay": true }, "material_combinations": [ { "materials": [ "text", "image" ], "metadata_authority": "saved_model_discovery_union", "mode": "text_to_image", "reference_maximum": 1, "reference_minimum": 0 } ], "model_parameter_metadata": { "authority": "saved_model_discovery_union", "defaults_not_inferred": { "aspect_ratio": null, "exact_pixels": null, "explanation": "No universal/model default inferred. Omitted output_format uses provider default; dimensions are provider-derived, observed Ming2048 is not a universal default.", "n": null, "output_format": null, "quality": null, "resolution": null }, "known_parameter_choices": { "aspect_ratio": { "type": "enum", "values": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ] }, "input_references": { "max": 1, "min": 0, "type": "range" }, "n": { "max": 6, "min": 1, "type": "range" }, "output_format": { "type": "enum", "values": [ "svg" ] } }, "pointer": "/profiles/42", "scope": "Exact saved model metadata. Discovery unions are identified explicitly and are not represented as definitive selected-provider bounds." }, "outputs": { "all_results": "Conservez la réponse complète et les en-têtes, les identifiants d’origine, chaque résultat réel et tous les champs de consommation et de comptabilisation. Enregistrez chaque ressource unique dont vous êtes propriétaire et conservez tous les rôles qui y font référence.", "documented_formats": [ "svg" ], "every_actual_output": true, "family": "image", "fields": [ { "name": "data[].url", "type": "string" }, { "name": "data[].b64_json", "type": "string" }, { "name": "usage", "type": "object" } ], "format": "The exact saved model metadata lists SVG. Preserve the actual returned MIME and unchanged vector bytes; keep every actual output and owned signed image link." }, "parameters": [ { "conditions": "Utilisez exactement ce sélecteur de routage Ailoot.", "default_known": false, "enum": [ "recraft/recraft-v4-pro-vector" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "name": "prompt", "required": true, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "maximum": 6, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "conditions": "", "default_known": false, "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "conditions": "", "default_known": false, "enum": [ "svg" ], "enum_known": true, "name": "output_format", "required": false, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "minItems": 0, "name": "input_references", "required": false, "type": "array" }, { "conditions": "", "default_known": false, "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "enum_known": true, "name": "quality", "required": false, "type": "string" } ], "request_schema": { "additionalProperties": true, "properties": { "aspect_ratio": { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "minItems": 0, "type": "array" }, "model": { "enum": [ "recraft/recraft-v4-pro-vector" ], "type": "string" }, "n": { "maximum": 6, "minimum": 1, "type": "integer" }, "output_format": { "enum": [ "svg" ], "type": "string" }, "prompt": { "type": "string" }, "quality": { "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "recraft/recraft-v4-pro-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field." }, "content_type": "application/json", "example_is_offline_content": true }, "usage": { "meter": "Use the accepted method price and actual recorded usage; the request reserve is an estimate. A billing unit does not add an input capability.", "preserve": "Keep all returned usage, accounting and request identifiers with every actual output.", "settlement": "Retain the original operation; reconcile its result and accounting once." } }, "input": { "conditions": [ "Utilisez exactement ce sélecteur de routage Ailoot.", "quality est un paramètre courant documenté ; les fournisseurs qui ne proposent pas de réglage de qualité l’ignorent. Aucune amélioration de la qualité n’est promise pour un modèle donné." ], "content_type": "application/json", "material_types": [ "text", "image" ], "optional": [ "n", "aspect_ratio", "output_format", "input_references", "quality" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned signed URL; never construct a token." }, "status": [ { "http": "GET", "id_source": "task_id effectivement renvoyé ou enregistrement sélectionné dans la bibliothèque ; operation_id est un identifiant distinct", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the original X-Client-Request-ID, response and headers. An unknown or result_pending_check outcome does not authorize a second creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "output": { "all_results": "Retain the complete response and headers, original identifiers, every actual output and all usage/accounting fields. Save each unique owned asset and retain every role pointing to it.", "documented_formats": [ "svg" ], "every_actual_output": true, "family": "image", "fields": [ { "name": "data[].url", "type": "string" }, { "name": "data[].b64_json", "type": "string" }, { "name": "usage", "type": "object" } ], "format": "The saved exact model metadata lists SVG. Preserve actual MIME and bytes; storage MIME support alone does not prove completion of the full selected generic output path." } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per output image" }, "label": "output image", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Coût estimé de la génération", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "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=json.loads('{\"model\": \"recraft/recraft-v4-pro-vector\", \"prompt\": \"A portrait of an Asian woman with neon green lights in the background, shallow depth of field.\"}')\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\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "images", "http": "POST", "in": null, "input": [ "text", "image" ], "input_conditions": { "image": "Use the exact model reference-input range in the saved model metadata; a reference becomes required only for the models whose listed minimum is positive." }, "label": "Images", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "image" ], "path": "/v1/images/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per output image" }, "label": "output image", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "recraft/recraft-v4-pro-vector", "route_label": "Ultra", "status_reads": [ "GET /v1/media/tasks/{task_id}" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" }, { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "recraft/recraft-v4-pro-vector", "nativeProvenance": { "input_facts_canonical_sha256": "237481451a2903c84eeb2bbffe937efe690d3bcd1dfd9bde42feba76c3e6be1a", "input_html_sha256": "5bae848d80350f8a188b7aa272767da182844994d2a18175e74c509d86fbe147", "private_audit_sha256": "a87587761ab25c62ac011ec2641eb0e6cec2d55fb00ee4cffdb671b8a5072cd6", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/fr-ch/recraft-recraft-v4-pro-vector/", "description": "Recraft V4 Pro Vector génère des créations SVG modifiables pour les compositions détaillées, les logos et l’illustration. Cette édition vectorielle Pro de V4 prend en charge des consignes de génération texte-image et des processus image-image distincts, sans attribuer aux SVG des dimensions en pixels propres aux images matricielles.", "locale": "fr-ch", "md_url": "https://ailoot.ai/models/fr-ch/recraft-recraft-v4-pro-vector/index.md", "title": "Recraft: Recraft V4 Pro Vector — Ailoot", "url": "https://ailoot.ai/models/fr-ch/recraft-recraft-v4-pro-vector/" }, "rawModel": { "about": "Recraft V4 Pro Vector est le modèle SVG Pro de la génération V4 de Recraft. La famille se concentre sur le jugement visuel, les relations chromatiques cohérentes, la composition et l’interprétation détaillée des consignes créatives. La branche Pro vise des détails plus fins et des compositions plus exigeantes, tandis que cette édition Vector produit des créations SVG modifiables. Elle convient à une illustration graphique, un emblème ou un concept de lettrage nécessitant un fichier de travail vectoriel pour des ajustements de design ultérieurs.\n\nLe code exact du modèle est recraftv4_pro_vector. Il se distingue du V4 Vector standard, du modèle matriciel V4 Pro et de la famille ultérieure V4.1. La référence de dimensions du producteur indique que tous les modèles vectoriels acceptent quatorze formats largeur/hauteur et que la sortie SVG n’a pas de taille fixe en pixels. Les dimensions matricielles 2048 × 2048 de V4 Pro ne constituent donc pas une limite de résolution en pixels de cette édition. Choisissez la composition et la forme souhaitées du visuel plutôt qu’une étiquette de taille matricielle.\n\nLes recommandations V4 du fabricant mettent l’accent sur une logique graphique à plat pour le vectoriel et les logos. Décrivez le type de graphisme, la géométrie, la silhouette, les règles de trait, la palette et la disposition. Pour un emblème portuaire, demandez un graphisme détaillé avec une silhouette compacte de phare, une grande forme de vague, des espaces intérieurs généreux et deux couleurs en aplats. Précisez l’élément dominant et les détails secondaires. Une description structurelle est plus utile à un résultat vectoriel modifiable que des textures photographiques ou un vocabulaire de matériaux lorsque le design doit rester à plat.\n\nLa référence actuelle de génération exacte prend en charge des prompts de 10 000 caractères au maximum, une à six sorties, une graine aléatoire et des paramètres de couleurs préférées ou de couleur d’arrière-plan. Des styles personnalisés compatibles et des images de référence facultatifs peuvent établir un traitement visuel répété. La correspondance flexible permet une interprétation plus libre, tandis que la correspondance précise suit davantage le style. Utilisez des références visuellement cohérentes et explicitez le système de couleurs voulu ; les couleurs exactes des références ne sont pas garanties. Pour une génération avec style de référence, utilisez une à dix images PNG, JPG ou WebP, pour un total de 64 MB au maximum et moins de 20 MB chacune. Chaque référence doit avoir un côté court d’au moins 256 pixels, un côté long de 4 096 pixels au maximum et une résolution de 16 mégapixels au maximum. Utilisez soit ces références, soit un style enregistré compatible, et non les deux.\n\nRecraft documente la transformation image-image pour les modèles matriciels et vectoriels V4. Fournissez une image existante et décrivez la modification souhaitée, avec strength de 0 à 1 pour déterminer l’éloignement du résultat généré par rapport à la source. Un modèle vectoriel renvoie du SVG. Cette opération n’accepte pas les paramètres de style V4 ; elle diffère donc de la création d’un nouveau graphisme avec une référence de style. Ses exigences d’entrée permettent des fichiers PNG, JPG, WebP ou SVG de moins de 20 MB, jusqu’à 16 MP, avec des côtés entre 256 et 4096 pixels.\n\nV4 ne prend pas en charge les paramètres V3 negative_prompt, les noms de styles prédéfinis, text_layout, artistic_level ou no_text. Les recommandations du fabricant décrivent des phrases courtes et moyennes lisibles lorsque la hiérarchie est précisée, mais la typographie exacte nécessite toujours un examen du SVG terminé. Vérifiez la silhouette, le lettrage, les zones de couleur et les détails fins à la taille prévue, puis modifiez les formes ou les couleurs selon le design. Cette édition de génération vectorielle détaillée possède ses propres sorties et paramètres, et non les propriétés du modèle matriciel Pro.\n\nAvec Ailoot, sélectionnez cet identifiant exact de modèle dans /v1/images/generations et fournissez le prompt créatif. Conservez toutes les entrées data renvoyées, que la réponse contienne une URL ou une image encodée, et enregistrez les octets réels avec le type de contenu renvoyé. Gardez usage et tout task_id de média avec le fichier, puis examinez ses formes, son lettrage et ses zones de couleur dans le design prévu.", "alias_of": null, "aliases": [], "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "La tarification complète de la configuration figure dans les détails." } ], "ctx": null, "formats": [ "images" ], "id": "recraft/recraft-v4-pro-vector", "input": [ "text", "image" ], "kind": "image", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response and headers, original identifiers, every actual output and all usage/accounting fields. Save each unique owned asset and retain every role pointing to it.", "authentication": { "header": "Authorization", "scheme": "Bearer", "value": "$AILOOT_API_KEY" }, "control_semantics": { "other_documented_controls": "Source generic image parsing preserves request JSON. Additional documented controls stay subject to the exact model; missing DTO fields do not create Source refusals.", "quality": "The saved common image schema documents this control and says providers without a quality knob ignore it.", "style": "Selected generic Source passes JSON fields through but the saved dedicated image request schema does not declare a style field. Its omission here is not a Source ban or a supported per-model promise." }, "errors": [ { "condition": "Un champ obligatoire, un sélecteur de modèle, un type ou une représentation des données d’entrée est invalide.", "http_status": 400, "recovery": "Examinez les détails de validation renvoyés avant de préparer une requête distincte.", "type": "invalid_request_error" }, { "condition": "La requête d’origine ou son résultat est inconnu ou nécessite un contrôle.", "http_status": null, "recovery": "Conservez les identifiants et les en-têtes d’origine ; consultez uniquement les enregistrements d’état ou de bibliothèque pris en charge. Ne soumettez pas une nouvelle fois la requête de création.", "type": null } ], "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned signed URL; never construct a token." }, "status": [ { "http": "GET", "id_source": "actual returned task_id or selected library record; operation_id is a separate identifier", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Conservez le X-Client-Request-ID d’origine, la réponse et les en-têtes. Un résultat inconnu ou à l’état result_pending_check n’autorise pas une seconde création.", "unknown_no_replay": true }, "material_combinations": [ { "materials": [ "text", "image" ], "metadata_authority": "saved_model_discovery_union", "mode": "text_to_image", "reference_maximum": 1, "reference_minimum": 0 } ], "model_parameter_metadata": { "authority": "saved_model_discovery_union", "defaults_not_inferred": { "aspect_ratio": null, "exact_pixels": null, "explanation": "No universal/model default inferred. Omitted output_format uses provider default; dimensions are provider-derived, observed Ming2048 is not a universal default.", "n": null, "output_format": null, "quality": null, "resolution": null }, "known_parameter_choices": { "aspect_ratio": { "type": "enum", "values": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ] }, "input_references": { "max": 1, "min": 0, "type": "range" }, "n": { "max": 6, "min": 1, "type": "range" }, "output_format": { "type": "enum", "values": [ "svg" ] } }, "pointer": "/profiles/42", "scope": "Exact saved model metadata. Discovery unions are identified explicitly and are not represented as definitive selected-provider bounds." }, "outputs": { "all_results": "Conservez la réponse complète et les en-têtes, les identifiants d’origine, chaque résultat réel et tous les champs de consommation et de comptabilisation. Enregistrez chaque ressource unique dont vous êtes propriétaire et conservez tous les rôles qui y font référence.", "documented_formats": [ "svg" ], "every_actual_output": true, "family": "image", "fields": [ { "name": "data[].url", "type": "string" }, { "name": "data[].b64_json", "type": "string" }, { "name": "usage", "type": "object" } ], "format": "The exact saved model metadata lists SVG. Preserve the actual returned MIME and unchanged vector bytes; keep every actual output and owned signed image link." }, "parameters": [ { "conditions": "Utilisez exactement ce sélecteur de routage Ailoot.", "default_known": false, "enum": [ "recraft/recraft-v4-pro-vector" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "name": "prompt", "required": true, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "maximum": 6, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "conditions": "", "default_known": false, "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "conditions": "", "default_known": false, "enum": [ "svg" ], "enum_known": true, "name": "output_format", "required": false, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "minItems": 0, "name": "input_references", "required": false, "type": "array" }, { "conditions": "", "default_known": false, "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "enum_known": true, "name": "quality", "required": false, "type": "string" } ], "request_schema": { "additionalProperties": true, "properties": { "aspect_ratio": { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "minItems": 0, "type": "array" }, "model": { "enum": [ "recraft/recraft-v4-pro-vector" ], "type": "string" }, "n": { "maximum": 6, "minimum": 1, "type": "integer" }, "output_format": { "enum": [ "svg" ], "type": "string" }, "prompt": { "type": "string" }, "quality": { "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "recraft/recraft-v4-pro-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field." }, "content_type": "application/json", "example_is_offline_content": true }, "usage": { "meter": "Use the accepted method price and actual recorded usage; the request reserve is an estimate. A billing unit does not add an input capability.", "preserve": "Keep all returned usage, accounting and request identifiers with every actual output.", "settlement": "Retain the original operation; reconcile its result and accounting once." } }, "input": { "conditions": [ "Utilisez exactement ce sélecteur de routage Ailoot.", "quality est un paramètre courant documenté ; les fournisseurs qui ne proposent pas de réglage de qualité l’ignorent. Aucune amélioration de la qualité n’est promise pour un modèle donné." ], "content_type": "application/json", "material_types": [ "text", "image" ], "optional": [ "n", "aspect_ratio", "output_format", "input_references", "quality" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned signed URL; never construct a token." }, "status": [ { "http": "GET", "id_source": "task_id effectivement renvoyé ou enregistrement sélectionné dans la bibliothèque ; operation_id est un identifiant distinct", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the original X-Client-Request-ID, response and headers. An unknown or result_pending_check outcome does not authorize a second creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "output": { "all_results": "Retain the complete response and headers, original identifiers, every actual output and all usage/accounting fields. Save each unique owned asset and retain every role pointing to it.", "documented_formats": [ "svg" ], "every_actual_output": true, "family": "image", "fields": [ { "name": "data[].url", "type": "string" }, { "name": "data[].b64_json", "type": "string" }, { "name": "usage", "type": "object" } ], "format": "The saved exact model metadata lists SVG. Preserve actual MIME and bytes; storage MIME support alone does not prove completion of the full selected generic output path." } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per output image" }, "label": "output image", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Coût estimé de la génération", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "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=json.loads('{\"model\": \"recraft/recraft-v4-pro-vector\", \"prompt\": \"A portrait of an Asian woman with neon green lights in the background, shallow depth of field.\"}')\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\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "images", "http": "POST", "in": null, "input": [ "text", "image" ], "input_conditions": { "image": "Use the exact model reference-input range in the saved model metadata; a reference becomes required only for the models whose listed minimum is positive." }, "label": "Images", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "image" ], "path": "/v1/images/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per output image" }, "label": "output image", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "recraft/recraft-v4-pro-vector", "route_label": "Ultra", "status_reads": [ "GET /v1/media/tasks/{task_id}" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" }, { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "recraft/recraft-v4-pro-vector", "request_model_id": "recraft/recraft-v4-pro-vector", "route_label": "Ultra" } ], "name": "Recraft: Recraft V4 Pro Vector", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.6, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.6, "varies": false }, "short": "Recraft V4 Pro Vector génère des créations SVG modifiables pour les compositions détaillées, les logos et l’illustration. Cette édition vectorielle Pro de V4 prend en charge des consignes de génération texte-image et des processus image-image distincts, sans attribuer aux SVG des dimensions en pixels propres aux images matricielles.", "title": "Recraft: Recraft V4 Pro Vector" }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "Recraft V4 Pro Vector génère des créations SVG modifiables pour les compositions détaillées, les logos et l’illustration. Cette édition vectorielle Pro de V4 prend en charge des consignes de génération texte-image et des processus image-image distincts, sans attribuer aux SVG des dimensions en pixels propres aux images matricielles.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "c7b3eae46e1166f09003f06afe465a43171e7315a6c57fd72fa2bafcae217ab5", "renderer_sha256": "4d2f3bfcbf0fa5c616c87aa9524d00d7cff227d8dfa2446ff47c8e0220325dc9" }, "sourceRevision": "5eedd99f2c79a4845dc42bcd86edbe59e93eae50a6c5ca3477330556c7613ade" }