> ## Documentation Index
> Fetch the complete documentation index at: https://docs.novita.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ming Image — Génération d’images à partir de texte

Ming Image est une famille de modèles de génération d’images. `ming-image-0.1-design` permet de générer des images à partir de texte à l’aide du protocole de génération d’images d’OpenAI.

* `ming-image-0.1-design` : permet de générer des images à partir de texte à l’aide du protocole de génération d’images d’OpenAI.
* `ming-image-0.1-design-layer` : prend uniquement en charge la séparation en calques à l’aide du protocole de modification d’images d’OpenAI (voir l’API de [séparation en calques Ming Image](/fr/api-reference/model-apis-ming-image-layer)).

## En-têtes de la requête

<ParamField header="Content-Type" type="string" required={true}>
  Format pris en charge : `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Format d’authentification Bearer, par exemple : Bearer \{\{API Key}}.
</ParamField>

## Corps de la requête

<ParamField body="model" type="enum" required={true}>
  Nom du modèle. Valeurs disponibles : `ming-image-0.1-design`
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Description textuelle de l’image.
</ParamField>

<ParamField body="output_format" type="string" default="png" required={false}>
  Format de l’image de sortie. Doit être `png` ou `jpeg`.
</ParamField>

<ParamField body="response_format" type="string" default="b64_json" required={false}>
  Format dans lequel l’image est renvoyée ; la valeur par défaut est `b64_json`. Valeurs disponibles : `url`, `b64_json`. Remarque : `url` est valide pendant 24 heures.
</ParamField>

<ParamField body="size" type="string" default="auto" required={false}>
  Taille de l’image de sortie. La valeur par défaut `auto` sélectionne automatiquement la taille selon le modèle. Format : `"{w}x{h}"`, par exemple `"1024x1024"`.

  `ming-image-0.1-design` prend uniquement en charge les tailles de 1k et plus, par exemple `"1024x1024"`, `"2048x2048"`.
</ParamField>

<ParamField body="watermark" type="boolean" default={false} required={false}>
  Détermine si un filigrane est ajouté à l’image générée par IA. `true` : active le filigrane visible et le filigrane numérique implicite sur les images générées par IA, conformément aux exigences des politiques applicables. `false` : désactive tous les filigranes.
</ParamField>

## Réponse

<ResponseField name="created" type="integer" required={true}>
  Horodatage Unix (en secondes) de la création de la réponse.
</ResponseField>

<ResponseField name="data" type="array" required={true}>
  Tableau des images renvoyées ; chaque élément contient les informations d’une image générée.

  <Expandable title="propriétés">
    <ResponseField name="b64_json" type="string">
      Données de l’image générée encodées en base64.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="output_format" type="string" required={true}>
  Format réel de l’image de sortie, par exemple `png`, `jpeg`.
</ResponseField>

<ResponseField name="size" type="string">
  `null`
</ResponseField>

<ResponseField name="usage" type="object" required={true}>
  Statistiques d’utilisation des tokens.

  <Expandable title="propriétés">
    <ResponseField name="input_tokens" type="integer">
      Nombre total de tokens d’entrée (0 pour la génération d’images à partir de texte).
    </ResponseField>

    <ResponseField name="input_tokens_details" type="object">
      Détails des tokens d’entrée.

      <Expandable title="propriétés">
        <ResponseField name="image_tokens" type="integer">
          Nombre de tokens d’image en entrée (0 pour la génération d’images à partir de texte).
        </ResponseField>

        <ResponseField name="text_tokens" type="integer">
          Nombre de tokens de texte en entrée.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="output_tokens" type="integer">
      Nombre total de tokens de sortie (c’est-à-dire les tokens consommés par l’image générée).
    </ResponseField>

    <ResponseField name="total_tokens" type="integer">
      Somme des tokens d’entrée et de sortie.
    </ResponseField>

    <ResponseField name="output_tokens_details" type="object">
      Détails des tokens de sortie.

      <Expandable title="propriétés">
        <ResponseField name="image_tokens" type="integer">
          Nombre de tokens d’image en sortie.
        </ResponseField>

        <ResponseField name="text_tokens" type="integer">
          Nombre de tokens de texte en sortie.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="model" type="string" required={true}>
  Nom du modèle qui a effectivement traité la requête.
</ResponseField>

<ResponseField name="id" type="string" required={true}>
  Identifiant unique de cette requête.
</ResponseField>

## Exemple

`Requête :`

```bash theme={"system"}
curl --location --request POST 'https://api.novita.ai/v1/images/generations' \
--header 'Authorization: Bearer {{API Key}}' \
--header 'content-type: application/json' \
--data-raw '{
  "model": "ming-image-0.1-design",
  "prompt": "Generate a banana"
}'
```

`Réponse :`

```js theme={"system"}
{
  "created": 1789642354,
  "data": [
    {
      "b64_json": "..."
    }
  ],
  "output_format": "png",
  "size": null,
  "usage": {
    "input_tokens": 0,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 0
    },
    "output_tokens": 16384,
    "total_tokens": 16384,
    "output_tokens_details": {
      "image_tokens": 16384,
      "text_tokens": 0
    }
  },
  "model": "Ming-Image-0.1-Design-StressTest",
  "id": "2180534417896423312485570e8523"
}
```