Chiavi API

Conserva la chiave sul tuo server e inviala come token Bearer. Tutto qui sotto è un avvio rapido da copiare e incollare.

1. Crea una chiave e salvala nel gestore di secret del server. Puoi copiarla di nuovo dall'elenco qui sotto in qualsiasi momento.
2. Invia una richiesta POST a /api/plant/identify con la chiave come token Bearer e l'immagine in un campo multipart.
3. Leggi la risposta JSON: i dati della pianta al primo livello, più credit_transaction e new_balance.

Richiesta

Richiesta di esempio

• 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=it" \
  -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": "it", "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", "it");
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());

Risposta di esempio

HTTP 200. Alcuni campi possono mancare se il modello non è sicuro: trattali tutti come facoltativi. care_level è un'etichetta localizzata, non un enum fisso.

{
  "success": true,
  "common_name": "Monstera",
  "scientific_name": "Monstera deliciosa",
  "family": "Araceae",
  "care_level": "Facile",
  "light": "Luce indiretta intensa",
  "watering": "Annaffia quando lo strato superiore è asciutto",
  "pet_safety": "Tossica per gli animali se ingerita",
  "description": "Rampicante tropicale con grandi foglie incise.",
  "identification_notes": "Bordi fogliari incisi e radici aeree.",
  "lookalikes": "Monstera adansonii",
  "next_step": "Ruota il vaso ogni settimana per una crescita uniforme.",
  "confidence": 0.92,
  "credit_transaction": "PI2026110600001",
  "new_balance": 18
}

Risposte di errore

Fatturazione e sicurezza