Schnellstart

Starten Sie in wenigen Minuten mit der KI-Bildbeschreibungs-API. Diese Anleitung führt Sie durch die wesentlichen Schritte zur Integration von KI-gestützter Bildbeschreibung in Ihre Anwendung.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie haben:

Konto: Registrieren Sie sich bei aidescribepicture.com
API-Schlüssel: Erstellen Sie einen API-Schlüssel in den Einstellungen
Credits: Kaufen Sie Bildbeschreibungs-Credits
Bild-URL: Eine öffentlich zugängliche Bild-URL für Tests

Schritt 1: Holen Sie sich Ihren API-Schlüssel

Besuchen Sie aidescribepicture.com
Melden Sie sich mit Ihrem Google-Konto an
Navigieren Sie zu Einstellungen > API-Schlüssel
Klicken Sie auf die Schaltfläche "Neuen API-Schlüssel erstellen"
Geben Sie einen Schlüsselnamen ein (z.B. "Meine App")
Nach der Erstellung des Schlüssels kopieren Sie den vollständigen Schlüsselwert (bewahren Sie ihn sicher auf!)

API-Schlüssel-Format

Beginnt mit sk-
Enthält zufällig generierte Zeichen
Beispiel: sk-abc123def456ghi789...

Schritt 2: Machen Sie Ihren ersten API-Aufruf

Mit 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": "Beschreiben Sie dieses Bild im Detail"
  }'

Mit JavaScript

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-Fehler: ${response.status} - ${error}`);
    }
 
    const result = await response.json();
    
    // Beschreibungsinhalt extrahieren
    const description = result.choices[0].message.content;
    return description;
  } catch (error) {
    console.error('Fehler beim Beschreiben des Bildes:', error);
    throw error;
  }
}
 
// Verwendung
const description = await describeImage(
  'https://example.com/image.jpg',
  'your-api-key-here',
  'Beschreiben Sie dieses Bild im Detail'
);
console.log('Bildbeschreibung:', description);

Schritt 3: Antwort verarbeiten

Die API gibt eine JSON-Antwort mit der Bildbeschreibung zurück:

{
  "choices": [
    {
      "message": {
        "content": "Dieses Bild zeigt einen roten Fuchs in Nahaufnahme, der zur Kamera schaut. Der Fuchs hat flauschiges orange und weißes Fell, aufgerichtete Ohren und leuchtende braune Augen. Der Hintergrund ist verschwommen, möglicherweise in einer verschneiten Umgebung oder einer hellen Umgebung."
      }
    }
  ]
}

Das Feld choices[0].message.content enthält den tatsächlichen Bildbeschreibungstext.

Schritt 4: Ergebnis anzeigen

In HTML

<div id="description">
  <p id="image-description"></p>
</div>

In JavaScript

// Beschreibung anzeigen
const descriptionElement = document.getElementById('image-description');
descriptionElement.textContent = description;

Schritt 5: Fehlerbehandlung

Implementieren Sie immer eine ordnungsgemäße Fehlerbehandlung:

try {
  const description = await describeImage(imageUrl, apiKey, prompt);
  // Erfolg behandeln
  console.log('Beschreibung:', description);
} catch (error) {
  if (error.message.includes('401')) {
    console.error('Ungültiger API-Schlüssel');
  } else if (error.message.includes('402')) {
    console.error('Unzureichende Credits');
  } else if (error.message.includes('429')) {
    console.error('Rate-Limit überschritten');
  } else {
    console.error('API-Fehler:', error.message);
  }
}

API-Schlüssel-Verwaltung

Schlüssel in Einstellungen verwalten

Alle API-Schlüssel anzeigen
Schlüssel-Nutzungsstatistiken anzeigen
Nicht verwendete Schlüssel deaktivieren oder löschen
Letzte Nutzungszeit für Schlüssel anzeigen

Sicherheits-Best-Practices

API-Schlüssel niemals im Client-seitigen Code hart codieren
Schlüssel mit Umgebungsvariablen speichern
API-Schlüssel regelmäßig rotieren
Verschiedene Schlüssel für verschiedene Umgebungen verwenden

Umgebungsvariablen-Beispiel

# .env-Datei
IMAGE_DESCRIPTION_API_KEY=sk-your-api-key-here

// Im Code verwenden
const apiKey = process.env.IMAGE_DESCRIPTION_API_KEY;

Schnellstart

On this page