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

# Agrandissement d'image

> Améliorez et agrandissez des images avec l'API synchrone d'agrandissement d'image de Venice en utilisant une entrée en base64 et une sortie image binaire.

L'agrandissement d'image améliore la résolution et la qualité visuelle d'une image existante. Envoyez une image encodée en base64 à `/image/upscale`, choisissez un facteur d'échelle, et Venice retourne l'image améliorée sous forme de données binaires.

Utilisez l'agrandissement d'image lorsque vous disposez déjà d'une image et souhaitez obtenir une sortie de plus haute résolution. Utilisez la [génération d'image](/guides/media/image-generation) lorsque vous devez créer une image à partir d'une invite, et l'[édition d'image](/guides/media/image-editing) lorsque vous devez modifier le contenu de l'image.

## Utilisation de base

<CodeGroup>
  ```python Python theme={"system"}
  import base64
  import os
  from pathlib import Path

  import requests

  image_base64 = base64.b64encode(Path("input.jpg").read_bytes()).decode("utf-8")

  response = requests.post(
      "https://api.venice.ai/api/v1/image/upscale",
      headers={
          "Authorization": f"Bearer {os.environ['VENICE_API_KEY']}",
          "Content-Type": "application/json",
      },
      json={
          "image": image_base64,
          "scale": 2,
      },
  )

  response.raise_for_status()
  Path("upscaled.png").write_bytes(response.content)
  ```

  ```javascript Node.js theme={"system"}
  import { readFile, writeFile } from "node:fs/promises";

  const image = await readFile("input.jpg");

  const response = await fetch("https://api.venice.ai/api/v1/image/upscale", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.VENICE_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      image: image.toString("base64"),
      scale: 2,
    }),
  });

  if (!response.ok) {
    throw new Error(await response.text());
  }

  const output = Buffer.from(await response.arrayBuffer());
  await writeFile("upscaled.png", output);
  ```

  ```bash cURL theme={"system"}
  IMAGE_BASE64=$(base64 < input.jpg | tr -d '\n')

  curl https://api.venice.ai/api/v1/image/upscale \
    -H "Authorization: Bearer $VENICE_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{
      \"image\": \"$IMAGE_BASE64\",
      \"scale\": 2
    }" \
    --output upscaled.png
  ```
</CodeGroup>

## Paramètres

| Paramètre | Type   | Requis | Description                                                                                                                    |
| --------- | ------ | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| `image`   | string | Oui    | Image source encodée en base64.                                                                                                |
| `scale`   | number | Non    | Facteur d'agrandissement. Utilisez les valeurs prises en charge listées dans la référence de l'API et le catalogue de modèles. |

<Note>
  La réponse est constituée de données d'image binaires, et non de JSON. Écrivez le corps de la réponse directement dans un fichier ou envoyez-le en flux vers le stockage.
</Note>

## Conseils sur l'entrée

* Commencez avec l'image source la plus nette dont vous disposez. L'agrandissement améliore les détails, mais ne peut pas récupérer entièrement les informations absentes.
* Utilisez des facteurs d'échelle modérés pour les flux de production. Des sorties très grandes peuvent augmenter la latence et la taille des fichiers.
* Conservez l'image originale si vous devez comparer la qualité ou réessayer avec d'autres paramètres.

## Ressources connexes

* [API Image Upscale](/api-reference/endpoint/image/upscale)
* [Modèles d'image](/models/image)
* [Guide d'édition d'image](/guides/media/image-editing)