sharpapi laravel client
v1.2.2
Lihat selengkapnya di Situs Web SharpAPI.com »
PHP >= 8.1
Laravel >= 9.0
Jika Anda tidak menggunakan Laravel maka Anda dapat menemukan Klien PHP SharpAPI Generik di sini »
Ikuti langkah-langkah berikut untuk menginstal dan menyiapkan paket Klien SharpAPI Laravel.
Instal paket melalui composer :
komposer membutuhkan sharpapi/sharpapi-laravel-client
Daftar di SharpAPI.com dan dapatkan kunci API.
Setel kunci API di dalam .env
SHARP_API_KEY=kunci
[OPTIONAL] Publikasikan file konfigurasi sharpapi-client.php .
Catatan: Anda tidak perlu lagi memublikasikan file konfigurasi untuk menggunakan paket ini. Secara default, paket akan menggunakan nilai default yang masuk akal. Anda hanya perlu mempublikasikan konfigurasi jika ingin menyesuaikannya.
vendor tukang php: terbitkan --tag=sharpapi-laravel-client
? perdagangan elektronik
Hasilkan pengenalan produk yang menarik dengan cepat untuk menarik pelanggan.
Secara otomatis membuat email terima kasih yang dipersonalisasi untuk meningkatkan pengalaman pelanggan.
Sederhanakan kategorisasi produk untuk katalog yang terorganisir dengan baik.
Analisis Sentimen: Memahami dan menganalisis sentimen dalam ulasan produk untuk pengambilan keputusan berdasarkan data.
️ Otomatisasi Konten & Pemasaran
Terjemahkan teks dengan mudah untuk audiens global.
Parafrase dan koreksi teks apa pun (termasuk pemeriksaan tata bahasa)
Deteksi Konten Spam: Identifikasi dan filter konten spam secara efektif.
Ekstraksi Informasi Kontak: Ekstrak nomor telepon dan alamat email dari format non-standar untuk komunikasi yang efisien.
Hasilkan ringkasan singkat dan kata kunci/tag unik untuk meningkatkan konsumsi konten.
Tingkatkan upaya SEO dengan secara otomatis menghasilkan tag META berdasarkan konten.
Teknologi SDM
Hasilkan deskripsi pekerjaan yang kompleks dengan mudah, menghemat waktu dalam proses perekrutan.
Keterampilan dan Wawasan Posisi: Identifikasi posisi pekerjaan dan keterampilan terkait untuk menyederhanakan perekrutan.
Penguraian Resume Otomatis: Mengurai dan mengekstrak informasi dari file resume secara efisien untuk memudahkan pemrosesan.
Perjalanan, Pariwisata & Perhotelan
Analisis sentimen dalam ulasan perjalanan untuk meningkatkan layanan.
Sederhanakan kategorisasi untuk produk tur, aktivitas, dan perhotelan.
Silakan merujuk ke pejabat:
Dokumentasi API
Dukungan Multi-Bahasa : Mendukung 80 bahasa untuk setiap konten atau titik akhir API analisis data. Periksa daftarnya di sini.
Format RESTful yang Mudah Digunakan : Dengan kumpulan titik akhir terstandarisasi - dapatkan wawasan berharga melalui titik akhir analisis, yang mencakup kategori produk, keterampilan, dan posisi pekerjaan, serta memberikan skor yang relevan.
Format data yang selalu sama dan bersih : Yakinlah dengan format JSON yang konsisten dan dapat diprediksi untuk semua data yang dikembalikan. Tidak perlu khawatir dengan data AI yang kabur.
Dukungan Teknis : Dibuat oleh pengembang untuk pengembang, kami memberikan bantuan berkelanjutan sepanjang perjalanan Anda.
Anda dapat menyuntikkan kelas SharpApiService atau menggunakan fasad tunggal SharpApiService .
Kami menyarankan Anda untuk menggunakan sistem antrian Laravel untuk mengoptimalkan pekerjaan yang dikirim dan proses pemeriksaan hasilnya, terutama jika Anda memproses data dalam jumlah besar.
Kasus penggunaan umum memerlukan langkah-langkah berikut:
Mengirimkan salah satu metode pemrosesan AI yang tersedia (ini akan mengembalikan URL status pemrosesan tugas)
Jalankan metode fetchResults($statusUrl) yang beroperasi dalam mode polling, mengirimkan permintaan di bawahnya setiap 10 detik selama 180 detik (nilai ini dapat disesuaikan).
Objek SharpApiJob akan dikembalikan.
Untuk pekerjaan yang selesai dengan status pengembalian success , Anda dapat memperoleh hasilnya dengan salah satu metode, misalnya $jobResultJson = $jobResult->getResultJson() .
Setiap pekerjaan yang dikirim biasanya memakan waktu antara beberapa detik hingga satu menit.
Setelah jangka waktu tersebut, pekerjaan yang dikembalikan biasanya akan berstatus success dan hasilnya akan tersedia untuk diproses lebih lanjut. Setiap metode API mengembalikan format pengembalian yang berbeda. Buka Daftar metode/titik akhir API di bawah untuk detailnya»
API kami menjamin untuk mengembalikan format yang benar setiap saat. Mesin AI yang digunakan SharpAPI dalam kasus yang jarang terjadi memiliki kecenderungan untuk berperilaku buruk dan kehabisan waktu atau mengembalikan data yang salah. Dalam kasus tersebut, status pengembalian pekerjaan akan menjadi failed . Anda dapat menjalankan kembali permintaan pekerjaan yang sama persis dalam kasus tersebut.
Selama pekerjaan masih diproses oleh mesin kami, maka statusnya akan tetap pending .
<?phpnamespace AppHttpControllers;gunakan GuzzleHttpExceptionGuzzleException;gunakan SharpAPISharpApiServiceSharpApiService;kelas SharpTest memperluas Pengontrol{fungsi publik __construct(public SharpApiService $sharpApiService)
{
}/** * @throws GuzzleException */public function detector_phones(): void{$statusUrl = $this->sharpApiService->detectPhones('Di mana menemukan kami? Hubungi penasihat teknis penjualan: Hubungi: 1800-394-7486 atau kantor kami di Singapura +65 8888 8888'); $hasil = $ini->sharpApiService->fetchResults($statusUrl); dd($result->getResultJson());/* dikembalikan: [ { "detected_number": "1800-394-7486", "parsed_number": "+18003947486" }, { "detected_number": "+65 8888 8888" , "angka_yang diurai": "+6588888888" } ] */}
}Permintaan HTTP yang mendasarinya difasilitasi oleh Laravel HTTP Client/Guzzle, sehingga disarankan untuk membiasakan diri Anda dengan Pengecualian Guzzle yang umum.
gunakan GuzzleHttpExceptionClientException;// Langkah 1: kirim pekerjaan ke API dengan salah satu metode, misalnya:coba {$statusUrl = SharpApiService::summarizeText($text, 'Jerman', // opsional bahasa500, // panjang opsional' nada suara netral' // nada suara opsional
);// nilai contoh $statusUrl: 'http://sharpapi.com/api/v1/job/status/75acb6dc-a975-4969-9ef1-c62cebc511cb'} catch (ClientException $e) { $e->getResponse( )
}// Langkah 2: meminta untuk memeriksa status tugas dalam mode polling dan menunggu hasilnya$jobResult = SharpApiService::fetchResults($statusUrl);// Langkah 3: dapatkan hasil tugas API yang dikirim, dengan ini mengembalikan hasil tugas sebagai JSON$jobResultJson = $jobResult->getResultJson();// ..atau array PHP:$jobResultArray = $jobResult->getResultArray();// ..atau PHP stdClass:$jobResultObject = $jobResult->getResultObject(); Jadi Anda bisa menimpa nilai-nilai ini dengan pengaturan .env :
SHARP_API_KEY=XXX_key_XXXSHARP_API_JOB_STATUS_POLLING_WAIT=200SHARP_API_JOB_STATUS_USE_POLLING_INTERVAL=trueSHARP_API_JOB_STATUS_POLLING_INTERVAL=5SHARP_API_BASE_URL=MOCK_SERVER
Setiap metode selalu mengembalikan objek SharpApiJob , dimana metode getResultJson / getResultArray / getResultObject -nya akan mengembalikan struktur data yang berbeda. Silakan lihat contoh detail yang disediakan di SharpAPI.com
Untuk metode yang memiliki parameter language , Anda juga dapat menggunakan nilai Enum SharpApiLanguages agar kode Anda lebih mudah dibaca.
Mengurai file resume (CV) dari berbagai format (PDF/DOC/DOCX/TXT/RTF) dan mengembalikan objek titik data yang luas.
Parameter bahasa keluaran opsional juga dapat disediakan (nilai English ditetapkan sebagai default).
$statusUrl = SharpApiService::parseResume('/test/resume.pdf', 'Bahasa Inggris'); Berdasarkan daftar parameter ekstensif, titik akhir ini memberikan rincian pekerjaan ringkas dalam format respons, termasuk deskripsi singkat, persyaratan pekerjaan, dan tanggung jawab pekerjaan. Satu-satunya parameter wajib adalah name .
Fungsionalitas ini menggunakan parameter kelas DTO khusus ( Data Transfer Object ) bernama JobDescriptionParameters untuk membantu validasi parameter input. Hanya parameter name di konstruktor DTO ini yang wajib diisi.
Anda dapat mengatur gaya penulisan pilihan Anda dengan memberikan parameter voice_tone. Bisa berupa kata sifat seperti funny atau joyous , atau bahkan nama seorang penulis terkenal.
Metode API ini juga menyediakan parameter konteks opsional, yang dapat digunakan untuk memberikan instruksi tambahan yang fleksibel untuk pemrosesan konten.
$jobDescriptionParameters = JobDescriptionParameters baru(
nama: "Insinyur Senior PHP",
nama_perusahaan: "ACME LTD", // pengalaman_kerja_minimum opsional: "5 tahun", // pendidikan_minimum opsional: "Gelar Sarjana", // tipe_pekerjaan opsional: "penuh waktu", // keterampilan_yang diperlukan opsional: ['PHP8', 'Laravel'], // opsionaloptional_skills: ['AWS', 'Redis'], // opsionalnegara: "Inggris", // opsionalremote: true, // opsionalvisa_sponsored: true, // opsionalvoice_tone: 'Profesional dan Culun', // konteks nada suara opsional: null, // konteks opsional, instruksi pemrosesan AI tambahanbahasa: null // bahasa keluaran opsional
);$statusUrl = SharpApiService::generateJobDescription($jobDescriptionParameters);Menghasilkan daftar keterampilan terkait dengan bobotnya sebagai nilai mengambang (1,0-10,0) dengan 10 sama dengan 100%, skor relevansi tertinggi.
Hanya parameter pertama ( name ) yang diperlukan.
Anda dapat membatasi output dengan parameter max_quantity .
$statusUrl = SharpApiService::relatedSkills('MySQL', 'Bahasa Inggris', // bahasa opsional10 // kuantitas opsional
);Menghasilkan daftar posisi pekerjaan terkait dengan bobotnya sebagai nilai mengambang (1,0-10,0) dengan 10 sama dengan 100%, skor relevansi tertinggi.
Hanya parameter pertama ( name ) yang diperlukan.
Anda dapat membatasi output dengan parameter max_quantity .
$statusUrl = SharpApiService::relatedJobPositions('Senior PHP Engineer', 'Bahasa Inggris', // bahasa opsional10 // kuantitas opsional
);Mengurai review produk pelanggan dan memberikan sentimennya (POSITIF/NEGATIF/NETRAL) dengan skor antara 0-100%. Bagus untuk pemrosesan laporan sentimen untuk toko online mana pun.
$statusUrl = SharpApiService::productReviewSentiment('isi ulasan pelanggan');Menghasilkan daftar kategori yang sesuai untuk produk dengan bobot relevansi sebagai nilai mengambang (1,0-10,0) dengan 10 sama dengan 100%, skor relevansi tertinggi. Berikan nama produk dan parameternya untuk mendapatkan kecocokan kategori terbaik. Berguna dalam mengisi data katalog produk dan pemrosesan produk massal.
Anda dapat membatasi output dengan parameter max_quantity .
Anda dapat mengatur gaya penulisan pilihan Anda dengan memberikan parameter voice_tone . Bisa berupa kata sifat seperti funny atau joyous , atau bahkan nama seorang penulis terkenal.
Dalam konteks parameter opsional tambahan, Anda dapat memberikan daftar kategori lain yang akan dipertimbangkan selama proses pemetaan (misalnya kategori e-niaga Anda saat ini).
$statusUrl = SharpApiService::productCategories('Sony Playstation 5', 'Bahasa Inggris', // bahasa opsional5, // kuantitas opsional'Ahli teknologi', // nada suara opsional'Konsol Game, Konsol PS5' // konteks opsional, kategori saat ini untuk dicocokkan
);Menghasilkan versi deskripsi produk yang lebih pendek. Berikan sebanyak mungkin detail dan parameter produk untuk mendapatkan pengenalan pemasaran terbaik. Berguna dalam mengisi data katalog produk dan pemrosesan produk massal.
Anda dapat membatasi keluaran dengan parameter max_length . Harap diingat bahwa max_length berfungsi sebagai saran yang kuat untuk Model Bahasa, bukan persyaratan ketat, untuk mempertahankan gambaran umum dari hasilnya.
Anda dapat mengatur gaya penulisan pilihan Anda dengan memberikan parameter voice_tone . Bisa berupa kata sifat seperti funny atau joyous , atau bahkan nama seorang penulis terkenal.
$statusUrl = SharpApiService::generateProductIntro('Sony Playstation 5', SharpApiLanguages::ENGLISH, // bahasa opsional300, // panjang opsional'Lucu' // nada suara opsional
);Menghasilkan email terima kasih yang dipersonalisasi kepada pelanggan setelah pembelian. Konten respons tidak berisi judul, salam, atau informasi pengirim di bagian akhir, sehingga Anda dapat mempersonalisasi email lainnya dengan mudah.
Anda dapat membatasi keluaran dengan parameter max_length. Harap diingat bahwa max_length berfungsi sebagai saran yang kuat untuk Model Bahasa, bukan persyaratan ketat, untuk mempertahankan gambaran umum dari hasilnya.
Anda dapat mengatur gaya penulisan pilihan Anda dengan memberikan parameter voice_tone . Bisa berupa kata sifat seperti lucu atau gembira, atau bahkan nama seorang penulis terkenal.
Metode API ini juga menyediakan parameter konteks opsional, yang dapat digunakan untuk memberikan instruksi tambahan yang fleksibel untuk pemrosesan konten.
$statusUrl = SharpApiService::generateThankYouEmail('Sony Playstation 5', SharpApiLanguages::ENGLISH, // bahasa opsional250, // panjang opsional'Netral', // nada suara opsional'Harus mengundang pelanggan untuk berkunjung lagi sebelum Hari Libur' // opsional konteks
); Menerjemahkan teks yang disediakan ke bahasa yang dipilih. 80 bahasa didukung. Silakan periksa kelas Enum SharpApiLanguages yang disertakan untuk detailnya.
Anda dapat mengatur gaya penulisan pilihan Anda dengan memberikan parameter voice_tone . Bisa berupa kata sifat seperti lucu atau gembira, atau bahkan nama seorang penulis terkenal.
Parameter context opsional juga tersedia. Ini dapat digunakan untuk memberikan lebih banyak konteks pada teks terjemahan, seperti contoh kasus penggunaan atau beberapa penjelasan tambahan.
$statusUrl = SharpApiService::translate('turn', SharpApiLanguages::FRENCH, // bahasa opsional'netral', // nada suara opsional'untuk membalik halaman' // konteks opsional
);// akan menghasilkan :// {"content": "tourner", "to_lingual": "French", "from_lingual": "English"} Menghasilkan versi parafrase dari teks yang disediakan. Hanya parameter content yang diperlukan. Anda dapat menentukan bahasa keluaran, panjang karakter maksimum, dan nada suara.
Petunjuk tambahan tentang cara memproses teks dapat diberikan di parameter konteks. Harap diingat bahwa max_length berfungsi sebagai saran yang kuat untuk Model Bahasa, bukan persyaratan ketat, untuk mempertahankan gambaran umum dari hasilnya.
Anda dapat mengatur gaya penulisan pilihan Anda dengan memberikan parameter voice_tone opsional. Bisa berupa kata sifat seperti funny atau joyous , atau bahkan nama seorang penulis terkenal.
Metode API ini juga menyediakan parameter context opsional, yang dapat digunakan untuk memberikan instruksi tambahan yang fleksibel untuk pemrosesan konten.
$statusUrl = SharpApiService::paraphrase($text, SharpApiLanguages::FRENCH, // bahasa opsional500, // panjang opsional'netral', // nada suara opsional'hindari penggunaan singkatan' // konteks opsional
);Mengoreksi (dan memeriksa tata bahasa) teks yang disediakan.
$statusUrl = SharpApiService::proofread($text);
Memeriksa apakah konten yang disediakan lolos uji penyaringan spam. Memberikan persentase skor kepercayaan dan penjelasan apakah dianggap spam atau tidak. Informasi ini berguna bagi moderator untuk membuat keputusan akhir.
$statusUrl = SharpApiService::detectSpam($text);
Mengurai teks yang disediakan untuk nomor telepon apa pun dan mengembalikan versi asli yang terdeteksi dan format E.164-nya. Mungkin berguna dalam hal memproses dan memvalidasi sejumlah besar data terhadap nomor telepon atau biaya jika Anda ingin mendeteksi nomor telepon di tempat yang tidak seharusnya.
$statusUrl = SharpApiService::detectPhones($text);
Parsing teks yang disediakan untuk kemungkinan email apa pun. Mungkin berguna saat memproses dan memvalidasi sejumlah besar data terhadap alamat email atau biaya jika Anda ingin mendeteksi email di tempat yang tidak seharusnya.
$statusUrl = SharpApiService::detectEmails($text);
Menghasilkan daftar kata kunci/tag unik berdasarkan konten yang disediakan.
Anda dapat membatasi output dengan parameter max_quantity .
Anda dapat mengatur gaya penulisan pilihan Anda dengan memberikan parameter voice_tone .
$statusUrl = SharpApiService::generateKeywords($teks, 'Bahasa Inggris', // bahasa opsional5, // panjang opsional 'Aneh & Penasaran', // nada suara opsional'tambahkan emoji!' // petunjuk konteks tambahan opsional untuk pemrosesan konten );
Menghasilkan versi ringkasan dari konten yang disediakan. Sempurna untuk menghasilkan pengenalan pemasaran dari teks yang lebih panjang.
Anda dapat membatasi keluaran dengan parameter max_length . Harap diingat bahwa max_length berfungsi sebagai saran yang kuat untuk Model Bahasa, bukan persyaratan ketat, untuk mempertahankan gambaran umum dari hasilnya.
Anda dapat mengatur gaya penulisan pilihan Anda dengan memberikan parameter voice_ton e. Bisa berupa kata sifat seperti funny atau joyous , atau bahkan nama seorang penulis terkenal.
$statusUrl = SharpApiService::summarizeText($text, 'Bahasa Inggris', // bahasa opsional'David Attenborough', // nada suara opsional'tambahkan emoji!' // petunjuk konteks tambahan opsional untuk pemrosesan konten );
Menghasilkan semua tag META terpenting berdasarkan konten yang disediakan. Pastikan untuk menyertakan link ke situs web dan URL gambar untuk mendapatkan tag sebanyak mungkin.
Anda dapat mengatur gaya penulisan pilihan Anda dengan memberikan parameter voice_ton e. Bisa berupa kata sifat seperti funny atau joyous , atau bahkan nama seorang penulis terkenal.
$statusUrl = SharpApiService::generateSeoTags($teks, 'Bahasa Inggris', // bahasa opsional'David Attenborough' // nada suara opsional );
Mengurai review produk Travel/Hospitality dan memberikan sentimennya (POSITIF/NEGATIF/NETRAL) dengan skor antara 0-100%. Bagus untuk pemrosesan laporan sentimen untuk toko online mana pun.
$statusUrl = SharpApiService::travelReviewSentiment($teks);
Menghasilkan daftar kategori yang sesuai untuk produk Tur & Aktivitas dengan bobot relevansi sebagai nilai mengambang (1,0-10,0) dengan 10 sama dengan 100%, skor relevansi tertinggi. Berikan nama produk dan parameternya untuk mendapatkan kecocokan kategori terbaik. Berguna dalam mengisi data katalog produk dan pemrosesan produk massal. Hanya parameter pertama productName yang diperlukan.
Anda dapat membatasi output dengan parameter max_quantity .
Anda dapat mengatur gaya penulisan pilihan Anda dengan memberikan parameter voice_tone . Bisa berupa kata sifat seperti funny atau joyous , atau bahkan nama seorang penulis terkenal.
Dalam context parameter opsional tambahan, Anda dapat memberikan daftar kategori lain yang akan dipertimbangkan selama proses pemetaan (misalnya kategori e-commerce Anda saat ini).
$statusUrl = SharpApiService::toursAndActivitiesProductCategories('Oasis of the Bay''Ha Long', // kota opsional'Vietnam', // negara opsional'Bahasa Inggris', // bahasa opsional10, // kuantitas opsional'Petualang', // nada suara opsional 'Hotel Bay, Hotel Ha Long' // konteks opsional, kategori saat ini untuk dicocokkan
); Menghasilkan daftar kategori yang sesuai untuk produk jenis Perhotelan dengan bobot relevansi sebagai nilai mengambang (1,0-10,0) di mana 10 sama dengan 100%, skor relevansi tertinggi. Berikan nama produk dan parameternya untuk mendapatkan kecocokan kategori terbaik. Berguna dalam mengisi data katalog produk dan pemrosesan produk massal. Hanya parameter pertama productName yang diperlukan.
Anda dapat membatasi output dengan parameter max_quantity .
Anda dapat mengatur gaya penulisan pilihan Anda dengan memberikan parameter voice_tone . Bisa berupa kata sifat seperti funny atau joyous , atau bahkan nama seorang penulis terkenal.
Dalam context parameter opsional tambahan, Anda dapat memberikan daftar kategori lain yang akan dipertimbangkan selama proses pemetaan (misalnya kategori e-commerce Anda saat ini).
$statusUrl = SharpApiService::hospitalityProductCategories('Hotel Crystal 大人専用''Tokyo', // kota opsional'Jepang', // negara opsional'Bahasa Inggris', // bahasa opsional10, // kuantitas opsional'Petualang', // opsional nada suara 'Hotel Tokyo, Hotel Crystal' // konteks opsional, kategori saat ini untuk dicocokkan
);Titik akhir untuk memeriksa detail mengenai periode langganan saat ini
$statusUrl = SharpApiService::quota();
akan menghasilkan:
{"timestamp": "2024-03-19T12:49:41.445736Z","on_trial": false,"trial_ends": "2024-03-17T07:57:46.000000Z","subscribed": true,"current_subscription_start" : "2024-03-18T12:37:39.000000Z","current_subscription_end": "2024-04-18T12:37:39.000000Z","subscription_words_quota": 100000,"subscription_words_used": 9608,"subscription_words_used_percentage": 0.1} subscription_words_used_percentage adalah persentase penggunaan kuota bulanan saat ini dan mungkin berfungsi sebagai peringatan bagi pengguna tentang kredit yang habis. Dengan nilai di atas 80%, disarankan untuk berlangganan lebih banyak pulsa di https://sharpapi.com/dashboard/credits untuk menghindari gangguan layanan.
Nilai-nilai ini juga tersedia di Dasbor di https://sharpapi.com/dashboard
Titik akhir PING sederhana untuk memeriksa ketersediaan API dan zona waktu internalnya (stempel waktu).
$statusUrl = SharpApiService::ping();
akan menghasilkan:
{ "ping": "pong", "stempel waktu": "2024-03-12T08:50:11.188308Z"}Harap beri tahu kami melalui GitHub »
atau Bergabunglah dengan Grup Telegram kami »
Silakan lihat CHANGELOG untuk informasi lebih lanjut tentang apa yang berubah baru-baru ini.
A2Z WEB LTD
Dawid Makowski
Tingkatkan kemampuan Laravel AI Anda!
Lisensi MIT (MIT). Silakan lihat File Lisensi untuk informasi lebih lanjut.
Untuk berita, tutorial, dan studi kasus terkini, jangan lupa untuk mengikuti kami di:
SharpAPI X (sebelumnya Twitter)
TajamAPI YouTube
SharpAPI Vimeo
LinkedIn SharpAPI
Facebook SharpAPI
