API-Schlüssel

Bewahren Sie den Schlüssel auf Ihrem Server auf und senden Sie ihn als Bearer-Token. Alles unten ist ein Schnellstart zum Kopieren.

1. Erstellen Sie einen Schlüssel und speichern Sie ihn im Secret Store Ihres Servers. Sie können ihn jederzeit aus der Liste unten erneut kopieren.
2. Senden Sie eine POST-Anfrage an /api/plant/identify mit dem Schlüssel als Bearer-Token und dem Bild in einem Multipart-Feld.
3. Lesen Sie die JSON-Antwort: Pflanzendaten auf der obersten Ebene, dazu credit_transaction und new_balance.

Anfrage

Beispielanfrage

• cURL
• Python
• Node.js

curl -X POST https://api.plantidentify.org/api/plant/identify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@/path/to/plant.jpg;type=image/jpeg" \
  -F "lang=de" \
  -F "context=houseplant"

import requests

with open("plant.jpg", "rb") as f:
    r = requests.post(
        "https://api.plantidentify.org/api/plant/identify",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        files={"image": ("plant.jpg", f, "image/jpeg")},
        data={"lang": "de", "context": "houseplant"},
        timeout=90,
    )
print(r.status_code, r.json())

import { readFile } from "node:fs/promises";

const form = new FormData();
form.append("image", new Blob([await readFile("plant.jpg")], { type: "image/jpeg" }), "plant.jpg");
form.append("lang", "de");
form.append("context", "houseplant");

const res = await fetch("https://api.plantidentify.org/api/plant/identify", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
});
console.log(res.status, await res.json());

Beispielantwort

HTTP 200. Felder können fehlen, wenn das Modell unsicher ist — behandeln Sie alle als optional. care_level ist ein lokalisierter Anzeigetext, kein festes Enum.

{
  "success": true,
  "common_name": "Monstera",
  "scientific_name": "Monstera deliciosa",
  "family": "Araceae",
  "care_level": "Einfach",
  "light": "Helles indirektes Licht",
  "watering": "Gießen, wenn die obere Erdschicht trocken ist",
  "pet_safety": "Für Haustiere giftig beim Verzehr",
  "description": "Tropische Kletterpflanze mit großen, geschlitzten Blättern.",
  "identification_notes": "Geschlitzte Blattränder und Luftwurzeln.",
  "lookalikes": "Monstera adansonii",
  "next_step": "Den Topf wöchentlich drehen für gleichmäßiges Wachstum.",
  "confidence": 0.92,
  "credit_transaction": "PI2026110600001",
  "new_balance": 18
}

Fehlerantworten

Abrechnung und Sicherheit