TokenLab

Images

Créer une variation d'image

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

POST
/v1/images/variations

Vue d'ensemble

Cet endpoint prend en charge les clients OpenAI Variations existants. Pour les nouvelles fonctionnalités image-to-image, utilisez /v1/images/edits ou /v1/images/generations avec un modèle image-to-image actuel. Les requêtes utilisent multipart/form-data.

Corps de la requête

Cet endpoint est synchrone : la réponse contient l'image finale et jamais une tâche. Définissez le timeout de votre client HTTP sur au moins 120s.

imagefilerequis

Image source multipart. Le fichier et le corps complet de la requête doivent chacun faire moins de 50 MiB (les téléversements plus volumineux renvoient 413). Les formats et dimensions pris en charge dépendent du modèle sélectionné. Seul un modèle dont les détails associent image-to-image à /v1/images/variations est accepté ; tout autre modèle renvoie 400.

modelstringrequis

ID du modèle. Cet endpoint n'a pas de modèle par défaut. Les exemples utilisent l'espace réservé your-legacy-variation-model : remplacez-le par un modèle dont les détails répertorient cet endpoint.

nintegerpar défaut: 1

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

sizestring

Taille de l'image générée. Les valeurs prises en charge dépendent du modèle sélectionné.

response_formatstring

Le format dans lequel les images générées sont retournées. Doit être url ou b64_json.

userstring

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

Réponse

createdinteger

Horodatage Unix indiquant le moment où les images ont été créées.

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

Response
{
  "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 de modèles d'images 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

application/json

application/json