TokenLab
Obtenir une clé API
DocumentationRéférence APIIntégrations

Images

Créer une variation d'image

Crée une variation d'une image donnée

POST
/v1/images/variations

Aperçu

Cet endpoint est conservé pour les clients legacy de variations compatibles OpenAI. Ce n’est pas le chemin recommandé pour les workflows image-to-image actuels ; utilisez /v1/images/edits avec gpt-image-2 ou /v1/images/generations avec un modèle image-to-image comme nano-banana-pro lorsque possible. Requiert multipart/form-data.

Corps de la requête

Timeout des requêtes synchrones : certains fournisseurs d’images routés renvoient l’image finale inline et attendent la fin de la génération. Les requêtes haute résolution ou haute qualité peuvent prendre près d’une minute, voire plus ; configurez donc le timeout de votre client HTTP à au moins 120s. Si la réponse de création contient status: "pending", task_id ou poll_url, suivez plutôt le poll_url renvoyé.

imagefilerequis

Image source multipart. Le fichier et le corps complet de la requête doivent chacun rester dans la limite de 50 MiB. Les formats et dimensions dépendent du modèle ; ses détails actuels doivent mentionner explicitement /v1/images/variations.

modelstringrequis

Identifiant de modèle obligatoire pour les routes legacy compatibles avec les variations. Il n’y a pas de valeur par défaut implicite ; pour les workflows image-to-image actuels, préférez /v1/images/edits ou /v1/images/generations avec un modèle actuel.

nintegerpar défaut: 1

Nombre d’images à générer (1-10, selon le modèle).

sizestring

Taille des images générées pour les routes legacy compatibles avec les variations. Les valeurs prises en charge dépendent du modèle sélectionné.

response_formatstring

Le format de retour des images générées. Doit être url ou b64_json.

userstring

Identifiant unique représentant votre utilisateur final pour la surveillance des abus.

Réponse

createdinteger

Horodatage Unix de la création des images.

dataarray

Tableau des variations d'images générées.

Chaque objet contient :

  • url (string) : URL de l'image de variation (si response_format est url)
  • b64_json (string) : Image encodée en Base64 (si response_format est b64_json)

Requête

curl -X POST "https://api.tokenlab.sh/v1/images/variations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=your-legacy-variation-model" \
  -F "image=@cat.png" \
  -F "n=2" \
  -F "size=1024x1024"

Réponse

Réponse
{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}

Notes

Il s’agit d’un endpoint de compatibilité legacy. Il n’est pas inclus dans le catalogue actuel des modèles image recommandés. Pour les nouvelles intégrations, utilisez /v1/images/edits avec gpt-image-2, ou /v1/images/generations avec operation: "image-to-image" et un modèle image-to-image actuel.

Autorisation

BearerAuth
AuthorizationBearer <token>

Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.

Emplacement: header

En-têtes

X-TokenLab-Delivery-Policy?string

Politique de livraison par requête. Remplace les valeurs par défaut de la clé API et de l'espace de travail. Tente automatiquement TokenLab Verified en premier et peut basculer une fois vers Official uniquement avant la sortie, l'acceptation de la requête ou la création de ressource persistante.

Valeurs possibles

  • "auto"
  • "verified"
  • "official"

Corps de la requête

multipart/form-data

Réponse

application/json

application/json

application/json

application/json

application/json

application/json

Modifier une image

Précédent

Obtenir le statut de l'image

Suivant