Créer une image

Cette API réutilise le chemin OpenAI Images Generations et prend en charge des paramètres propres à Grok, tels que aspect_ratio et resolution.

POST/v1/images/generations

Créez une ou plusieurs images à partir d’un prompt textuel. Cette API réutilise l’endpoint POST /v1/images/generations au format OpenAI et ajoute les paramètres de rapport largeur/hauteur et de résolution utilisés par les modèles d’image Grok.

Les exemples d’identifiants de modèle comprennent grok-imagine-image-pro et grok-imagine-image. Avant l’appel, vérifiez les identifiants réellement disponibles dans la liste des modèles accessible avec votre clé API.

Une requête peut générer jusqu’à 10 images ; les URL renvoyées sont temporaires et doivent être téléchargées ou traitées rapidement. Le contenu généré peut être filtré selon la politique de contenu ; les images de sortie sont généralement au format JPG.

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 génération d’images Grok.

Définitions TypeScript

Utilisez le type request body en TypeScript.

model*string

Identifiant du modèle de génération d’images. Exemples :

grok-imagine-image-pro : modèle d’image avancé, adapté aux scènes détaillées et de haute qualité.
grok-imagine-image : modèle généraliste de génération d’images.

Les modèles réellement disponibles sont ceux renvoyés dans la liste accessible avec votre clé API.

Longueur1 <= length

prompt*string

Description textuelle de l’image souhaitée.

Longueur1 <= length

n?integer

Nombre d’images à générer, de 1 à 10.

Plage1 <= value <= 10

Valeur par défaut1

response_format?string

Format de retour des images générées. url renvoie une URL temporaire à télécharger ou traiter rapidement ; b64_json renvoie les données d’image encodées en Base64.

Valeur par défaut"url"

Valeurs autorisées

"url"
"b64_json"

aspect_ratio?string

Rapport largeur/hauteur de l’image générée. Si ce champ est absent, le modèle le choisit automatiquement. Exemples de valeurs courantes :

1:1
16:9, 9:16
4:3, 3:4
3:2, 2:3
2:1, 1:2
19.5:9, 9:19.5
20:9, 9:20
auto

Ces valeurs sont des exemples courants, et non une énumération fermée.

resolution?string

Résolution de sortie de l’image générée ; prend en charge 1k et 2k.

Valeurs autorisées

"1k"
"2k"

user?string

Identifiant unique de l’utilisateur final, utilisable pour la surveillance et la gestion des risques.

Longueur1 <= length

Corps de réponse

`application/json`

curl -X POST "https://example.com/v1/images/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "A cat in a tree",    "n": 1,    "response_format": "url"  }'

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://example.com/generated-image-1.jpg"
    },
    {
      "url": "https://example.com/generated-image-2.jpg"
    }
  ]
}

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`