Use Cases / image-object-box
Jev Image Object Box (beta)
Entradas de imagem e perguntas Box são beta e dreamer-ready, não recomendadas para produção. Times ainda querem perguntar de forma schema-safe “onde está o produto nesta foto?” sem parsear prosa de visão livre.
Try a related template free on this host — 5 anonymous real-API runs with no signup — then ship the same schema with a prepaid jv_live_ key. See is Jev free? and playground.
Why Jev
No Jev 1.14 você pode anexar assets de imagem nomeados e fazer uma pergunta box. O modelo devolve um único bounding box { top, bottom, left, right } mais confiança — saída tipada que o código pode desenhar ou usar como gate. Trate os resultados como experimentais.
How to define the decision
Envie assets: { "photo": { "type": "image", "format": "png", "data_base64": "…" } } e state que referencia `photo`. Pergunta: { "type": "box", "instructions": "Find the primary product in photo" }. Veja /docs/api/#box.
When to use Jev
- Prototipar gates de visão antes de um detector de produção
- Aprender o formato de pedido assets + box neste host
- Evals lado a lado contra um modelo de visão dedicado
When not to use Jev
- Pipelines de produção de segurança, médicos ou controle de acesso
- SLAs de localização pixel-perfect
- Detecção de vídeo ou multiobjeto
Failure modes and human fallback
- Upstream or network errors: retry with backoff; do not invent a decision.
- Low confidence: route to a human queue or safer default — never auto-act on money/destructive tools.
- Schema drift: keep a golden fixture set in CI so label changes fail the build before production.
- Oficial: entradas de imagem e perguntas Box são beta e dreamer-ready, não recomendadas para produção.
- O metering prepaid ainda se aplica ao chamar a API live — a preview da homepage não.
- Prefira um stack de visão dedicado para localização em produção.
API example
Same prepaid jv_live_ balance as tools. Output tokens are free on this host's metering model.
curl https://jevtypesafe.org/api/v1/decide \
-H "Authorization: Bearer jv_live_YOUR_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{"state":"Customer: I've been waiting five days for my refund.","questions":{"action":{"type":"choice","instructions":"Decide the next step","criteria":{"allow":"safe","review":"unsure","block":"unsafe"}}}}'FAQ
- Image / Box está pronto para produção?
- Não. Entradas de imagem e perguntas Box são beta e dreamer-ready, não recomendadas para produção.
- Como experimentar sem gastar tokens?
- Abra a preview local Image · Box (beta) no playground da homepage, ou chame /api/v1/decide com uma chave jv_live_ quando estiver pronto para meterizar.
- Como é a resposta box?
- answers.<name> = { type: "box", box: { top, bottom, left, right }, confidence }. Coordenadas normalizadas 0–1.
Related use cases
Ready to build?
Free anonymous tool runs, then prepaid packs and a jv_live_ key — independent host, not affiliated with TypeSafe AI.