API-Dokumentation für automatische Bildverschlagwortung – Intelligente Foto-Tagging & Klassifizierung

Übersicht

Die API für automatische Bildverschlagwortung ist ein leistungsstarker Dienst für KI-gestütztes Foto-Tagging, der automatisch intelligente Tags, Titel und Beschreibungen für Bilder generiert. Diese API für KI Bild-Tagging nutzt fortschrittliche Computer-Vision- und maschinelle Lerntechnologien, um Bildinhalte zu analysieren und eine umfassende Metadatengenerierung bereitzustellen. Perfekt für Arbeitsabläufe zur automatischen Bildverschlagwortung, Inhaltsverwaltung und Fotoklassifizierung.

Anwendungsszenarien

Die API für automatische Bildverschlagwortung ermöglicht Ihnen die effiziente Implementierung von KI-gestütztem Foto-Tagging und Metadatengenerierung in den folgenden Bereichen:

• SEO-Optimierung: Automatische Generierung relevanter Tags und Beschreibungen zur Verbesserung der Sichtbarkeit in der Bildersuche.
• Content-Management-Systeme: Optimierung der Organisation digitaler Assets durch intelligente Kategorisierung.
• Automatisierung von sozialen Medien: Automatisches Taggen von Fotos für eine verbesserte Auffindbarkeit und Interaktion.
• E-Commerce-Produktverwaltung: Generierung umfassender Produkt-Tags und -Beschreibungen für eine bessere Durchsuchbarkeit.
• Digitale Medienbibliotheken: Organisation und Klassifizierung großer Bildersammlungen mit automatisierten Metadaten.
• Inhalte für Blogs und Webseiten: Verbesserung der Bild-SEO durch automatisch generierte Alt-Texte und Bildunterschriften.
• Integration in mobile Apps: Hinzufügen von intelligenten Funktionen des Dienstes für Foto-Tagging zu mobilen Anwendungen.

API-Schlüssel

Um auf die API für automatische Bildverschlagwortung zuzugreifen, müssen Sie zunächst einen gültigen API-Schlüssel erhalten. Dieser Schlüssel wird verwendet, um Ihre Anfragen zu authentifizieren und einen sicheren Zugriff auf die API zu gewährleisten.

Erhalt eines API-Schlüssels

1. Greifen Sie auf die Verwaltungsseite für API-Schlüssel zu: Melden Sie sich im System an und klicken Sie dann auf Ihr Benutzer-Avatar in der oberen rechten Ecke. Klicken Sie im Dropdown-Menü auf „API beantragen“, um die Verwaltungsseite für API-Schlüssel zu öffnen.

2. Neuen Schlüssel erstellen: Klicken Sie auf „Neuen Schlüssel erstellen“, geben Sie im Pop-up-Dialog einen Namen für Ihren Schlüssel ein und klicken Sie dann auf „Erstellen“.

3. Kopieren und speichern Sie Ihren Schlüssel: Beachten Sie, dass der Schlüssel nur einmal vollständig angezeigt wird. Klicken Sie auf das Kopieren-Symbol, um den Schlüssel in Ihre Zwischenablage zu kopieren, und klicken Sie dann auf „Bestätigen“, um den Dialog zu schließen.

Wichtig: Teilen Sie ihn nicht mit anderen und legen Sie ihn nicht im Browser, im clientseitigen Code oder an einem anderen unsicheren Ort offen. Bewahren Sie Ihren Schlüssel sicher auf, um unbefugten Zugriff zu verhindern.

API-Endpunkt

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

Anfrageparameter

Anfrage-Header

Anfrage-Body

Die API für KI Bild-Tagging akzeptiert die folgende Anfragestruktur:

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

Unterstützte Sprachen

Anfragebeispiel (cURL)

curl --location 'https://api.imagedescriber.app/api/v1/generate_tags' \
--header 'content-type: application/json' \
--header 'authorization: Bearer ihr_api_schlüssel' \
--data '{
    "image":"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQE...", 
    "lang":"de"
}'

Anfragebeispiel (Python)

import requests
import base64

def image_to_base64(image_path):
    """Bild in Base64-Kodierung umwandeln"""
    with open(image_path, "rb") as image_file:
        encoded_string = base64.b64encode(image_file.read()).decode("utf-8")
    return encoded_string

def generate_image_tags(api_key, image_path, lang="de"):
    """KI-Bild-Tags mit der API für automatische Bildverschlagwortung generieren"""
    url = "https://api.imagedescriber.app/api/v1/generate_tags"
    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()
        tags_data = result["data"]["tags"]
        print("Generierte Tags:", tags_data["tags"])
        print("Titel:", tags_data["title"])
        print("Beschreibung:", tags_data["description"])
        print("Verbleibende Credits:", result["data"]["credits"]["remaining"])
    else:
        print(f"Fehler: {response.status_code}")
        print(response.text)

# Anwendungsbeispiel
api_key = "ihr_api_schlüssel"
image_path = "ihr_bild.jpg"

