Kunci API
Buat, tinjau, dan cabut API key organisasi Anda.
Kunci API memungkinkan sistem lain memulai workflow Anda melalui Partner API — tidak ada yang perlu membuka Morphic agar sebuah run terjadi. Itu Kunci API tab ini hanya terlihat oleh admin.
Langsung ke sana: studio.morphic.com/settings/api-keys
Sebuah kunci milik organisasi
Bukan kepada orang yang membuatnya. Kunci itu tetap berfungsi saat mereka pergi, setiap admin dapat melihatnya tercantum dan dapat mencabutnya, dan setiap run yang dimulainya ditagihkan ke organisasi.
Buat kunci
Buka tab tersebut
Buka dropdown organisasi (logo Morphic, kiri atas), pilih Settings, lalu klik Kunci API di bilah sisi kiri.
Klik kunci baru
Beri nama yang akan Anda kenali dalam sebulan — sistem tempat kunci itu berada, bukan "key 2".
Pilih cakupannya
Ada tiga yang ditawarkan, dan formulir dimulai dengan ketiganya terpilih karena integrasi partner biasanya membutuhkan ketiganya. Batalkan pilihan yang tidak boleh dilakukan oleh kunci.
workflows:read— membaca sebuah workflow dan input yang diperlukannyaruns:write— memulai run, dan mendaftarkan endpoint webhookruns:read— membaca status run dan aset yang telah selesai, serta mencantumkan endpoint webhook
Batasi ke workflow tertentu
Opsional, dan layak dilakukan. Centang Batasi kunci ini ke workflow tertentu dan pilih workflow tersebut. Run apa pun selain itu akan ditolak, yang membatasi dampak jika kunci bocor. Jika tidak dicentang, kunci dapat menjalankan semua workflow yang bisa dijalankan organisasi.
Tetapkan batas kreditnya
Total wajib diisi — kunci harus memiliki batas maksimum yang tidak bisa dilampauinya. Batas per hari dan per bulan bersifat opsional; kosongkan salah satunya untuk membiarkan jendela itu tanpa batas.
Pilih total berdasarkan berapa banyak yang seharusnya dapat dihabiskan integrasi sebelum seseorang memeriksanya lagi, bukan berdasarkan apa yang akan dihabiskannya — ini adalah pemutus sirkuit, bukan anggaran. Batas jendela tidak bisa lebih tinggi daripada total, karena total akan berlaku lebih dulu.
Kredit untuk run yang dimulai dengan kunci ini ditagihkan ke organisasi dan dihitung terhadap batas kunci tersebut. Run yang dimulai kunci ini tetap dihitung terhadapnya meskipun seseorang kemudian masuk ke chat dan mengambil alih — kalau tidak, rekan kerja yang menjawab satu pertanyaan akan memindahkan sisa run ke pool umum organisasi. Batas kredit orang itu sendiri, jika mereka memilikinya, tetap berlaku juga.
Satu hari adalah hari UTC dan satu bulan adalah bulan kalender UTC. Tagihan yang akan membuat kunci melampaui salah satu batasnya akan ditolak, dan pesan akan menyebutkan kunci serta batas yang dilanggarnya.
Pilih masa kedaluwarsa
Tidak pernah, 30 hari, 90 hari, atau setahun. Kunci yang kedaluwarsa berhenti mengautentikasi dengan sendirinya, yang merupakan bentuk rotasi termurah.
Salin rahasianya
Rahasia ditampilkan sekali. Morphic hanya menyimpan hash-nya, jadi tidak bisa ditampilkan lagi. Salin ke pengelola rahasia Anda sebelum menutup dialog.
Siapa pun yang memegang kunci dapat memulai run yang menghabiskan kredit organisasi Anda. Jangan pernah memasukkannya ke repositori, jangan pernah menaruhnya di browser, jangan pernah mengirimkannya lewat email atau chat. Jika bocor, cabut — itulah fungsi tab ini.
Yang ditampilkan dalam daftar
Setiap kunci menampilkan namanya, apakah itu kunci live atau test, karakter awal rahasianya (cukup untuk dicocokkan dengan catatan Anda sendiri), cakupannya, berapa banyak workflow yang bisa dijalankannya, batas kreditnya, dan kapan terakhir digunakan. Kunci yang kedaluwarsa dan dicabut tetap tercantum agar Anda bisa melihat apa yang terjadi padanya.
Sebuah organisasi dapat memiliki hingga 10 kunci yang dapat mengautentikasi sekaligus. Kunci yang kedaluwarsa dan dicabut tidak dihitung dalam batas itu.
Ubah batas kredit sebuah kunci
- Temukan kunci di daftar.
- Klik menu '…' di sampingnya dan pilih Edit batas.
- Ubah total, atau batas per hari atau per bulan — kosongkan batas untuk menghapusnya — lalu simpan.
Batas baru berlaku sejak tagihan berikutnya pada kunci tersebut, termasuk pada run yang sudah dimulainya. Itulah perbaikan ketika sebuah run berhenti pada batas kunci, dan ini juga berfungsi pada kunci yang dicabut: run-nya tetap membebani kunci itu, jadi menurunkan batasnya adalah cara untuk menghentikannya.
Cabut kunci
- Temukan kunci di daftar.
- Klik menu '…' di sampingnya dan pilih Cabut kunci.
- Konfirmasi.
Panggilan yang menggunakan kunci ini akan mulai gagal dalam hitungan detik. Run yang sudah berjalan akan selesai dan tetap ditagihkan. Pencabutan tidak dapat dibatalkan — untuk rotasi, buat penggantinya terlebih dahulu, alihkan lalu lintas Anda ke sana, lalu cabut yang lama.
Tempat pengeluaran muncul
Kredit untuk run yang dimulai melalui API ditagihkan ke organisasi dan diatribusikan ke kunci yang memulainya. Lihat itu di bawah Penagihan & penggunaan → Aktivitas kredit.
Konektor
Cara menghubungkan Google Drive dan akun ElevenLabs organisasi Anda ke Morphic, serta mengelola koneksi tersebut.
Penagihan & penggunaan
Tab Penagihan memungkinkan Anda mengelola paket, melihat dan mengubah detail pembayaran, memeriksa riwayat invoice, dan mendapatkan gambaran umum tentang paket serta detail perpanjangan Anda.