Jev Kini Memahami Foto: Daripada Semakan Pemulangan kepada Lokasi Kerosakan

Pelanggan menghantar foto cawan yang sumbing. Alat sokongan anda perlu menjawab tiga soalan berbeza: adakah cawan kelihatan, adakah foto menunjukkan kerosakan, dan di manakah penyemak patut melihat? Perenggan lancar tentang seramik bukan hasil perantaraan yang paling berguna.

Pada 14 Oktober 2026, TypeSafe AI mengumumkan sokongan imej eksperimen untuk Jev bersama Jev 1.14.0 serta jenis output box baharu. Imej berfungsi dengan Jev 1.13 dan 1.14; Box memerlukan 1.14. TypeSafe menyifatkan ciri ini sebagai eksperimen dan secara jelas belum mengesyorkannya untuk automasi produksi. Pengumuman rasmi

Perubahan berguna ini lebih khusus daripada pembantu multimodal serba boleh: foto boleh menjadi keputusan bertip atau lokasi dalam program. Inilah kesannya pada aliran pemulangan barang, perkara yang diterima antara muka dan cara membina prototaip berhati-hati tanpa menyalah anggap segi empat sebagai bukti.

Rajah penerangan asli: foto masuk, penilaian dan koordinat berasingan keluar, kemudian manusia menyemak kerosakan yang dicadangkan. Ini gambaran aliran kerja, bukan hasil model yang direkodkan.

Ringkasnya:

• Jev kini mempunyai laluan eksperimen untuk memahami imej pegun, bukan menjana imej.
• Tanyakan sama ada sasaran wujud sebelum mempercayai lokasi yang dicadangkan.
• Kekalkan foto asal dan semakan manusia; biarkan kod mengesahkan koordinat, kebenaran dan akibat.

Foto boleh menjadi keputusan, bukan sekadar penerangan

Tarikan asal Jev ialah jawapan terbatas: pilih pilihan diberi, beri skor mengikut tahap dihuraikan atau nilai pernyataan ya/tidak. Panduan terdahulu tentang model keputusan Jev membincangkan asas itu. Perkembangan baharu ialah keupayaan mengemukakan soalan sedemikian menggunakan bukti visual serta mendapatkan koordinat ruang.

Bagi antara muka pemulangan, pembahagian tugas berubah. Model boleh mencadangkan kerosakan kelihatan; kod aplikasi boleh memaparkan cadangan itu bersebelahan imej yang dihantar. Kedua-dua tindakan tidak membuktikan bila kerosakan berlaku, sama ada foto itu milik pesanan tersebut atau bayaran balik dibenarkan. Semua itu soalan berasingan dengan bukti berbeza.

Batasan ini berpandukan rujukan model, kontrak permintaan API dan SDK berkeupayaan imej. Folder PDF tidak automatik menjadi pipeline pemprosesan dokumen hanya kerana sesetengah halamannya mempunyai gambar. Begitu juga beberapa bingkai yang diekstrak tidak membuktikan pemahaman video natif atau akses kepada runut bunyi klip.

Pandangan kami: unit yang menarik ialah penilaian kecil yang boleh diperiksa dan dikaitkan dengan bukti. Ia bukan kebenaran baharu untuk mengautomatikkan semua langkah seterusnya.

Tiga contoh rasmi menukar foto sama kepada tugas berbeza

Dokumentasi JavaScript TypeSafe memberikan tiga titik mula konkrit. Itu contoh kod terbitan, bukan laporan penggunaan pelanggan sebenar atau hasil terukur. Anggap sebagai corak prototaip, bukan jaminan ketepatan pada foto anda.

Contoh pertama menggabungkan tuntutan cawan rosak dengan foto produk, lalu bertanya kepada Noul tentang kerosakan dan kepada Score tentang tahapnya. Dalam barisan sokongan, adaptasi boleh menaikkan kes yang disyaki rosak untuk diperiksa. Penyemak tetap patut melihat foto penuh, penerangan pelanggan dan pilihan menolak cadangan.

Contoh kedua membandingkan foto muat naik penjual dengan imej katalog. Ia bertanya sama ada kedua-duanya menunjukkan produk sama dan mengelaskan kebolehgunaan foto, termasuk kabur, terpotong dan kandungan bukan produk. Untuk pasaran, ini menunjukkan pemisahan berguna: padanan identiti dan mutu foto tidak perlu berkongsi satu keputusan kelulusan. Imej jelas bagi produk salah tidak patut lulus hanya kerana nampak profesional.

