Passer au contenu principal
POST
/
v1
/
images
/
generations
Create image
curl --request POST \
  --url https://api.dgrid.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A cute baby sea otter wearing a beret",
  "model": "dall-e-3",
  "size": "1024x1024"
}
'
{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "revised_prompt": "<string>"
    }
  ],
  "usage": {
    "total_tokens": 123,
    "input_tokens": 123,
    "output_tokens": 123,
    "input_tokens_details": {
      "text_tokens": 123,
      "image_tokens": 123
    }
  }
}
Cette page utilise la même opération images/generations que Créer une 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

ChampTypeRequisDescription
modelstringOuiIdentifiant du modèle, tel que wanx-v1.
inputobjectOuiObjet conteneur envoyé dans la requête, utilisé à la place d’un prompt de premier niveau.
input.messagesarrayOuiTableau de messages imbriqué sous input.
input.messages[].rolestringOuiRôle du message, par exemple user.
input.messages[].contentstringOuiTexte 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

{
  "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 :
​
created
integer
Horodatage de création.
​
data
array
Éléments d’image générés.

​
Exemple de réponse

200
{
  "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."
    }
  ]
}

Autorisations

​
Authorization
string
header
requis

Your DGrid API key. All endpoints use Authorization: Bearer <DGRID_API_KEY>.

Corps

application/json
​
prompt
string
requis

Image prompt.

​
model
string
défaut:dall-e-2

Model such as dall-e-2 or dall-e-3.

​
n
integer
défaut:1

Number of images to generate.

​
quality
enum<string>
défaut:standard
Options disponibles:
standard,
hd
​
response_format
enum<string>
défaut:url
Options disponibles:
url,
b64_json
​
size
string
défaut:1024x1024

Output size.

​
style
enum<string>
défaut:vivid
Options disponibles:
vivid,
natural
​
user
string

End-user identifier.

Réponse

Generated images.

​
created
integer

Creation timestamp.

​
data
object[]

Generated image entries.

​
usage
object