> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dgrid.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Générations d'images Qwen
> OpenAI-compatible image generation. Also accepts Qwen-compatible payloads (`wanx-v1` style models) using an `input.messages` wrapper instead of `prompt`.
Cette page utilise la même opération `images/generations` que [Créer une image](/fr/api-reference/images/create-image), avec le playground ci-dessus prérempli pour le schéma d'image générique de style OpenAI (`prompt`, `model`, `size`, etc.). Les notes ci-dessous décrivent la forme de requête spécifique à Qwen pour les modèles de type `wanx-v1`.
Les modèles d'image Qwen acceptent une forme de requête alternative qui place votre prompt dans `input.messages` au lieu d'un champ `prompt` de premier niveau. Fournissez `model` et `input` ensemble dans le corps de requête du playground pour utiliser ce format.
### Champs de requête spécifiques à Qwen
| Champ | Type | Requis | Description |
| -------------------------- | ------ | ------ | ------------------------------------------------------------------------------------------- |
| `model` | string | Oui | Identifiant du modèle, tel que `wanx-v1`. |
| `input` | object | Oui | Objet conteneur envoyé dans la requête, utilisé à la place d'un `prompt` de premier niveau. |
| `input.messages` | array | Oui | Tableau de messages imbriqué sous `input`. |
| `input.messages[].role` | string | Oui | Rôle du message, par exemple `user`. |
| `input.messages[].content` | string | Oui | Texte du prompt décrivant l'image souhaitée. |
Contrairement aux champs standards `prompt` / `size` / `quality` affichés dans le playground, les modèles `wanx-v1` de Qwen lisent le prompt à partir de `input.messages[].content`. Les autres champs de premier niveau tels que `n` et `response_format` ne sont pas utilisés par ce format.
### Exemple : générer une image
```json theme={null}
{
"model": "wanx-v1",
"input": {
"messages": [
{
"role": "user",
"content": "A serene mountain lake at dawn, photorealistic."
}
]
}
}
```
### Champs de réponse
La réponse suit la forme standard de génération d'image :
Horodatage de création.
Éléments d'image générés.
URL de l'image.
Charge utile image en base64.
Prompt révisé renvoyé par le modèle.
### Exemple de réponse
```json 200 theme={null}
{
"created": 1719859200,
"data": [
{
"url": "https://cdn.dgrid.ai/generated/abc123.png",
"b64_json": "",
"revised_prompt": "A serene mountain lake at dawn with mist rising off the water, photorealistic."
}
]
}
```
## OpenAPI
````yaml api-reference/openapi.json POST /v1/images/generations
openapi: 3.1.0
info:
title: DGrid AI Gateway API
description: >-
A single, unified API to access 200+ leading AI models. OpenAI-, Claude-,
and Gemini-compatible endpoints for chat, completions, embeddings, images,
audio, and moderations.
version: 1.0.0
contact:
name: DGrid AI
url: https://dgrid.ai
servers:
- url: https://api.dgrid.ai
description: DGrid AI Gateway
security:
- bearerAuth: []
paths:
/v1/images/generations:
post:
tags:
- Images
summary: Create image
description: >-
OpenAI-compatible image generation. Also accepts Qwen-compatible
payloads (`wanx-v1` style models) using an `input.messages` wrapper
instead of `prompt`.
operationId: createImage
requestBody:
required: true
content:
application/json:
schema:
oneOf:
- type: object
title: OpenAI format
required:
- prompt
properties:
prompt:
type: string
description: Image prompt.
model:
type: string
default: dall-e-2
description: Model such as `dall-e-2` or `dall-e-3`.
'n':
type: integer
default: 1
description: Number of images to generate.
quality:
type: string
enum:
- standard
- hd
default: standard
response_format:
type: string
enum:
- url
- b64_json
default: url
size:
type: string
default: 1024x1024
description: Output size.
style:
type: string
enum:
- vivid
- natural
default: vivid
user:
type: string
description: End-user identifier.
- type: object
title: Qwen format
required:
- model
- input
properties:
model:
type: string
description: Model identifier, such as `wanx-v1`.
input:
type: object
description: Input wrapper object.
properties:
messages:
type: array
description: Messages array nested under `input`.
items:
type: object
example:
prompt: A cute baby sea otter wearing a beret
model: dall-e-3
size: 1024x1024
responses:
'200':
description: Generated images.
content:
application/json:
schema:
$ref: '#/components/schemas/ImageResponse'
'400':
$ref: '#/components/responses/BadRequest'
components:
schemas:
ImageResponse:
type: object
properties:
created:
type: integer
description: Creation timestamp.
data:
type: array
description: Generated image entries.
items:
type: object
properties:
url:
type: string
description: Image URL when using URL output.
b64_json:
type: string
description: Base64 image payload when requested.
revised_prompt:
type: string
description: Refined prompt returned by the model.
usage:
type: object
properties:
total_tokens:
type: integer
input_tokens:
type: integer
output_tokens:
type: integer
input_tokens_details:
type: object
properties:
text_tokens:
type: integer
image_tokens:
type: integer
Error:
type: object
properties:
error:
type: object
properties:
message:
type: string
type:
type: string
param:
type: string
code:
type: string
responses:
BadRequest:
description: Invalid request.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: >-
Your DGrid API key. All endpoints use `Authorization: Bearer
`.
````