Contoh ketiga meminta Box mencari kawasan rosak. Hasilnya boleh membantu menghasilkan lapisan tindihan atau cadangan pemotongan untuk penyemak. Simpan juga imej asal tanpa potongan: mengecilkan fokus boleh membantu pemeriksaan tuntutan, tetapi mungkin menyembunyikan konteks yang mengubah maksudnya.

Ikuti contoh rasmi bagi penilaian kerosakan, perbandingan katalog dan lokasi kerosakan. Aliran pemulangan yang kami cadangkan menambah perlindungan aplikasi pada corak itu; ia bukan laporan percubaan.

Kotak tidak dapat memberitahu bahawa tiada apa-apa untuk dicari

Butiran penting dalam kontrak Box TypeSafe ialah tiada output untuk sasaran yang tiada. Soalan Box memulangkan empat tepi walaupun sasaran yang diminta tidak wujud. Oleh itu, segi empat pada cawan yang masih elok tidak membuktikan kerosakan.

Tanya Noul secara berasingan sama ada sasaran itu hadir. Untuk aliran ini, bezakan antara cawan kelihatan dengan kerosakan kelihatan. Jawapan positif tentang cawan tidak mencukupi untuk membenarkan tindihan kerosakan. Abaikan kotak kerosakan cadangan melainkan semakan kehadiran berkaitan melepasi peraturan yang sudah disahkan.

Gerbang kehadiran ini bukan penyelesaian kepada semua kesilapan. Kedua-dua penilaian boleh salah serentak. Pantulan terang mungkin kelihatan seperti sumbing, sedangkan retak sebenar mungkin hilang pada permukaan berkaca bercorak. Uji foto tanpa cawan, cawan elok, pantulan samar, berbilang objek dan kerosakan yang jelas sebelum menetapkan ambang.

Rajah keputusan asli: segi empat sah hanya berguna selepas gerbang kehadiran sasaran lulus. Semakan gagal atau tidak pasti mengekalkan foto asal untuk semakan manusia; ia bukan penolakan automatik.

Anggap segi empat itu sebagai penunjuk, bukan keputusan muktamad.

Anggap koordinat sebagai geometri, kemudian semak maksudnya

Box memulangkan left, right, top dan bottom sebagai pecahan dimensi imej, diukur dari penjuru kiri atas. Nilai berada antara 0 dan 1, dengan left < right dan top < bottom. Satu soalan menghasilkan satu kotak, bukan senarai pengesanan objek. Kontrak respons Box

Bagi imej contoh bersaiz 1200 x 900, tepi kiri 0.20, atas 0.30, kanan 0.60 dan bawah 0.70 bersamaan tepi piksel 240, 270, 720, 630. Ini contoh kiraan, bukan respons Jev. API pemotongan lazimnya menjangka kiri, atas, kanan, bawah; petakan medan bernama dengan sengaja dan jangan bergantung pada susunan sifat JSON.

Sahkan nombor terhingga, julat dan susunan sebelum melukis apa-apa. Kemudian periksa sama ada kawasan itu benar-benar mengenal pasti kerosakan. Jika foto diubah saiz, diputar, ditambah ruang tepi atau dibahagi jubin, simpan transformasi yang diperlukan untuk memetakan koordinat kembali; jika tidak, kotak yang nampak munasabah boleh menunjuk piksel yang salah.

Sediakan imej sebelum permintaan, bukan selepas ralat

Had imej rasmi adalah tepat dan inklusif. Imej di luar julat ditolak, bukannya diubah saiz secara automatik; satu imej yang ditolak menggagalkan seluruh permintaan.

Rujukan berulang dikira semula dalam permintaan yang dikembangkan. Saiz fail, dimensi dan panjang konteks ialah semakan berasingan. Had imej

Rajah kekangan asli berdasarkan dokumentasi imej TypeSafe, disemak 18 Oktober 2026. Had fail, imej diproses, permintaan dikembangkan dan badan permintaan terpakai secara berasingan.

