Jev Kini Memahami Foto: Dari Pemeriksaan Retur hingga Menemukan Kerusakan

Diagram penjelas orisinal: foto masuk, penilaian dan koordinat terpisah keluar, lalu seseorang meninjau usulan kerusakan. Ini menggambarkan alur kerja, bukan hasil model yang direkam.

Seorang pelanggan memotret mug yang sumbing. Alat dukungan perlu menjawab tiga pertanyaan berbeda: apakah mug terlihat, apakah foto menunjukkan kerusakan, dan di mana peninjau sebaiknya melihat? Paragraf lancar tentang keramik bukan hasil antara yang paling berguna.

Pada 14 Oktober 2026, TypeSafe AI mengumumkan dukungan gambar eksperimental untuk Jev bersama Jev 1.14.0 dan tipe keluaran baru box. Gambar bekerja pada Jev 1.13 maupun 1.14; Box memerlukan 1.14. TypeSafe menyebut fitur ini eksperimental dan secara jelas belum merekomendasikannya untuk otomatisasi produksi. Pengumuman resmi

Perubahannya lebih terbatas daripada asisten multimodal serbaguna: foto dapat menjadi keputusan bertipe atau lokasi dalam program. Berikut dampaknya pada alur retur, masukan yang diterima antarmuka, dan cara membuat prototipe dengan hati-hati tanpa menganggap persegi panjang sebagai bukti.

Ringkasnya:

• Jev kini memiliki jalur eksperimental untuk memahami gambar diam, bukan membuat gambar.
• Tanyakan apakah sasaran ada sebelum mempercayai lokasi yang diusulkan.
• Pertahankan foto asli dan tinjauan manusia; biarkan kode memvalidasi koordinat, izin, dan konsekuensi.

Foto dapat menjadi keputusan, bukan sekadar deskripsi

Daya tarik Jev sejak awal adalah jawaban terbatas: memilih opsi yang disediakan, memberi skor berdasarkan tingkat yang dijelaskan, atau menilai proposisi ya/tidak. Panduan sebelumnya tentang model keputusan Jev membahas dasar tersebut. Perkembangan baru ialah mengajukan pertanyaan itu dengan bukti visual, sekaligus memperoleh koordinat spasial.

Untuk antarmuka retur, pembagian tugasnya berubah. Model dapat menyarankan bahwa kerusakan terlihat; kode aplikasi dapat menampilkan saran itu di samping gambar yang dikirim. Namun keduanya tidak membuktikan kapan kerusakan terjadi, apakah foto terkait dengan pesanan ini, atau apakah pengembalian dana diizinkan. Itu pertanyaan terpisah dengan bukti berbeda.

Batas ini mengikuti referensi model, kontrak permintaan API, dan SDK berkemampuan gambar. Sekumpulan PDF tidak otomatis menjadi pipeline pemrosesan dokumen hanya karena beberapa halamannya berisi gambar. Demikian pula, beberapa frame hasil ekstraksi tidak membuktikan pemahaman video native atau akses ke soundtrack klip.

Menurut kami, unit yang menarik adalah penilaian kecil yang dapat diperiksa dan ditautkan ke bukti. Ini bukan izin baru untuk mengotomatisasi semua langkah setelahnya.

Tiga contoh resmi mengubah foto sama menjadi pekerjaan berbeda

Dokumentasi JavaScript TypeSafe memberi tiga titik awal konkret. Itu contoh kode terbitan, bukan laporan penerapan pelanggan langsung atau hasil terukur. Perlakukan sebagai pola prototipe, bukan janji akurasi untuk foto Anda.

Contoh pertama menggabungkan klaim mug rusak dengan foto produk, lalu meminta Noul menilai kerusakan dan Score menilai tingkat keparahannya. Adaptasi untuk antrean dukungan dapat menempatkan dugaan kerusakan di urutan atas untuk diperiksa. Peninjau tetap perlu melihat foto lengkap, keterangan pelanggan, dan pilihan untuk menolak saran.

Contoh kedua membandingkan foto unggahan penjual dengan gambar katalog. Ia menanyakan apakah keduanya menunjukkan produk sama serta mengklasifikasikan kelayakan foto, termasuk buram, terpotong, dan adanya objek nonproduk. Untuk marketplace, ini menyarankan pemisahan berguna: pencocokan identitas dan mutu foto tak harus berbagi satu keputusan persetujuan. Foto jelas atas produk yang salah tidak boleh lolos hanya karena tampak profesional.

Contoh ketiga meminta Box mencari lokasi bagian yang rusak. Hasilnya dapat memandu overlay atau usulan potongan untuk peninjau. Pertahankan foto asli yang tidak dipotong; mempersempit perhatian bisa membantu memeriksa klaim, tetapi juga dapat menyembunyikan konteks yang mengubah makna.

