Images
Créer une variation d'image
Crée une variation d'une image donnée
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.
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.
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.
1Nombre d'images à générer (1 à 10, selon le modèle).
Taille de l'image générée. Les valeurs prises en charge dépendent du modèle sélectionné.
Le format dans lequel les images générées sont retournées. Doit être url ou b64_json.
Un identifiant unique représentant votre utilisateur final pour la surveillance des abus.
Réponse
Horodatage Unix indiquant le moment où les images ont été créées.
Tableau des variations d'images générées.
Chaque objet contient :
url(string) : URL de l'image de variation (si response_format esturl)b64_json(string) : Image encodée en Base64 (si response_format estb64_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
{
"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 Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.
Emplacement: header
En-têtes
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