Documentation

API de Description d'Images IA

Décrire le contenu des images en utilisant la technologie IA

L'API de Description d'Images IA vous permet d'utiliser une technologie IA avancée pour décrire le contenu des images. Ce point de terminaison traite les images et renvoie des descriptions textuelles détaillées. Découvrez la puissante fonctionnalité de description d'images IA de AI Describe Picture.

Point de Terminaison

POST /api/api-call/describe-picture

Authentification

Nécessite une clé API valide dans l'en-tête Authorization :

Authorization: Bearer YOUR_API_KEY

Requête

En-têtes

HeaderRequiredDescription
Content-TypeYesDoit être application/json
AuthorizationYesVotre clé API au format Bearer YOUR_API_KEY

Paramètres du Corps

ParameterTypeRequiredDescription
imageUrlstringYesURL de l'image à décrire (doit être publiquement accessible)
promptstringNoInvite personnalisée (optionnel)

Exemple de Requête

{
  "imageUrl": "https://example.com/image.jpg",
  "prompt": "Décrivez en détail tous les éléments, couleurs et composition de cette image"
}

Réponse

Réponse de Succès (200)

L'API renvoie un objet JSON contenant les descriptions d'images avec un tableau choices.

{
  "choices": [
    {
      "logprobs": null,
      "finish_reason": "stop",
      "native_finish_reason": "STOP",
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "L'image représente un gros plan d'un renard roux face à la caméra. Le renard a une fourrure duveteuse orange et blanche, avec des oreilles dressées et des yeux marron brillants. L'arrière-plan est flou, possiblement dans un champ enneigé ou un environnement lumineux.",
        "refusal": null,
        "reasoning": null
      }
    }
  ]
}

Description :

  • Le tableau choices contient le contenu de description généré par l'IA, chaque choice contient un objet message complet
  • Le champ message.content contient le texte de description d'image réel
  • Le format de réponse est compatible avec l'API OpenAI

Réponses d'Erreur

400 Bad Request

{
  "message": "Invalid input"
}

401 Unauthorized

{
  "message": "Invalid or expired API key"
}

402 Payment Required

{
  "message": "Insufficient credits"
}

500 Internal Server Error

{
  "message": "Service error"
}

Limites d'Utilisation

  • Consommation de crédits : 1 crédit par description
  • Exigences d'image : Prend en charge les formats JPG, PNG, WebP, maximum 5MB

Exemples d'Utilisation

JavaScript/Node.js

async function describeImage(imageUrl, apiKey, prompt = null) {
  try {
    const response = await fetch('https://aidescribepicture.com/api/api-call/describe-picture', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${apiKey}`
      },
      body: JSON.stringify({
        imageUrl: imageUrl,
        prompt: prompt
      })
    });
 
    if (!response.ok) {
      const error = await response.text();
      throw new Error(`API Error: ${response.status} - ${error}`);
    }
 
    const result = await response.json();
    
    // Extraire le contenu de description
    const description = result.choices[0].message.content;
    return description;
  } catch (error) {
    console.error('Error describing image:', error);
    throw error;
  }
}
 
// Exemple d'utilisation
const description = await describeImage(
  'https://example.com/image.jpg',
  'your-api-key-here',
  'Décrivez cette image en détail'
);
console.log('Image description:', description);

cURL

curl -X POST https://aidescribepicture.com/api/api-call/describe-picture \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "imageUrl": "https://example.com/image.jpg",
    "prompt": "Décrivez en détail tous les éléments, couleurs et composition de cette image"
  }'

Exigences d'Image

  • Format : JPG, PNG, WebP
  • Taille : Maximum 5MB
  • Accessibilité : L'URL de l'image doit être publiquement accessible
  • Contenu : Doit être un fichier image valide

Temps de Traitement

  • Typique : 10-30 secondes
  • Grandes images : Peut prendre jusqu'à 60 secondes

Crédits

  • Coût : 1 crédit par description
  • Déduction : Les crédits sont déduits après traitement réussi

Bonnes Pratiques

  1. Qualité d'image : Utilisez des images de haute qualité pour de meilleurs résultats
  2. Gestion d'erreur : Implémentez toujours une gestion d'erreur appropriée
  3. Gestion des crédits : Surveillez régulièrement votre solde de crédits
  4. Invites : Utilisez des invites spécifiques pour des descriptions plus précises

Dépannage

Problèmes Courants

401 Unauthorized

  • Vérifiez que votre clé API est correcte
  • Assurez-vous que la clé API est active et non expirée

402 Payment Required

  • Ajoutez des crédits à votre compte
  • Vérifiez votre solde de crédits actuel

400 Bad Request

  • Vérifiez que l'imageUrl est une URL valide et accessible
  • Assurez-vous que le format d'image est pris en charge

500 Internal Server Error

  • Erreur interne du serveur, veuillez réessayer plus tard
  • Vérifiez si l'URL de l'image est accessible

Support

Si vous rencontrez des problèmes non couverts ici, veuillez contacter notre équipe de support.