Ikuti contoh resmi untuk penilaian kerusakan, perbandingan katalog, dan pelokalan kerusakan. Alur retur usulan kami menambahkan perlindungan di tingkat aplikasi; ini bukan laporan uji coba.

Kotak tidak dapat memberi tahu bahwa tak ada sasaran

Detail penting dalam kontrak Box TypeSafe: keluaran untuk sasaran yang tidak ada tidak tersedia. Pertanyaan Box menghasilkan empat sisi meskipun sasaran yang diminta tidak ada. Karena itu, kotak di sekitar mug utuh tidak dapat membuktikan kerusakan.

Tanyakan keberadaan sasaran secara terpisah dengan Noul. Untuk alur ini, bedakan keberadaan mug dari terlihatnya kerusakan. Jawaban positif tentang mug tidak cukup untuk mengizinkan overlay kerusakan. Abaikan kotak kerusakan yang diusulkan kecuali pemeriksaan keberadaan terkait lolos aturan validasi Anda.

Pemeriksaan keberadaan bukan obat mujarab. Kedua penilaian bisa salah bersamaan. Pantulan terang dapat tampak seperti serpihan, sementara retakan nyata bisa hilang pada glasir bercorak. Uji foto tanpa mug, mug utuh, pantulan ambigu, banyak objek, dan kerusakan yang terlihat jelas sebelum menentukan ambang.

Diagram keputusan orisinal: persegi panjang yang valid hanya berguna setelah pemeriksaan keberadaan sasaran lolos. Pemeriksaan gagal atau tidak pasti mempertahankan foto asli untuk tinjauan manusia, bukan menjadi penolakan otomatis.

Anggap persegi panjang sebagai penunjuk, bukan putusan.

Perlakukan koordinat sebagai geometri, lalu periksa maknanya

Box mengembalikan left, right, top, dan bottom sebagai pecahan dimensi gambar, diukur dari sudut kiri atas. Nilainya antara 0 dan 1, dengan left < right dan top < bottom. Satu pertanyaan menghasilkan satu kotak, bukan daftar deteksi objek. Kontrak respons Box

Untuk gambar olahan 1200 x 900 sebagai contoh, tepi left 0.20, top 0.30, right 0.60, dan bottom 0.70 setara dengan tepi piksel 240, 270, 720, 630. Ini contoh hitung, bukan respons Jev. API crop umumnya mengharapkan urutan left, top, right, bottom; petakan nama bidang secara sengaja, jangan mengandalkan urutan properti JSON.

Validasi angka berhingga, batas, dan urutannya sebelum menggambar. Lalu periksa apakah wilayah itu benar-benar menunjukkan kerusakan. Jika foto diubah ukuran, diputar, diberi padding, atau dibagi tile, simpan transformasinya untuk memetakan koordinat kembali; bila tidak, kotak yang tampak masuk akal bisa menunjuk piksel yang salah.

Siapkan gambar sebelum permintaan, bukan setelah mendapat galat

Batas gambar resmi ditetapkan secara presisi dan inklusif. Gambar di luar batas ditolak, bukan diubah ukurannya otomatis; satu gambar yang ditolak menggagalkan seluruh permintaan.

Referensi berulang dihitung lagi dalam permintaan hasil ekspansi. Ukuran berkas, dimensi, dan panjang konteks merupakan pemeriksaan terpisah. Batas gambar

Diagram batasan orisinal berdasarkan dokumentasi gambar TypeSafe, diperiksa 18 Oktober 2026. Batas per berkas, gambar olahan, permintaan ekspansi, dan body permintaan berlaku masing-masing.

TypeSafe juga meminta piksel diputar tegak sebelum dikirim: API menghapus metadata dan tidak menerapkan orientasi EXIF. Konversikan format yang tidak didukung terlebih dahulu. Panduan persiapan

Untuk prototipe, siapkan salinan foto milik sendiri dengan nama jelas dan pertahankan aslinya. Periksa dimensi secara lokal dan pratinjau salinan persis yang akan dikirim. Potongan sempit mungkin perlu padding agar memenuhi dimensi minimum; catat padding itu sebelum menafsirkan koordinat.

Patok versi 1.14 dan nyatakan sakelar eksperimental

Per 18 Oktober, tabel alias terbitan memetakan jev-latest ke jev-1.13.0 dan jev-preview ke jev-1.14.0. Untuk contoh Box, patok jev-1.14.0, jangan berasumsi “latest” berarti pratinjau terbaru. Alias model

Prosedur berikut membuat contoh lokal untuk ditinjau saja. Menjalankan perintah terakhir mengirim permintaan inferensi berbayar, yang dapat dicoba ulang SDK; perintah itu tidak menyetujui retur atau mengubah akun. Gunakan foto mug uji milik Anda, tanpa orang, label pengiriman, alamat, atau dokumen privat.

