Modification d’image en JSON

Modifiez une ou plusieurs images Grok à partir de leurs URL, dans une requête JSON.

La requête utilise application/json. Soumettez une tâche de modification d’une ou plusieurs images à partir d’URL d’images accessibles publiquement.

POST/v1/images/edits

Modifiez une ou plusieurs images de référence à partir d’instructions textuelles. La requête doit utiliser application/json et fournir des URL d’images publiquement accessibles dans image ou images.

Cette structure de requête avec des URL en JSON s’applique uniquement aux modèles prenant en charge la modification d’images Grok.

Utilisez /v1/images/edits, et non /v1/edits. Pour plusieurs images de référence, utilisez images ; reference_images n’est pas recommandé.

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez Bearer your-api-key dans le Header Authorization.

Emplacement: header

Corps de requête

application/json

Paramètres de requête de modification d’images Grok. Fournissez au moins l’un des champs image ou images.

Définitions TypeScript

Utilisez le type request body en TypeScript.

model*string

Identifiant du modèle de modification d’images. Les modèles prenant en charge ce format de requête comprennent grok-imagine-image et grok-imagine-image-pro ; la disponibilité réelle dépend de la liste des modèles renvoyée pour votre clé API et des capacités du canal.

Longueur1 <= length

prompt*string

Instructions de modification de l’image. Précisez le sujet à conserver, les zones à modifier et le style souhaité.

Longueur1 <= length

image?|

Requis sous condition. Image d’entrée unique ; fournissez de préférence une URL publique accessible à la fois au serveur et au fournisseur du modèle. Fournissez au moins l’un des champs image ou images ; ils ne peuvent pas être tous deux absents.

images?array<>

Requis sous condition. Liste d’URL publiques pour plusieurs images d’entrée. Fournissez au moins l’un des champs image ou images ; ils ne peuvent pas être tous deux absents.

Éléments1 <= items

size?string

Dimensions ou rapport largeur/hauteur de l’image, par exemple 1024x1024, 1:1 ou 16:9.

n?integer

Nombre de résultats de modification à générer. Si le champ est absent, une image est généralement produite.

Plage1 <= value

Valeur par défaut1

response_format?string

Format de réponse, déterminé par les capacités réelles du serveur et du modèle fournisseur.

Corps de réponse

`application/json`

curl -X POST "https://example.com/v1/images/edits" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "Transformez l’image en scène nocturne cyberpunk tout en conservant le personnage principal",    "image": "https://example.com/input.png",    "size": "1024x1024",    "n": 1  }'

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

Modification d’image en JSON

Authentification

Corps de requête

Corps de réponse

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`