Dokumentation

KI-Bildbeschreibungs-API

Bildinhalt mit KI-Technologie beschreiben

Die KI-Bildbeschreibungs-API ermöglicht es Ihnen, fortschrittliche KI-Technologie zu verwenden, um Bildinhalt zu beschreiben. Dieser Endpunkt verarbeitet Bilder und gibt detaillierte Textbeschreibungen zurück. Erleben Sie die leistungsstarke KI-Bildbeschreibungsfunktion von AI Describe Picture.

Endpunkt

POST /api/api-call/describe-picture

Authentifizierung

Erfordert einen gültigen API-Schlüssel im Authorization-Header:

Authorization: Bearer YOUR_API_KEY

Anfrage

HeaderRequiredDescription
Content-TypeYesMuss application/json sein
AuthorizationYesIhr API-Schlüssel im Format Bearer YOUR_API_KEY

Body-Parameter

ParameterTypeRequiredDescription
imageUrlstringYesURL des zu beschreibenden Bildes (muss öffentlich zugänglich sein)
promptstringNoBenutzerdefinierte Eingabeaufforderung (optional)

Anfrage-Beispiel

{
  "imageUrl": "https://example.com/image.jpg",
  "prompt": "Beschreiben Sie alle Elemente, Farben und Komposition in diesem Bild im Detail"
}

Antwort

Erfolgreiche Antwort (200)

Die API gibt ein JSON-Objekt zurück, das Bildbeschreibungen mit einem choices-Array enthält.

{
  "choices": [
    {
      "logprobs": null,
      "finish_reason": "stop",
      "native_finish_reason": "STOP",
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Das Bild zeigt eine Nahaufnahme eines roten Fuchses, 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 einem verschneiten Feld oder einer hellen Umgebung.",
        "refusal": null,
        "reasoning": null
      }
    }
  ]
}

Beschreibung:

  • Das choices-Array enthält KI-generierte Beschreibungsinhalte, jede choice enthält ein vollständiges Nachrichtenobjekt
  • Das Feld message.content enthält den tatsächlichen Bildbeschreibungstext
  • Das Antwortformat ist mit der OpenAI-API kompatibel

Fehlerantworten

400 Bad Request

{
  "message": "Invalid input"
}

401 Unauthorized

{
  "message": "Invalid or expired API key"
}

402 Payment Required

{
  "message": "Insufficient credits"
}

500 Internal Server Error

{
  "message": "Service error"
}

Nutzungsbeschränkungen

  • Guthabenverbrauch: 1 Guthaben pro Beschreibung
  • Bildanforderungen: Unterstützt JPG-, PNG-, WebP-Formate, maximal 5MB

Nutzungsbeispiele

JavaScript/Node.js

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

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 alle Elemente, Farben und Komposition in diesem Bild im Detail"
  }'

Bildanforderungen

  • Format: JPG, PNG, WebP
  • Größe: Maximal 5MB
  • Zugänglichkeit: Bild-URL muss öffentlich zugänglich sein
  • Inhalt: Muss eine gültige Bilddatei sein

Verarbeitungszeit

  • Typisch: 10-30 Sekunden
  • Große Bilder: Kann bis zu 60 Sekunden dauern

Guthaben

  • Kosten: 1 Guthaben pro Beschreibung
  • Abzug: Guthaben wird nach erfolgreicher Verarbeitung abgezogen

Best Practices

  1. Bildqualität: Verwenden Sie hochwertige Bilder für bessere Ergebnisse
  2. Fehlerbehandlung: Implementieren Sie immer eine angemessene Fehlerbehandlung
  3. Guthabenverwaltung: Überwachen Sie regelmäßig Ihr Guthaben
  4. Eingabeaufforderungen: Verwenden Sie spezifische Eingabeaufforderungen für präzisere Beschreibungen

Fehlerbehebung

Häufige Probleme

401 Unauthorized

  • Überprüfen Sie, ob Ihr API-Schlüssel korrekt ist
  • Stellen Sie sicher, dass der API-Schlüssel aktiv und nicht abgelaufen ist

402 Payment Required

  • Fügen Sie Guthaben zu Ihrem Konto hinzu
  • Überprüfen Sie Ihr aktuelles Guthaben

400 Bad Request

  • Überprüfen Sie, ob die imageUrl eine gültige, zugängliche URL ist
  • Stellen Sie sicher, dass das Bildformat unterstützt wird

500 Internal Server Error

  • Serverinterner Fehler, bitte versuchen Sie es später erneut
  • Überprüfen Sie, ob die Bild-URL zugänglich ist

Support

Wenn Sie auf Probleme stoßen, die hier nicht behandelt werden, kontaktieren Sie bitte unser Support-Team.