TypeSafe turut menyarankan supaya piksel diputarkan ke orientasi tegak sebelum dihantar: API membuang metadata dan tidak menggunakan orientasi EXIF. Tukar format tidak disokong terlebih dahulu. Panduan penyediaan

Untuk prototaip, sediakan salinan foto milik sendiri yang dinamakan dengan jelas dan biarkan sumber asal tidak diusik. Semak dimensi setempat dan pratonton salinan tepat yang akan dihantar. Foto terlalu sempit mungkin memerlukan ruang tepi untuk memenuhi dimensi minimum; rekodkan tambahan itu sebelum mentafsir koordinat.

Tetapkan versi 1.14 dan nyatakan suis eksperimen dengan jelas

Setakat 18 Oktober, jadual alias terbitan memetakan jev-latest kepada jev-1.13.0 dan jev-preview kepada jev-1.14.0. Tetapkan jev-1.14.0 untuk contoh Box dan jangan anggap “latest” bermakna pratonton terbaharu. Alias model

Prosedur berikut menghasilkan contoh setempat untuk semakan sahaja. Menjalankan arahan terakhir menghantar permintaan inferens yang boleh dibil; SDK mungkin mencubanya semula. Ia tidak meluluskan pemulangan atau mengubah akaun. Gunakan foto peringkat ujian yang milik anda, tanpa orang, label penghantaran, alamat atau dokumen peribadi.

1. Dapatkan akses dan pilih organisasi yang betul. TypeSafe menyatakan pendaftaran tidak lagi memerlukan kelulusan senarai menunggu. Cipta kunci API dalam konsol dan semak kredit organisasi sebelum menguji. Akses akaun, tetapan kredit

2. Gunakan Node.js 22 atau lebih baharu. Keluaran SDK JavaScript berkeupayaan imej ialah 0.7.0, bertarikh 14 Oktober. Menguncinya menyatakan kebergantungan klien contoh ini dengan jelas. Log perubahan SDK

node --version
mkdir jev-photo-check
cd jev-photo-check
npm init -y
npm install @typesafe-ai/[email protected]

3. Tetapkan kunci untuk sesi ini sahaja. Gunakan blok pertama dalam Windows PowerShell; gunakan blok kedua dalam Bash/Zsh macOS atau Linux. Gantikan pemegang tempat secara setempat dan jangan komit kunci sebenar.

$env:TYPESAFE_API_KEY = "your-api-key"

export TYPESAFE_API_KEY="your-api-key"

4. Sediakan owned-mug.jpg dan cipta inspect-return.mjs. Adaptasi asli ini menggunakan pembantu SDK yang didokumenkan. Pengepala eksperimen ditetapkan sebelum sebarang permintaan imej. Kedua-dua ambang kebarangkalian di bawah ialah peraturan aplikasi ilustrasi, bukan saranan TypeSafe. Setiap hasil tetap perlu disemak manusia. Penggunaan SDK

import { readFile } from "node:fs/promises";
import { box, image, noul, TypeSafeClient } from "@typesafe-ai/sdk";

if (!process.env.TYPESAFE_API_KEY) {
  throw new Error("Set TYPESAFE_API_KEY before choosing to run this example.");
}

const client = new TypeSafeClient({
  defaultHeaders: { "TypeSafe-Danger-Zone-Images": "true" },
});
const photo = image(await readFile("owned-mug.jpg"));
const response = await client.systemOne({
  model: "jev-1.14.0",
  state: { photo },
  questions: {
    mugVisible: noul("Is a mug clearly visible in `photo`?"),
    damageVisible: noul("Is physical damage clearly visible on the mug in `photo`?"),
    damageRegion: box("The physically damaged area of the mug in `photo`"),
  },
});

const { mugVisible, damageVisible, damageRegion } = response.answers;
const edges = damageRegion.box;
const coordinates = [edges.left, edges.top, edges.right, edges.bottom];
const validBox = coordinates.every(
  (value) => Number.isFinite(value) && value >= 0 && value <= 1,
) && edges.left < edges.right && edges.top < edges.bottom;

const presencePasses = [mugVisible.noul, damageVisible.noul].every(
  (value) => Number.isFinite(value) && value >= 0.95 && value <= 1,
);

console.log({
  model: response.model,
  usage: response.usage,
  humanReviewRequired: true,
  suggestedBox: presencePasses && validBox ? edges : null,
});

