Modifier une image

Téléverser des images de référence et les modifier à l’aide d’un prompt.

POST/v1/images/edits

Téléverser des images de référence et les modifier à l’aide d’un prompt.

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez une clé API de la plateforme au format Authorization: Bearer your-api-key.

Emplacement: header

Corps de requête

multipart/form-data

Définitions TypeScript

Utilisez le type request body en TypeScript.

model*string

ID du modèle de la plateforme.

prompt*string

Instruction de modification ; l’enrichissement du prompt est toujours actif. Comptée en caractères Unicode sans les espaces de début et de fin ; ne peut pas être vide.

Longueur1 <= length <= 32000

n?integer

Nombre d’images à générer.

Plage1 <= value <= 10

Valeur par défaut1

size?string

auto ou WIDTHxHEIGHT, auto par défaut. Surface personnalisée : 655,360–20,000,000 pixels ; rapport : 1:3–3:1. Omettre aspect_ratio et area si les dimensions sont précisées.

Valeur par défaut"auto"

aspect_ratio?string

auto par défaut, déterminé par le prompt enrichi et les images de référence lors d’une modification. Accepte aussi X:Y, avec X et Y entiers de 1–300 et un rapport de 1:3–3:1. Uniquement si size est omis ou vaut auto.

area?string

Palier de surface, 4K par défaut. Uniquement si size est omis ou vaut auto ; dimensions réelles dans data[].size.

Valeurs autorisées

"1K"
"2K"
"4K"

output_format?string

Format d’image. jpg et jpeg sont équivalents ; la réponse utilise jpeg.

Valeur par défaut"jpeg"

Valeurs autorisées

"jpeg"
"jpg"
"png"
"webp"

response_format?string

Les liens url expirent après 24 heures ; b64_json renvoie du Base64 sans streaming. La surface totale de sortie Base64 est limitée à 20,000,000 pixels pour PNG et 80,000,000 pixels pour JPEG/WebP, toutes images confondues.

Valeur par défaut"url"

Valeurs autorisées

"url"
"b64_json"

output_compression?integer

Qualité de compression JPEG/WebP ; une valeur élevée augmente la taille du fichier. Ignorée pour PNG.

Plage0 <= value <= 100

Valeur par défaut95

stream?boolean

Renvoyer chaque image via SSE ; uniquement avec response_format à url.

Valeur par défautfalse

aigc_watermark?boolean

Ajouter un filigrane AIGC visible ; sans effet sur l’identifiant implicite des métadonnées du fichier.

Valeur par défautfalse

image*array<>

1–16 images de référence. Formats JPG, JPEG, PNG, WEBP, HEIC, HEIF. Chaque image et le corps complet de la requête ne doivent pas dépasser 64 MiB chacun ; côtés de 128–8192 pixels ; rapport grand côté/petit côté au plus 4:1. Le codage Base64 compte dans la taille du corps. Un champ image par fichier, ou image[] pour plusieurs fichiers ; l’ordre d’envoi détermine les numéros des images.

Éléments1 <= items <= 16

Références d’image JSON

Les requêtes JSON transmettent les références dans un tableau d’objets images ; les autres champs sont identiques à l’envoi de fichiers.

Champ Représentation JSON

Champ	Représentation JSON
`images[].image_url`	Obligatoire. Accepte les URL publiques, les Base64 Data URL ou mm_file://{file_id}. Remplacer l’URL d’exemple par l’adresse de l’image générée et enregistrée. Obligatoire. Accepte les URL publiques, les Base64 Data URL ou mm_file://{file_id}. Remplacer l’URL d’exemple par l’adresse de l’image générée et enregistrée.

images[].image_url

Obligatoire. Accepte les URL publiques, les Base64 Data URL ou mm_file://{file_id}. Remplacer l’URL d’exemple par l’adresse de l’image générée et enregistrée.

Corps de réponse

`application/json`

type*string

created?integer

Horodatage Unix de l’événement.

model?string

ID du modèle réellement utilisé.

image_index*integer

Indice d’image commençant à 0.

Plage0 <= value

url*string

Lien temporaire de l’image générée.

size?string

Dimensions réelles WIDTHxHEIGHT.

output_format?string

Format réel de sortie.

Valeurs autorisées

"jpeg"
"png"
"webp"

revised_prompt?string

Prompt utilisé pour cette image.

curl -X POST "https://api.agtcloud.ai/v1/images/edits" \
  -H "Authorization: Bearer your-api-key" \
  -F model="MODEL_ID" \
  -F prompt="Remplace l’abat-jour vert de la lampe par du blanc cassé, en conservant la table en bois, le fond, la lumière et la composition." \
  -F size="2048x2048" \
  -F n="1" \
  -F response_format="url" \
  -F image="@/path/to/lamp.png"

{
  "created": 1794355200,
  "data": [
    {
      "url": "https://example.com/lamp-result.jpg",
      "size": "2048x2048",
      "revised_prompt": "Une lampe de bureau verte repose sur une table en bois devant un mur clair ; une lumière naturelle douce éclaire l’abat-jour et le plateau."
    }
  ],
  "output_format": "jpeg",
  "request_id": "REQUEST_ID"
}

Définissez un délai client d’au moins 600 secondes. La génération peut continuer après un délai dépassé ou une déconnexion ; un nouvel envoi crée une nouvelle requête.

API de modification d’images MiniMaxConsulter les paramètres et la structure des réponses.

Authentification

Corps de requête

Références d’image JSON

Corps de réponse

200application/json

400application/json

401application/json

402application/json

422application/json

429application/json

Événements de réponse en streaming

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`