Chaves de API

Mantenha a chave no seu servidor e envie como token Bearer. Tudo abaixo é um início rápido para copiar e colar.

1. Crie uma chave e guarde-a no gerenciador de segredos do servidor. Você pode copiá-la novamente na lista abaixo a qualquer momento.
2. Envie uma requisição POST para /api/plant/identify com a chave como token Bearer e a imagem em um campo multipart.
3. Leia a resposta JSON: os dados da planta no nível superior, mais credit_transaction e new_balance.

Requisição

Requisição de exemplo

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

Resposta de exemplo

HTTP 200. Campos podem faltar quando o modelo não tem certeza — trate todos como opcionais. care_level é um rótulo localizado, não um enum fixo.

{
  "success": true,
  "common_name": "Costela-de-adão",
  "scientific_name": "Monstera deliciosa",
  "family": "Araceae",
  "care_level": "Fácil",
  "light": "Luz indireta intensa",
  "watering": "Regue quando a camada superior estiver seca",
  "pet_safety": "Tóxica para animais se ingerida",
  "description": "Trepadeira tropical com folhas grandes e recortadas.",
  "identification_notes": "Bordas recortadas e raízes aéreas.",
  "lookalikes": "Monstera adansonii",
  "next_step": "Gire o vaso toda semana para um crescimento uniforme.",
  "confidence": 0.92,
  "credit_transaction": "PI2026110600001",
  "new_balance": 18
}

Respostas de erro

Cobrança e segurança