5. Jalankan hanya apabila anda bersedia menghantar imej dan menanggung penggunaan. Pada ketiga-tiga sistem operasi, arahan ialah node inspect-return.mjs. Pengecualian atau suggestedBox: null patut mengekalkan imej asal untuk semakan, bukannya mencetuskan penghantaran automatik berulang.

Soalan itu berkongsi satu permintaan, tetapi kotak diabaikan melainkan gerbang aplikasi lulus. Ini tidak menjimatkan kos pengiraan kotak yang tidak digunakan. Reka bentuk kemudian boleh menjadikan pelokalan permintaan kedua selepas semakan kehadiran, menukar satu lagi perjalanan rangkaian dengan mengelakkan panggilan pelokalan yang tidak perlu.

Harga token kecil bukan harga setiap foto

Kadar terbitan bagi kedua-dua versi ialah $0.042 bagi sejuta token input, dengan token output percuma. Maka 10 juta token input berbil $0.42 pada kadar disenaraikan; ini tidak bermakna sepuluh juta imej berharga sebanyak itu. Harga terbitan

Imej dikira sebagai token input pada kadar teks, tanpa caj imej berasingan. TypeSafe belum memberikan formula anggaran token imej dalam dokumentasinya. Gunakan usage.input_tokens daripada respons ketika membuat bajet penilaian yang dibenarkan; jangan mereka kos bagi setiap foto. Pengebilan imej

Bajet perlu merangkumi cubaan gagal, percubaan semula, prapemprosesan, storan dan masa penyemak. Simpan ukuran kos bersama mutu: menjimatkan sebahagian kecil sen tidak berguna jika potongan terlalu rapat memaksa setiap penyemak membuka semula imej asal. Bandingkan keseluruhan tugasan semakan dengan garis dasar manual yang mudah.

Reka bentuk untuk ketidakpastian, privasi dan perkhidmatan sibuk

Noul memulangkan kebarangkalian tanpa medan confidence berasingan. Choice dan Score menyertakan taburan serta nilai keyakinan terbitan. Nilai itu menerangkan ketidakpastian model; ia bukan sijil ketepatan menyeluruh. Dokumentasi keyakinan

Untuk aliran cawan, sahkan gerbang menggunakan foto tertahan yang mempunyai label dipersetujui. Kelompokkan output serupa dan bandingkannya dengan ketepatan diperhatikan untuk menyemak kalibrasi bagi tugasan anda. Ukur kerosakan terlepas berasingan daripada amaran palsu, dan bezakan tindihan tersasar daripada keputusan bayaran balik salah. Nilai semula ambang selepas model, pencahayaan, kategori produk atau proses pengambilan gambar berubah.

Jangan anggap setiap foto yang tidak lulus sebagai kesalahan pelanggan. Foto mungkin tidak memadai kerana kamera kurang baik, objek memantulkan cahaya atau kecacatan memerlukan sudut lain. Status semakan berguna menawarkan laluan foto tambahan dan pemeriksaan manual tanpa menyalahkan pelanggan atas ketidakpastian model.

TypeSafe menyatakan permintaan dan respons pelanggan tidak digunakan untuk melatih Jev. Pusat bantuannya turut menjelaskan pemprosesan boleh meliputi penyampaian perkhidmatan, bil, pencegahan penyalahgunaan dan telemetri; pengekalan bergantung pada data, perjanjian serta sebarang aturan pengekalan data sifar. Tidak melatih model tidak sama dengan tidak menyimpan data. Dasar pengendalian data

Halaman status perkhidmatan awam menyenaraikan geografi AS serta rantau us-east-1, us-east-2 dan us-west-2. Pasukan yang mempunyai syarat residensi data serantau perlu menyelesaikan lokasi pemprosesan sebelum memuat naik foto pelanggan; akses ke konsol bukan perjanjian residensi.

Kurangkan data sebelum muat naik. Potong label alamat pada salinan yang disediakan jika tidak relevan, hadkan akses kepada asal dan elakkan imej atau rahsia dalam log rutin. Tentukan pengekalan rekod semakan sendiri, berasingan daripada dasar penyedia.

