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
Authentifizierung
Erfordert einen gültigen API-Schlüssel im Authorization-Header:
Anfrage
Header
Header | Required | Description |
---|---|---|
Content-Type | Yes | Muss application/json sein |
Authorization | Yes | Ihr API-Schlüssel im Format Bearer YOUR_API_KEY |
Body-Parameter
Parameter | Type | Required | Description |
---|---|---|---|
imageUrl | string | Yes | URL des zu beschreibenden Bildes (muss öffentlich zugänglich sein) |
prompt | string | No | Benutzerdefinierte Eingabeaufforderung (optional) |
Anfrage-Beispiel
Antwort
Erfolgreiche Antwort (200)
Die API gibt ein JSON-Objekt zurück, das Bildbeschreibungen mit einem choices-Array enthält.
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
401 Unauthorized
402 Payment Required
500 Internal Server Error
Nutzungsbeschränkungen
- Guthabenverbrauch: 1 Guthaben pro Beschreibung
- Bildanforderungen: Unterstützt JPG-, PNG-, WebP-Formate, maximal 5MB
Nutzungsbeispiele
JavaScript/Node.js
cURL
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
- Bildqualität: Verwenden Sie hochwertige Bilder für bessere Ergebnisse
- Fehlerbehandlung: Implementieren Sie immer eine angemessene Fehlerbehandlung
- Guthabenverwaltung: Überwachen Sie regelmäßig Ihr Guthaben
- 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.