> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Grok Imagine Image 2.0 Generation d'Image > - Grok Imagine Image 2.0 (grok-imagine-image-2.0) est le modèle de génération et d'édition d'images de xAI : la génération texte vers image et l'édition d'image partagent le même nom de modèle - Sans `image_urls`, il s'agit de génération texte vers image ; avec `1~3` images de référence, le modèle bascule automatiquement en édition d'image, sans changer de modèle - Mode de traitement asynchrone, utilisez l'ID de tâche retourné pour [interroger](/fr/api-manual/task-management/get-task-detail) - Les liens d'image générés sont valides pendant 24 heures, veuillez les enregistrer rapidement ## OpenAPI ````yaml fr/api-manual/image-series/grok/grok-imagine-image-2.0-image-generate.json POST /v1/images/generations openapi: 3.1.0 info: title: API grok-imagine-image-2.0 description: >- Créer des tâches d'images en utilisant des modèles IA avec prise en charge de plusieurs modèles et configurations de paramètres license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Production security: - bearerAuth: [] tags: - name: Génération d'image description: API liées à la génération d'images par IA paths: /v1/images/generations: post: tags: - Génération d'image summary: API grok-imagine-image-2.0 description: >- - Grok Imagine Image 2.0 (grok-imagine-image-2.0) est le modèle de génération et d'édition d'images de xAI : la génération texte vers image et l'édition d'image partagent le même nom de modèle - Sans `image_urls`, il s'agit de génération texte vers image ; avec `1~3` images de référence, le modèle bascule automatiquement en édition d'image, sans changer de modèle - Mode de traitement asynchrone, utilisez l'ID de tâche retourné pour [interroger](/fr/api-manual/task-management/get-task-detail) - Les liens d'image générés sont valides pendant 24 heures, veuillez les enregistrer rapidement operationId: createImageGenerationGrokImagineImage2 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ImageGenerationRequest' examples: text_to_image: summary: Texte vers image (simple) value: model: grok-imagine-image-2.0 prompt: >- Rue de Tokyo la nuit dans un style cyberpunk, néons se reflétant sur la chaussée mouillée text_to_image_hd: summary: Texte vers image (2K écran large) value: model: grok-imagine-image-2.0 prompt: >- Plan large cinématographique d'une skyline futuriste au crépuscule size: '16:9' resolution: 2K quality: medium image_edit: summary: Édition d'image (une image de référence) value: model: grok-imagine-image-2.0 prompt: Change la saison de la scène en un hiver enneigé size: '1:1' resolution: 1K quality: medium image_urls: - https://example.com/input.png callback_url: https://your-domain.com/webhook/image-done multi_image_edit: summary: Édition multi-images (syntaxe de référence) value: model: grok-imagine-image-2.0 prompt: >- Place le personnage de dans la scène de en conservant la même lumière size: '16:9' resolution: 1K quality: medium image_urls: - https://example.com/person.png - https://example.com/scene.png batch_generation: summary: Génération par lot (niveau rapide) value: model: grok-imagine-image-2.0 prompt: Un robot mignon en pixel art size: '1:1' resolution: 1K quality: low 'n': 4 responses: '200': description: Tâche d'image créée avec succès content: application/json: schema: $ref: '#/components/schemas/ImageGenerationResponse' '400': description: Paramètres de requête invalides content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: Non authentifié, jeton invalide ou expiré content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Quota insuffisant, recharge requise content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Accès refusé content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: grok-imagine-image-2.0' type: invalid_request_error '429': description: Limite de taux dépassée content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Erreur interne du serveur content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: ImageGenerationRequest: type: object required: - model - prompt properties: model: type: string description: >- Nom du modèle de génération d'images. La génération texte vers image et l'édition d'image partagent ce nom de modèle ; le mode bascule automatiquement selon que `image_urls` est fourni ou non enum: - grok-imagine-image-2.0 example: grok-imagine-image-2.0 prompt: type: string description: >- Prompt décrivant l'image souhaitée, ou la manière d'éditer les images de référence fournies **Syntaxe de référence multi-images :** - Lorsque plusieurs images de référence sont fournies, utilisez ``, ``, `` dans le prompt pour désigner respectivement la 1re, la 2e et la 3e image de référence - Les index commencent à `0` et correspondent un à un à l'ordre du tableau `image_urls` - Exemple : `Place le personnage de dans la scène de ` example: >- Rue de Tokyo la nuit dans un style cyberpunk, néons se reflétant sur la chaussée mouillée image_urls: type: array description: >- Liste d'URL d'images de référence pour les fonctions image vers image et édition d'image **Remarque :** - Nombre d'images d'entrée par requête : `0~3` (sans ce paramètre = texte vers image, `1~3` = édition d'image) - Seules les URL d'images `http` / `https` accessibles publiquement sont prises en charge ; base64 et data URL ne le sont pas - Formats de fichiers pris en charge : `.jpeg`, `.jpg`, `.png`, `.webp` - Les URL d'images doivent être directement accessibles par le serveur, ou l'URL de l'image doit déclencher un téléchargement direct lors de l'accès (généralement ces URL se terminent par des extensions de fichiers image, telles que `.png`, `.jpg`) - En édition d'image, les images de référence entraînent un coût supplémentaire, compté une seule fois par requête et non multiplié par `n` items: type: string format: uri maxItems: 3 example: - https://example.com/person.png - https://example.com/scene.png size: type: string description: >- Rapport largeur/hauteur de l'image générée, `auto` par défaut **Rapports pris en charge (13) :** | Rapport | Description | |---|---| | `1:1` | Carré | | `4:3` / `3:4` | Paysage / portrait classique | | `3:2` / `2:3` | Paysage / portrait standard | | `16:9` / `9:16` | Écran large / portrait mobile | | `2:1` / `1:2` | Très large / très haut | | `19.5:9` / `9:19.5` | Smartphone plein écran paysage / portrait | | `20:9` / `9:20` | Ultra-large paysage / portrait | **Remarque :** - `auto` : le modèle choisit lui-même le rapport ; omettre ce paramètre équivaut à `auto` (la sortie est généralement en portrait) - Toute valeur absente du tableau ci-dessus n'est pas prise en charge enum: - '1:1' - '4:3' - '3:4' - '3:2' - '2:3' - '16:9' - '9:16' - '2:1' - '1:2' - 19.5:9 - '9:19.5' - '20:9' - '9:20' - auto default: auto example: '16:9' resolution: type: string description: >- Niveau de pixels de l'image de sortie, `1K` par défaut ; prend en charge les niveaux `1K` et `2K` **Remarque :** - Ce modèle ne prend pas en charge `4K` - Les valeurs sont insensibles à la casse enum: - 1K - 2K default: 1K example: 1K quality: type: string description: >- Niveau de qualité de génération, contrôle la profondeur de réflexion du modèle, `medium` par défaut | Valeur | Description | |---|---| | `low` | Génération plus rapide, coût réduit | | `medium` | Meilleure qualité et plus de détails | **Remarque :** - Ce modèle ne prend en charge que les niveaux `low` / `medium` ; toute autre valeur telle que `high` n'est pas prise en charge - `quality` (niveau de qualité) et `resolution` (niveau de pixels) sont indépendants et librement combinables - Les valeurs sont insensibles à la casse enum: - low - medium default: medium example: medium 'n': type: integer description: >- Nombre d'images à générer, plage `1~10`, `1` par défaut **Remarque :** - Chaque image est facturée séparément, le coût augmente linéairement avec `n` - Le coût supplémentaire des images de référence est compté une seule fois par requête et n'est pas multiplié par `n` - Une fois la tâche terminée, `result_urls` renvoie `n` liens d'images indépendants minimum: 1 maximum: 10 default: 1 example: 1 callback_url: type: string description: >- Adresse de rappel HTTPS après l'achèvement de la tâche **Moment du rappel :** - Déclenché lorsque la tâche est terminée, échouée ou annulée - Envoyé après confirmation de la facturation **Restrictions de sécurité :** - Seul le protocole HTTPS est pris en charge - Les rappels vers les adresses IP internes sont interdits (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.) - La longueur de l'URL ne doit pas dépasser `2048` caractères **Mécanisme de rappel :** - Délai d'expiration : `10` secondes - Maximum `3` tentatives en cas d'échec (tentatives après `1` seconde/`2` secondes/`4` secondes) - Le format du corps de réponse du rappel est cohérent avec le format de réponse de l'API de requête de tâche - Un code de statut 2xx renvoyé par l'adresse de rappel est considéré comme un succès, les autres codes de statut déclenchent une nouvelle tentative format: uri example: https://your-domain.com/webhooks/image-task-completed ImageGenerationResponse: type: object properties: created: type: integer description: Horodatage de création de la tâche example: 1757156493 id: type: string description: ID de tâche example: task-unified-1757156493-imcg5zqt model: type: string description: Nom du modèle réellement utilisé example: grok-imagine-image-2.0 object: type: string enum: - image.generation.task description: Type spécifique de tâche progress: type: integer description: Pourcentage de progression de la tâche (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Statut de la tâche enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/TaskInfo' description: Informations sur la tâche asynchrone type: type: string enum: - text - image - audio - video description: Type de sortie de la tâche example: image usage: $ref: '#/components/schemas/Usage' description: Informations d'utilisation et de facturation ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Identifiant de code d'erreur message: type: string description: Description de l'erreur type: type: string description: Type d'erreur TaskInfo: type: object properties: can_cancel: type: boolean description: Si la tâche peut être annulée example: true estimated_time: type: integer description: Temps estimé d'achèvement (secondes) minimum: 0 example: 100 Usage: type: object description: Informations d'utilisation et de facturation properties: billing_rule: type: string description: Règle de facturation enum: - per_call - per_token - per_second example: per_call credits_reserved: type: number description: Crédits estimés consommés minimum: 0 example: 3.06 user_group: type: string description: Catégorie de groupe d'utilisateurs example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ##Toutes les API nécessitent une authentification Bearer Token## **Obtenir une clé API :** Visitez la [Page de gestion des clés API](https://evolink.ai/dashboard/keys) pour obtenir votre clé API **Ajouter à l'en-tête de requête :** ``` Authorization: Bearer YOUR_API_KEY ``` ````