1. Dapatkan akses dan pilih organisasi yang tepat. TypeSafe menyatakan pendaftaran tak lagi memerlukan persetujuan daftar tunggu. Buat kunci API di konsol dan periksa kredit organisasi sebelum menguji. Akses akun, pengaturan kredit

2. Gunakan Node.js 22 atau lebih baru. Rilis SDK JavaScript yang mendukung gambar adalah 0.7.0, bertanggal 14 Oktober. Mematoknya membuat dependensi klien contoh ini jelas. Log perubahan SDK

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

3. Atur kunci hanya untuk sesi ini. Di Windows PowerShell gunakan blok pertama; di macOS atau Linux Bash/Zsh gunakan blok kedua. Ganti placeholder secara lokal, jangan commit kunci sungguhan.

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

export TYPESAFE_API_KEY="your-api-key"

4. Siapkan owned-mug.jpg dan buat inspect-return.mjs. Adaptasi orisinal ini memakai helper SDK terdokumentasi. Header eksperimental dikonfigurasi sebelum permintaan gambar. Kedua ambang probabilitas di bawah merupakan aturan aplikasi ilustratif, bukan rekomendasi TypeSafe. Semua hasil tetap harus ditinjau 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 jika siap mengirim gambar dan menanggung pemakaian. Di ketiga sistem operasi, perintahnya node inspect-return.mjs. Pengecualian atau suggestedBox: null harus tetap menyisakan gambar asli untuk ditinjau, bukan memicu pengiriman otomatis berulang.

Pertanyaan berbagi satu permintaan, tetapi kotak diabaikan kecuali pemeriksaan aplikasi lolos. Perhitungan kotak yang tak terpakai tetap dikenai biaya. Desain berikutnya bisa membuat pelokalan sebagai permintaan kedua setelah pemeriksaan keberadaan, menukar satu perjalanan bolak-balik tambahan dengan penghindaran biaya pelokalan yang tidak perlu.

Harga token kecil bukan berarti harga per foto

Tarif terbitan untuk kedua versi adalah $0.042 per sejuta token masukan, dengan token keluaran gratis. Artinya 10 juta token masukan yang ditagihkan berharga $0.42; bukan berarti sepuluh juta gambar berharga demikian. Harga terbitan

Gambar dihitung sebagai token masukan dengan tarif teks, tanpa biaya gambar terpisah. TypeSafe belum menyediakan rumus estimasi token gambar dalam dokumentasinya. Gunakan usage.input_tokens dari respons saat menyusun anggaran evaluasi yang diizinkan; jangan mengarang biaya per foto. Penagihan gambar

Anggaran Anda perlu mencakup percobaan gagal, percobaan ulang, prapemrosesan, penyimpanan, dan waktu peninjau. Catat biaya bersama mutu: menghemat sebagian kecil sen tidak berguna bila potongan terlalu sempit membuat peninjau harus membuka ulang gambar asli setiap kali. Bandingkan keseluruhan tugas tinjauan dengan baseline manual sederhana.

Rancang untuk ketidakpastian, privasi, dan layanan yang sibuk

Noul mengembalikan probabilitas tanpa bidang confidence terpisah. Choice dan Score menyertakan distribusi serta nilai keyakinan turunan. Nilai itu menggambarkan ketidakpastian model; bukan sertifikat kebenaran menyeluruh. Dokumentasi confidence

Untuk alur mug, validasi pemeriksaan gerbang pada foto terpisah yang memiliki label kesepakatan. Kelompokkan keluaran serupa dan bandingkan dengan kebenaran yang diamati untuk memeriksa kalibrasi pada tugas Anda. Ukur kerusakan yang luput secara terpisah dari alarm palsu, dan bedakan overlay meleset dari keputusan pengembalian dana keliru. Evaluasi ulang ambang setelah model, pencahayaan, kategori produk, atau cara pengambilan foto berubah.

Jangan menganggap setiap gambar yang tidak lolos sebagai kesalahan pelanggan. Foto bisa kurang memadai karena kamera buruk, objek reflektif, atau cacat perlu dilihat dari sudut lain. Status tinjauan yang baik menawarkan pilihan mengirim foto lain atau pemeriksaan manual tanpa menyalahkan pelanggan atas ketidakpastian model.

TypeSafe menyatakan permintaan dan respons pelanggan tidak digunakan untuk melatih Jev. Pusat bantuannya juga menjelaskan pemrosesan dapat mencakup penyediaan layanan, penagihan, pencegahan penyalahgunaan, dan telemetri; retensi bergantung pada data, perjanjian, dan pengaturan zero-data-retention. Tidak dipakai untuk pelatihan bukan berarti tidak disimpan. Kebijakan penanganan data

