Documentation de l'API du Générateur de Texte Alternatif IA - Générez Automatiquement du Texte Alternatif pour les Images

Aperçu

L'API du Générateur de Texte Alternatif IA est un service puissant conçu pour générer automatiquement du texte alternatif descriptif pour les images. En s'appuyant sur une IA avancée, cette API analyse vos images et crée un texte alternatif pertinent et contextuel, ce qui est crucial pour l'accessibilité et le SEO. Utiliser un générateur de texte alternatif pour images comme celui-ci garantit que votre contenu visuel est compréhensible par les moteurs de recherche. Cela vous fait également gagner des heures de travail manuel et augmente votre productivité.

Scénarios d'Application

L'API du Générateur de Texte Alternatif IA est idéale pour diverses applications où la génération de texte alternatif pour les images est essentielle :

• Accessibilité Web : Générez automatiquement du texte alternatif pour rendre votre site web conforme aux normes d'accessibilité, offrant une meilleure expérience à tous les utilisateurs.
• Optimisation SEO : Améliorez le classement de votre site web dans les moteurs de recherche en fournissant un texte alternatif descriptif pour les images, aidant ainsi les moteurs de recherche à comprendre votre contenu visuel.
• Systèmes de Gestion de Contenu (CMS) : Intégrez l'API pour générer automatiquement du texte alternatif lors du téléversement d'images, économisant du temps et garantissant la cohérence.
• Plateformes E-commerce : Améliorez les fiches produits avec un texte alternatif descriptif, optimisant à la fois le SEO et l'expérience d'achat pour les utilisateurs malvoyants.
• Blogs et Sites d'Information : Ajoutez automatiquement du texte alternatif aux images éditoriales, améliorant l'accessibilité et la visibilité dans les recherches.

Clés d'API

Pour accéder à l'API du Générateur de Texte Alternatif IA, vous devez d'abord obtenir une clé d'API valide. Cette clé est utilisée pour authentifier vos requêtes et garantir un accès sécurisé à l'API.

Obtenir une Clé d'API

1. Accédez à la Page de Gestion des Clés d'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 "Demander une API" pour ouvrir la Page de Gestion des Clés d'API.

2. Créez une Nouvelle Clé : Cliquez sur "Créer une nouvelle clé", entrez un nom pour votre clé dans la boîte de dialogue, puis cliquez sur "Créer".

3. Copiez et Conservez Votre Clé : Notez que la clé ne sera affichée en entier qu'une seule fois. Cliquez sur l'icône de copie pour copier la clé dans votre presse-papiers, puis cliquez sur "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 empêcher tout accès non autorisé.

Point d'Accès de l'API (Endpoint)

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

Paramètres de la Requête

En-têtes de la Requête

Corps de la Requête

L'API du Générateur de Texte Alternatif IA accepte la structure de requête suivante :

{
  "image": "data:image/jpeg;base64,{image_base64_data}",
  "lang": "fr"
}

Langues Prises en Charge

Exemple de Requête (cURL)

curl --location 'https://api.imagedescriber.app/api/v1/generate_alt_text' \
--header 'content-type: application/json' \
--header 'authorization: Bearer votre_clé_api' \
--data '{
    "image":"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQE...",
    "lang":"fr"
}'

Exemple de Requête (Python)

import requests
import base64

def image_to_base64(image_path):
    """Convertit 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_alt_text(api_key, image_path, lang="fr"):
    """Génère du texte alternatif pour une image en utilisant l'API du Générateur de Texte Alternatif IA"""
    url = "https://api.imagedescriber.app/api/v1/generate_alt_text"
    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}",
        "lang": lang
    }

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

    if response.status_code == 200:
        result = response.json()
        alt_text_data = result["data"]["alt_text"]
        print("Description Générée :", alt_text_data["description"])
        print("Textes Alternatifs Générés :", alt_text_data["alt"])
        print("Crédits Restants :", result["data"]["credits"]["remaining"])
    else:
        print(f"Erreur : {response.status_code}")
        print(response.text)

