Créer / modifier des images

POST/v1/images/generations

Générez une image à partir d’une consigne, ou fournissez des références dans image au sein de la même requête JSON pour les modifier.

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez une clé API de la plateforme.

Emplacement: header

Corps de requête

application/json

Définitions TypeScript

Utilisez le type request body en TypeScript.

model*string

ID du modèle sur la plateforme.

prompt?string

Instructions de génération ou de modification. Facultatives uniquement pour la décomposition en calques.

Longueur1 <= length

image?|array<>

Images de référence. Omettez ce champ pour la génération à partir de texte. Chaque image doit peser au plus 30 MB. Consultez la page des différences pour les limites de quantité. La décomposition accepte une seule image.

size?string

Préréglage de résolution ou WIDTHxHEIGHT. Voir les valeurs et défauts sur la page des différences.

optimize_prompt_options?

output_format?string

Format de fichier. Pour la décomposition, il concerne seulement l’image de base. Les calques sont toujours en PNG.

Valeur par défaut"jpeg"

Valeurs autorisées

"png"
"jpeg"

background?string

Le mode transparent nécessite une seule image avec canal alpha et produit un PNG.

Valeur par défaut"opaque"

Valeurs autorisées

"opaque"
"transparent"

response_format?string

Renvoie des URL d’images ou des données Base64.

Valeur par défaut"url"

Valeurs autorisées

"url"
"b64_json"

watermark?boolean

Ajouter ou non un filigrane de génération par IA.

Valeur par défauttrue

layer_decomposition?boolean

Décompose une image en image de base et calques indépendants. Selon le modèle.

Valeur par défautfalse

sequential_image_generation?string

Mode série d’images. Avec auto, le modèle décide de produire une série.

Valeur par défaut"disabled"

Valeurs autorisées

"disabled"
"auto"

sequential_image_generation_options?

stream?boolean

Renvoie les images générées une par une. Selon le modèle.

Valeur par défautfalse

tools?array<>

Outil de recherche Web. Selon le modèle.

Corps de réponse

`application/json`

type*string

model?string

ID du modèle effectivement utilisé.

created?integer

Horodatage Unix en secondes.

Plage0 <= value

image_index*integer

Indice d’image commençant à 0.

Plage0 <= value

url?string

URL temporaire de téléchargement. Enregistrez l’image sous 24 heures.

Formaturi

b64_json?string

Données Base64 de l’image.

size?string

Dimensions réelles au format WIDTHxHEIGHT.

curl -X POST "https://example.com/v1/images/generations" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "Créez une photo d’une tasse blanche sur un bureau en bois, éclairée doucement par une fenêtre à gauche."
  }'

{
  "created": 1793980674,
  "data": [
    {
      "url": "https://example.com/result.jpeg"
    }
  ]
}

Remplacez l’URL de l’exemple de modification par celle de l’image créée à l’étape précédente. Pour Base64, remplacez BASE64_BYTES par les données réelles et conservez le préfixe Data URL correspondant au format.

API de génération d’images VolcengineChamps, réponses et guides des fonctionnalités.

Authentification

Corps de requête

Corps de réponse

200application/json

400application/json

401application/json

403application/json

Événements de réponse en streaming

`application/json`

`application/json`

`application/json`