Image Describer API Dokumentation - KI-gestützte Bildbeschreibungserstellung

Übersicht

Die Image Describer API ist ein leistungsstarkes Werkzeug zur Erstellung von Bildbeschreibungen, das intelligent präzise, detaillierte und aufschlussreiche Beschreibungen von Bildern basierend auf dem bereitgestellten Bild und Prompt erzeugt. Diese KI-gestützte Bilderkennungs-API versteht und analysiert Bildinhalte und generiert entsprechende Textbeschreibungen gemäß Ihren Prompts. Sie ist weit verbreitet in verschiedenen Szenarien der Bildverstehen, Bildanalyse und Bildinhaltsgenerierung und ermöglicht Ihnen die einfache Implementierung von Bild-Frage-Antwort-Systemen und Bild-zu-Text-Konvertierung.

Anwendungsszenarien

Die Image Describer API kann Sie dabei unterstützen, Bildverstehen und Inhaltsgenerierung in den folgenden Bereichen effizient durchzuführen:

• Daten-Chart-Analyse: Automatische Interpretation von Diagrammdaten und Erstellung von statistischen Analyseberichten.
• Kunstwerkbewertung: Professionelle Bewertungen und Interpretationen von Kunstwerken.
• Blogpost-Generierung: Generierung von Absätzen oder ganzen Artikeln basierend auf Bildern.
• Objekterkennung: Identifizierung von Objekten in Bildern und Bereitstellung detaillierter Informationen, wie z. B. Objektnamen, Attribute und mögliche Verwendungszwecke.
• Bild-Frage-Antwort-Systeme: Erhalten Sie detaillierte Informationen über den Bildinhalt, indem Sie Fragen stellen, wie z. B. "Was ist auf dem Bild?" oder "Was macht diese Person?".
• Bildungsanwendungen: Unterstützung im Unterricht, z. B. bei der Identifizierung von Bildern von Pflanzen und Tieren, der Erläuterung historischer Bilder usw.
• E-Commerce: Automatische Generierung von Produktbeschreibungen zur Verbesserung der Informationsfülle von Produkten.

API-Schlüssel

Um auf die Image Describer API zugreifen zu können, benötigen Sie zunächst einen gültigen API-Schlüssel. 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. Zugriff auf die API-Schlüssel-Verwaltungsseite: Melden Sie sich im System an und klicken Sie dann auf Ihren Benutzer-Avatar in der oberen rechten Ecke. Klicken Sie im Dropdown-Menü auf "API beantragen", um die API-Schlüssel-Verwaltungsseite zu öffnen.
2. Erstellen eines neuen Schlüssels: Klicken Sie auf "Neuen Schlüssel erstellen", geben Sie im Popup-Dialog einen Namen für Ihren Schlüssel ein und klicken Sie dann auf "Erstellen".
3. Kopieren und Speichern Ihres Schlüssels: Beachten Sie, dass der Schlüssel nur einmal vollständig angezeigt wird. Klicken Sie auf das Kopiersymbol, um den Schlüssel in Ihre Zwischenablage zu kopieren, und klicken Sie dann auf "Bestätigen", um den Dialog zu schließen.

Wichtig: Geben Sie ihn nicht an Dritte weiter 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_content

Anfrageparameter

Request Headers

Request Body

{
  "image": "data:image/jpeg;base64,{image_base64_data}",
  "prompt": "Was ist das für ein Objekt? Beschreiben Sie seine möglichen Verwendungszwecke.",
  "lang": "de"
}

Unterstützte Sprachen

Anfragebeispiel (cURL)

curl --location 'https://api.imagedescriber.app/api/v1/generate_content' \
--header 'content-type: application/json' \
--header 'authorization: Bearer your_api_key' \
--data '{
    "image":"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQE...",
    "prompt":"Was ist das für ein Objekt? Beschreiben Sie seine möglichen Verwendungszwecke.",
    "lang":"de"
}'

Anfragebeispiel (Python)

import requests
import base64

def image_to_base64(image_path):
  """Konvertiert ein Bild in eine Base64-Codierung"""
  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="de"):
  """Generiert eine Bildbeschreibung mit der Image Describer API"""
  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"Fehler: {response.status_code}")
    print(response.text)

# Beispielhafte Verwendung
api_key = "your_api_key"
image_path = "your_image.jpg"
prompt = "Was ist das für ein Objekt? Beschreiben Sie seine möglichen Verwendungszwecke."

generate_image_description(api_key, image_path, prompt)

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 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,
  "prompt": "Beschreibe das Bild im Detail",
  "lang": "de"
};

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

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

Antwort

Response Body (JSON-Antwort)

Die API gibt jetzt die vollständige Antwort in einem einzigen JSON-Objekt zurück. Das Feld content innerhalb des data-Objekts enthält die generierte Bildbeschreibung im Markdown-Format.

{
  "code": 0,
  "message": "Erfolg",
  "request_id": "eindeutige_anfrage_id_zeichenkette",
  "data": {
    "content": "Generierter Inhalt im Markdown-Format" 
  }
}

Anfragelimits

Um die Dienststabilität und -gerechtigkeit zu gewährleisten, ist jeder API-Schlüssel auf 5 Anfragen pro Minute (300 Anfragen pro Stunde) beschränkt. Anfragen, die dieses Limit überschreiten, werden mit dem Fehlercode 1004 abgelehnt.

Credit-System

• Jeder erfolgreiche API-Aufruf verbraucht 1 Credit.
• Inhalte, die durch den Sicherheitsfilter blockiert werden, verbrauchen keine Credits.
• Systemfehler verbrauchen keine Credits.

Wie bekomme ich mehr Credits?

Sie können die Seite zum Aufladen von Credits besuchen, um Credit-Pakete zu kaufen, um mehr API-Aufrufe zu unterstützen. Wir bieten verschiedene Pakete an, um die Bedürfnisse verschiedener Benutzer zu erfüllen.

Fehlerbehandlung

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

Kontaktieren Sie uns

Wenn Sie Fragen oder Anregungen haben, können Sie uns gerne über die folgenden Methoden kontaktieren:

• E-Mail: [email protected]
• Technischer Support: Kundendienstteam

Beginnen Sie jetzt mit der Nutzung der Image Describer API und erschließen Sie die grenzenlosen Möglichkeiten des Bildverstehens!