Halaman status layanan publik mencantumkan geografi AS dan wilayah us-east-1, us-east-2, serta us-west-2. Tim dengan persyaratan residensi data regional sebaiknya memastikan lokasi pemrosesan sebelum mengunggah foto pelanggan; akses ke konsol bukan perjanjian residensi.

Minimalkan data sebelum mengunggah. Potong label alamat pada salinan olahan bila tidak relevan, batasi akses ke foto asli, dan jangan masukkan gambar atau rahasia ke log rutin. Tentukan retensi catatan tinjauan Anda secara terpisah dari kebijakan penyedia.

Batas organisasi mencakup permintaan dan token per detik. API mendokumentasikan 429 untuk pembatasan laju dan 529 untuk kelebihan beban; masukan cacat atau terlalu besar perlu diperbaiki, bukan dicoba ulang tanpa perubahan. Batas laju, galat API

Kebijakan percobaan ulang SDK JavaScript secara default melakukan dua percobaan ulang dan mengikuti header jeda yang didukung. Hindari menambah loop retry luar tanpa batas. Tetapkan batas waktu, pertahankan status galat yang bisa ditindaklanjuti, dan pisahkan tindakan bisnis di masa depan agar inferensi yang dicoba ulang tidak menerbitkan pengembalian dana ganda. Kebijakan retry

Pertanyaan sebelum alur kerja foto pertama

Apakah Jev mengedit atau membuat foto retur?

Tidak. Gambar menjadi bukti untuk penilaian atau usulan wilayah. Aplikasi Anda menggambar overlay atau membuat potongan dengan kode pengolahan gambar biasa. Simpan sumber asli tanpa perubahan; kotak berguna tidak menggantikan bukti asli.

Mengapa contoh mematok 1.14, bukan memakai latest?

Tabel alias terbitan saat ini memetakan jev-latest ke 1.13, sedangkan Box memerlukan 1.14. Mematok jev-1.14.0 membuat dependensi itu eksplisit. Tinjau ulang catatan rilis dan kumpulan pengujian sebelum mengganti versi; jangan menganggap perubahan alias mempertahankan perilaku.

Bisakah probabilitas kerusakan tinggi memicu pengembalian dana?

Tidak dengan aman hanya berdasarkan bukti itu. Probabilitas menjawab pertanyaan tentang gambar yang dikirim; angka tersebut tidak mengautentikasi pesanan, memastikan tanggung jawab, atau menerapkan kebijakan retur. Mulai sebagai bantuan peninjauan, validasi contoh representatif, dan pertahankan keputusan manusia untuk tindakan berkonsekuensi.

Apakah keluaran gratis berarti permintaan gambar tanpa biaya?

Tidak. Token masukan, termasuk token gambar, ditagihkan. Tarif terbitan bukan kutipan harga per foto karena rumus estimasi token gambar belum didokumentasikan. Periksa pemakaian yang dilaporkan dalam uji coba berizin dan masukkan percobaan ulang serta waktu peninjauan ke total biaya.

Bisakah saya mengirim video produk atau PDF langsung?

Tidak melalui antarmuka gambar diam terdokumentasi. Aplikasi harus lebih dulu mengekstrak frame, teks, atau halaman hasil render yang sesuai dan memiliki izin untuk memprosesnya. Mengambil satu frame menghilangkan informasi temporal dan audio, jadi ajukan hanya pertanyaan yang bisa dijawab oleh bukti tersebut.

Intinya: arahkan perhatian sebelum mendelegasikan kewenangan

Pratinjau gambar Jev menawarkan gagasan praktis: ubah bukti visual menjadi jawaban kecil yang dapat diperiksa perangkat lunak. Alat retur mug dapat menguji gagasan itu dengan memisahkan keberadaan, kerusakan, lokasi, dan peninjauan. Hasil pertama paling bernilai bukan pengembalian dana otonom, melainkan peninjau yang dapat membuat keputusan lebih berdasar dengan lebih sedikit pencarian.

Itulah standar yang patut diukur: apakah wilayah yang diusulkan membantu seseorang memahami bukti asli, termasuk saat model keliru?

Sumber dan cakupan

Sumber primer diperiksa 18 Oktober 2026: pengumuman TypeSafe 14 Oktober, model dan harga, batas dan penagihan gambar, kontrak Box, contoh JavaScript, dan catatan rilis SDK. Sumber kebijakan dan keandalan tambahan ditautkan dekat klaim terkait. Alur kerja dan diagram adalah adaptasi penjelas, bukan benchmark uji langsung; tidak ada panggilan model berbayar untuk artikel ini. Diagram orisinal, bukan media vendor salinan.

Simpan sumber bersama kesimpulan

Untuk riset model Anda, simpan sumber asli terpisah dari kesimpulan yang ditarik darinya. Buat akun Telli.sh untuk menata bahan riset dan catatan turunan sambil mempertahankan konteks sumber.