generate_image_tags(api_key, image_path)

Anfragebeispiel (Next.js)

import fs from 'fs';

// Serverseitige Implementierung
const buffer = await fs.readFileSync("/temp/test.jpg");
const base64Image = buffer.toString('base64');
const imageData = `data:image/jpeg;base64,${base64Image}`;

// Clientseitige Implementierung
const file: File = /* Datei aus einem Input- oder Drop-Ereignis */;
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": "de"
};

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

const result = await response.json();
console.log('KI-generierte Tags:', result.data.tags.tags);
console.log('Generierter Titel:', result.data.tags.title);
console.log('Generierte Beschreibung:', result.data.tags.description);

Antwort

Antwort-Body (JSON-Antwort)

Der Dienst für KI-gestütztes Foto-Tagging gibt eine umfassende Antwort zurück, die generierte Tags, Titel, Beschreibung und Credit-Informationen enthält:

{
  "code": 0,
  "message": "Erfolg",
  "request_id": "eindeutige_anfrage_id_string",
  "data": {
    "tags": {
      "tags": [
        "tag1",
        "tag2",
        ...
      ],
      "title": "Prägnanter und ansprechender Bildtitel",
      "description": "Detaillierte Bildbeschreibung"
    },
    "credits": {
      "amount": "von diesem aufruf verbrauchte credits",
      "remaining": "verbleibende credits nach diesem aufruf"
    }
  }
}

Anfragebeschränkungen

Um die Stabilität und Fairness des Dienstes zu gewährleisten, ist jeder API-Schlüssel auf 30 Anfragen pro Minute (1800 Anfragen pro Stunde) begrenzt. Anfragen, die dieses Limit überschreiten, werden mit dem Fehlercode 1004 abgelehnt.

Credit-System

• Jeder erfolgreiche API-Aufruf zur automatischen Bildverschlagwortung verbraucht 1 Credit.
• Inhalte, die vom Sicherheitsfilter blockiert werden, verbrauchen keine Credits.
• Systemfehler verbrauchen keine Credits.

Wie erhalte ich mehr Credits?

Sie können die Seite zum Aufladen von Credits besuchen, um Credit-Pakete zu erwerben und so mehr API-Aufrufe zur KI-gestützten Bildverschlagwortung zu unterstützen. Wir bieten verschiedene Pakete an, um den Bedürfnissen unterschiedlicher Benutzer gerecht zu werden.

Fehlerbehandlung

Die folgende Tabelle listet häufige Fehlercodes, ihre Bedeutung und Lösungen auf:

Anwendungsfälle und Integrationsbeispiele

SEO-Verbesserung

Verwenden Sie die API für KI Bild-Tagging, um automatisch Alt-Texte und Meta-Beschreibungen für die Bilder Ihrer Webseite zu generieren:

// Bild-SEO mit KI-generierten Tags verbessern
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_tags', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${apiKey}`
    },
    body: JSON.stringify({ image: base64Image })
  });
  
  const result = await response.json();
  const { tags, title, description } = result.data.tags;
  
  // Bildattribute für SEO aktualisieren
  imageElement.alt = description;
  imageElement.title = title;
  imageElement.setAttribute('data-tags', tags.join(', '));
};

Integration in Content-Management-Systeme

Integrieren Sie das KI-gestützte Foto-Tagging in Ihren CMS-Workflow:

# Massenverarbeitung von Bildern in einem Content-Management-System
import os
import requests
from pathlib import Path

def bulk_tag_images(directory_path, api_key):
    """Verarbeitet alle Bilder in einem Verzeichnis mit KI-Tagging"""
    image_extensions = ['.jpg', '.jpeg', '.png', '.webp']
    
    for image_path in Path(directory_path).iterdir():
        if image_path.suffix.lower() in image_extensions:
            try:
                # Tags für jedes Bild generieren
                result = generate_image_tags(api_key, str(image_path))
                
                # Metadaten in einer Begleitdatei speichern
                metadata_path = image_path.with_suffix('.json')
                with open(metadata_path, 'w') as f:
                    json.dump(result['data']['tags'], f, indent=2)
                    
                print(f"Verarbeitet: {image_path.name}")
                
            except Exception as e:
                print(f"Fehler bei der Verarbeitung von {image_path.name}: {e}")

# Anwendung
bulk_tag_images("/pfad/zu/bildern", "ihr_api_schlüssel")

Kontakt

Wenn Sie Fragen oder Anregungen zu unserer API für automatische Bildverschlagwortung oder unserem Dienst für Foto-Tagging haben, können Sie uns gerne über die folgenden Wege kontaktieren:

• E-Mail: [email protected]
• Technischer Support: Kundensupport-Team

Beginnen Sie jetzt mit der Nutzung der API für automatische Bildverschlagwortung und entfesseln Sie die Kraft der intelligenten Fotoklassifizierung und automatischen Bildverschlagwortung!