# Exemple d'utilisation
api_key = "votre_clé_api"
image_path = "votre_image.jpg"

generate_alt_text(api_key, image_path)

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 input ou d'un événement de dépôt */;
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,
  "lang": "fr"
};

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

const result = await response.json();
console.log('Description Générée :', result.data.alt_text.description);
console.log('Textes Alternatifs Générés :', result.data.alt_text.alt);

Réponse

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

Le générateur de texte alternatif pour images retourne une réponse contenant une description détaillée et un tableau d'options de texte alternatif.

{
  "code": 0,
  "message": "success",
  "request_id": "unique_request_id_string",
  "data": {
    "alt_text": {
      "description": "Description détaillée de l'image",
      "alt": [
        "alt1",
        "alt2",
        "..."
      ]
    },
    "credits": {
      "amount": "crédits consommés par cet appel",
      "remaining": "crédits totaux restants après cet appel"
    }
  }
}

Limites de Requêtes

Pour garantir la stabilité et l'équité du service, chaque clé d'API est limitée à 30 requêtes par minute (1800 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 pour générer du texte alternatif pour les images 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 Rechargement de Crédits pour acheter des packs de crédits afin de supporter plus d'appels API. Nous proposons divers packs pour répondre aux besoins de différents utilisateurs.

Gestion des Erreurs

Le tableau suivant liste les codes d'erreur courants, leur signification et les solutions :

Cas d'Utilisation et Exemples d'Intégration

Amélioration du SEO

Utilisez l'API du Générateur de Texte Alternatif IA pour générer automatiquement du texte alternatif pour les images de votre site web :

// Améliorer le SEO des images avec du texte alternatif généré par IA
const enhanceImageSEO = async (imageElement, apiKey) => {
  const canvas = document.createElement('canvas');
  const ctx = canvas.getContext('2d');
  canvas.width = imageElement.width;
  canvas.height = imageElement.height;
  ctx.drawImage(imageElement, 0, 0);

  const base64Image = canvas.toDataURL('image/jpeg');

  const response = await fetch('/api/v1/generate_alt_text', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${apiKey}`
    },
    body: JSON.stringify({ image: base64Image })
  });

  const result = await response.json();
  const { alt } = result.data.alt_text;

  // Mettre à jour l'attribut alt de l'image pour le SEO et l'accessibilité
  if (alt && alt.length > 0) {
    imageElement.alt = alt[0];
  }
};

Intégration à un Système de Gestion de Contenu

Intégrez le générateur de texte alternatif pour images dans votre flux de travail CMS :

# Traiter en masse des images dans un système de gestion de contenu
import os
import requests
from pathlib import Path

def bulk_generate_alt_text(directory_path, api_key):
    """Traite toutes les images d'un répertoire pour générer du texte alternatif"""
    image_extensions = ['.jpg', '.jpeg', '.png', '.webp']

    for image_path in Path(directory_path).iterdir():
        if image_path.suffix.lower() in image_extensions:
            try:
                # Générer du texte alternatif pour chaque image
                result = generate_alt_text(api_key, str(image_path))

                # Enregistrer les métadonnées dans un fichier associé
                metadata_path = image_path.with_suffix('.json')
                with open(metadata_path, 'w') as f:
                    json.dump(result['data']['alt_text'], f, indent=2)

                print(f"Traité : {image_path.name}")

            except Exception as e:
                print(f"Erreur lors du traitement de {image_path.name}: {e}")

# Utilisation
bulk_generate_alt_text("/chemin/vers/les/images", "votre_clé_api")

Nous Contacter

Si vous avez des questions ou des suggestions concernant notre API du Générateur de Texte Alternatif IA, n'hésitez pas à nous contacter par les moyens suivants :

• E-mail : [email protected]
• Support Technique : équipe de support client
• Discord : Rejoignez notre communauté Discord

Commencez à utiliser l'API du Générateur de Texte Alternatif IA dès maintenant et libérez le potentiel de l'accessibilité et du SEO automatisés des images !