Référence API

Génération et modification d'images

Générez ou modifiez des images avec des API d'images compatibles OpenAI.

Les API d'images prennent en charge la génération et la modification. Les tailles exactes, les valeurs de qualité, les formats et la prise en charge du streaming dépendent du modèle et du canal en amont.

Points de terminaison

MéthodeCheminDescription
POST/v1/images/generationsGénérer des images
POST/v1/images/editsModifier des images, avec une entrée JSON ou de formulaire multipart
POST/v1/editsChemin de compatibilité. Préférez /v1/images/edits

Champs de la requête

ChampTypeRequisDescription
modelstringOuiID du modèle d'image
promptstringRequis pour la générationPrompt de l'image
nintegerNonNombre d'images, 1 par défaut
sizestringNonTaille de l'image, par exemple 1024x1024. N'utilisez pas le signe de multiplication ×
qualitystringNonQualité, par exemple standard, hd ou auto
response_formatstringNonFormat de réponse, par exemple url ou b64_json, selon le modèle
styleanyNonChamp d'extension d'image OpenAI
background, moderationanyNonChamps d'extension des modèles d'image plus récents
output_format, output_compressionanyNonOptions de format de sortie et de compression
partial_images, streamanyNonUtilisé par les modèles d'image prenant en charge le streaming
image, imagesfile/string/arrayRequis pour les modificationsImages à modifier. Le multipart accepte image, image[] ou image[n]
maskfile/stringNonMasque de modification
input_fidelityanyNonFidélité d'entrée, selon le modèle
watermarkbooleanNonFiligrane, selon la prise en charge du canal

Générer une image

curl https://api.tensoraxis.ai/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A minimalist poster of a futuristic city",
    "size": "1024x1024"
  }'

Modifier une image

Utilisez des données de formulaire multipart lors du téléchargement de fichiers locaux :

curl https://api.tensoraxis.ai/v1/images/edits \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -F model="gpt-image-1" \
  -F prompt="Change the background to a night city" \
  -F image="@input.png"

Lorsque le modèle sélectionné le prend en charge, des URL d'images JSON peuvent également être utilisées :

{
  "model": "gpt-image-1",
  "prompt": "Change the background to a night city",
  "image": "https://example.com/input.png"
}

Forme de la réponse

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

La génération vidéo n'est pas une API d'images. Pour les modèles vidéo Seedance / Doubao, utilisez le corps de tâche asynchrone dans Génération vidéo.