Documentation de l'API Image Describer - Génération de Descriptions d'Images par IA

Aperçu

L'API Image Describer est un outil puissant de génération de descriptions d'images qui produit de manière intelligente des descriptions précises, détaillées et pertinentes d'images en fonction de l'image fournie et de l'invite (prompt). Cette API de reconnaissance d'images basée sur l'IA comprend et analyse le contenu des images, générant des descriptions textuelles correspondantes selon vos invites. Elle est largement applicable à divers scénarios impliquant la compréhension d'images, l'analyse d'images et la génération de contenu d'images, vous permettant de mettre en œuvre facilement la réponse aux questions sur les images et la conversion image-texte.

Scénarios d'Application

L'API Image Describer peut vous aider à réaliser efficacement la compréhension d'images et la génération de contenu dans les domaines suivants :

• Analyse de Graphiques de Données : Interpréter automatiquement les données des graphiques et générer des rapports d'analyse statistique.
• Évaluation d'Œuvres d'Art : Fournir des évaluations et des interprétations professionnelles d'œuvres d'art.
• Génération d'Articles de Blog : Générer des paragraphes ou des articles entiers basés sur des images.
• Reconnaissance d'Objets : Identifier les objets dans les images et fournir des informations détaillées, telles que les noms des objets, leurs attributs et leurs utilisations potentielles.
• Réponse aux Questions sur les Images : Obtenir des informations détaillées sur le contenu d'une image en posant des questions, telles que "Qu'y a-t-il sur cette image ?" ou "Que fait cette personne ?".
• Applications Éducatives : Aider à l'enseignement, par exemple en identifiant des images de plantes et d'animaux, en expliquant des photos historiques, etc.
• E-commerce : Générer automatiquement des descriptions de produits pour enrichir les informations sur les produits.

Clés API

Pour accéder à l'API Image Describer, vous devez d'abord obtenir une clé API valide. Cette clé est utilisée pour authentifier vos requêtes et garantir un accès sécurisé à l'API.

Obtention d'une Clé API

1. Accéder à la Page de Gestion des Clés API : Connectez-vous au système, puis cliquez sur votre avatar d'utilisateur dans le coin supérieur droit. Dans le menu déroulant, cliquez sur "Apply for API" (Demander une API) pour ouvrir la page de gestion des clés API.

2. Créer une Nouvelle Clé : Cliquez sur "Create New Key" (Créer une Nouvelle Clé), saisissez un nom pour votre clé dans la boîte de dialogue contextuelle, puis cliquez sur "Create" (Créer).

3. Copier et Stocker Votre Clé : Notez que la clé ne sera affichée intégralement qu'une seule fois. Cliquez sur l'icône de copie pour copier la clé dans votre presse-papiers, puis cliquez sur "Confirm" (Confirmer) pour fermer la boîte de dialogue.

Important : Ne la partagez pas avec d'autres et ne l'exposez pas dans le navigateur, le code côté client ou tout autre emplacement non sécurisé. Conservez votre clé en lieu sûr pour éviter tout accès non autorisé.

Point de Terminaison de l'API

POST https://api.imagedescriber.app/api/v1/generate_content

Paramètres de la Requête

En-têtes de la Requête

Corps de la Requête

{
  "image": "data:image/jpeg;base64,{données_base64_de_l_image}",
  "prompt": "Quel est cet objet ? Décrivez ses utilisations possibles.",
  "lang": "fr"
}

Langues Supportées

Exemple de Requête (cURL)

curl --location 'https://api.imagedescriber.app/api/v1/generate_content' \
--header 'content-type: application/json' \
--header 'authorization: Bearer votre_clé_api' \
--data '{
    "image":"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQE...", 
    "prompt":"Quel est cet objet ? Décrivez ses utilisations possibles.",
    "lang":"fr"
}'

Exemple de Requête (Python)

import requests
import base64

def image_to_base64(image_path):
  """Convertir une image en encodage Base64"""
  with open(image_path, "rb") as image_file:
    encoded_string = base64.b64encode(image_file.read()).decode("utf-8")
  return encoded_string

def generate_image_description(api_key, image_path, prompt, lang="fr"):
  """Générer une description d'image en utilisant l'API Image Describer"""
  url = "https://api.imagedescriber.app/api/v1/generate_content"
  headers = {
      "content-type": "application/json",
      "authorization": f"Bearer {api_key}"
  }
  
  image_base64_data = image_to_base64(image_path)
  payload = {
      "image": f"data:image/jpeg;base64,{image_base64_data}",
      "prompt": prompt,
      "lang": lang
  }

  response = requests.post(url, headers=headers, json=payload)

  if response.status_code == 200:
      result = response.json()
      print(result["data"]["content"])
  else:
    print(f"Erreur : {response.status_code}")
    print(response.text)

# Exemple d'utilisation
api_key = "votre_clé_api"
image_path = "votre_image.jpg"
prompt = "Quel est cet objet ? Décrivez ses utilisations possibles."

generate_image_description(api_key, image_path, prompt, lang="fr")

Exemple de Requête (Next.js)

import fs from 'fs';

// Implémentation côté serveur
const buffer = await fs.readFileSync("/temp/test.jpg");
const base64Image = buffer.toString('base64');
const imageData = `data:image/jpeg;base64,${base64Image}`;

// Implémentation côté client
const file:File = /* fichier provenant d'un événement d'entrée ou de glisser-déposer */;
const arrayBuffer = await file.arrayBuffer();
const bytes = new Uint8Array(arrayBuffer);
const base64Image = btoa(String.fromCharCode.apply(null, bytes as any));
const imageData = `data:${file.type};base64,${base64Image}`;

const body = {
  "image": imageData,
  "prompt": "Décrivez l'image en détail",
  "lang": "fr"
};

const response = await fetch('https://api.imagedescriber.app/api/v1/generate_content', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer {votre_clé_api}'
    },
    body: JSON.stringify(body),
});

const result = await response.json();
console.log(result);

Réponse

Corps de la Réponse (Réponse JSON)

L'API renvoie désormais la réponse complète dans un seul objet JSON. Le champ content au sein de l'objet data contient la description d'image générée au format Markdown.

{
  "code": 0,
  "message": "success",
  "request_id": "identifiant_de_requête_unique",
  "data": {
    "content": "Contenu généré au format Markdown" 
  }
}

Limites de Requête

Pour assurer la stabilité et l'équité du service, chaque clé API est limitée à 5 requêtes par minute (300 requêtes par heure). Les requêtes dépassant cette limite seront rejetées avec le code d'erreur 1004.

Système de Crédits

• Chaque appel API réussi consomme 1 crédit.
• Le contenu bloqué par le filtre de sécurité ne consomme pas de crédits.
• Les erreurs système ne consomment pas de crédits.

Comment Obtenir Plus de Crédits ?

Vous pouvez visiter la Page de Recharge de Crédits pour acheter des packs de crédits afin de prendre en charge davantage d'appels API. Nous proposons différents packs pour répondre aux besoins des différents utilisateurs.

Gestion des Erreurs

Le tableau suivant répertorie les codes d'erreur courants, leur signification et leurs solutions :

Nous Contacter

Si vous avez des questions ou des suggestions, n'hésitez pas à nous contacter par les moyens suivants :

• Courriel : [email protected]
• Support Technique : équipe de support client

Commencez à utiliser l'API Image Describer dès maintenant et débloquez les possibilités illimitées de la compréhension d'images !