Had organisasi merangkumi permintaan dan token sesaat. API mendokumenkan 429 bagi had kadar dan 529 bagi beban berlebihan; input cacat atau terlalu besar memerlukan pembetulan, bukan percubaan semula tanpa perubahan. Had kadar, ralat API

Dasar percubaan semula SDK JavaScript lalai kepada dua percubaan dan menghormati pengepala jeda yang disokong. Elakkan menambah gelung percubaan luar tanpa had. Tetapkan bajet masa, kekalkan status ralat yang boleh ditindaklanjuti dan asingkan sebarang tindakan perniagaan supaya inferens yang dicuba semula tidak mengeluarkan bayaran balik pendua. Dasar percubaan semula

Soalan untuk dijawab sebelum aliran kerja foto pertama

Adakah Jev menyunting atau menjana foto pemulangan?

Tidak. Imej ialah bukti bagi penilaian atau kawasan cadangan. Aplikasi anda melukis tindihan atau membuat potongan menggunakan kod pemprosesan imej biasa. Simpan sumber asal tanpa perubahan secara berasingan; segi empat berguna tidak menggantikan bukti asal.

Mengapa contoh menetapkan 1.14 dan bukannya menggunakan latest?

Jadual alias terbitan kini memetakan jev-latest kepada 1.13, sedangkan Box memerlukan 1.14. Menetapkan jev-1.14.0 menjadikan kebergantungan itu nyata. Semak nota keluaran dan set ujian sebelum menukar versi; jangan anggap kemas kini alias mengekalkan tingkah laku.

Bolehkah kebarangkalian kerosakan tinggi mencetuskan bayaran balik?

Tidak dengan bukti itu sahaja. Kebarangkalian berkenaan soalan yang ditanya tentang imej dihantar; ia tidak mengesahkan pesanan, menentukan tanggungjawab atau menggunakan dasar bayaran balik. Mulakan sebagai bantuan semakan, sahkan contoh yang mewakili dan kekalkan keputusan manusia bagi tindakan berakibat.

Adakah output percuma bermakna permintaan imej tiada kos?

Tidak. Token input, termasuk token imej, dikenakan bayaran. Kadar diterbitkan bukan harga setiap foto kerana formula anggaran token imej belum didokumenkan. Periksa penggunaan yang dilaporkan semasa projek rintis dibenarkan dan masukkan percubaan semula serta masa semakan dalam jumlah kos.

Bolehkah saya menghantar video produk atau PDF terus?

Bukan melalui antara muka imej pegun yang didokumenkan. Aplikasi anda perlu mengekstrak bingkai sesuai, teks atau halaman yang dirender terlebih dahulu dengan kebenaran pemprosesan. Penyediaan bingkai menghilangkan maklumat masa dan audio, jadi tanyakan hanya perkara yang boleh dijawab oleh bukti diberikan.

Kesimpulannya: arahkan perhatian sebelum menyerahkan kuasa

Pratonton imej Jev membawa cadangan praktikal: tukarkan bukti visual kepada jawapan kecil yang boleh diperiksa perisian. Alat pemulangan cawan boleh menguji cadangan itu dengan memisahkan kehadiran, kerosakan, lokasi dan semakan. Hasil pertama paling bernilai bukan bayaran balik autonomi, tetapi penyemak membuat keputusan yang lebih disokong dengan pencarian yang kurang.

Itulah ukuran yang berbaloi: adakah kawasan cadangan membantu seseorang memahami bukti asal, termasuk apabila model tersilap?

Sumber dan skop

Sumber primer disemak pada 18 Oktober 2026: pengumuman TypeSafe 14 Oktober, model dan harga, had imej dan bil, kontrak Box, contoh JavaScript dan nota keluaran SDK. Sumber dasar dan kebolehpercayaan tambahan dipautkan bersebelahan dakwaan berkaitan. Aliran kerja dan rajah ialah adaptasi penerangan, bukan penanda aras hands-on; tiada panggilan model berbayar dibuat untuk artikel ini. Rajah ialah karya asli, bukan media vendor yang disalin.

Simpan sumber bersama kesimpulan

Untuk penyelidikan model sendiri, simpan sumber asal berasingan daripada kesimpulan yang dibuat daripadanya. Cipta akaun Telli.sh untuk menyusun bahan penyelidikan dan nota terbitan sambil mengekalkan konteks sumbernya.