Kunci API
Buat, tinjau, dan cabut API key organisasi Anda untuk Direct API dan Partner API.
Kunci API memungkinkan sistem lain menggunakan Morphic tanpa ada yang membukanya: memulai alur kerja Anda melalui Partner API, atau membuat dan mengedit media melalui Direct API. Tab 'Kunci API' 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 Pengaturan, 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
Pilih hanya yang dibutuhkan kunci. Tiga yang pertama untuk Partner API, sisanya untuk Direct API, yang muncul setelah Morphic mengaktifkan Direct API untuk organisasi Anda.
workflows:read: membaca sebuah alur kerja dan input yang diperlukannyaruns:write: memulai run, dan mendaftarkan endpoint webhookruns:read: membaca status run dan aset yang telah selesai, serta mencantumkan endpoint webhookprojects:read: membaca proyek dan file di dalamnyaassets:read: mencari dan membaca asetassets:write: mengunggah aset dan mengeditnyagenerations:write: membuat gambar, video, dan audio, yang menghabiskan kredit
Lalu centang kotak untuk menyetujui Ketentuan Penggunaan Morphic, termasuk bagian API Developer.
Batasi ke alur kerja tertentu
Opsional, dan layak dilakukan. Centang 'Batasi kunci ini ke alur kerja tertentu' dan pilih alur kerja tersebut. Run apa pun selain itu akan ditolak, yang membatasi dampak jika kunci bocor. Jika tidak dicentang, kunci dapat menjalankan semua alur kerja yang bisa dijalankan organisasi.

Tetapkan batas kreditnya
Isi 'Total kredit yang boleh dibelanjakan kunci ini', atau pilih 'Tanpa batas total (tak terbatas)'. Batas per hari dan per bulan bersifat opsional; kosongkan salah satunya untuk membiarkan jendela itu tanpa batas.
Sebaiknya tetapkan total. 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.
Yang ditampilkan dalam daftar
Setiap kunci menampilkan namanya, apakah itu kunci produksi atau uji, karakter awal rahasianya (cukup untuk dicocokkan dengan catatan Anda sendiri), cakupannya, berapa banyak alur kerja 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, lalu simpan. Kosongkan batas untuk menghapusnya.
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 merotasi kunci, buat penggantinya terlebih dahulu, alihkan lalu lintas Anda ke sana, lalu cabut yang lama.
Tempat pengeluaran muncul
Kredit yang dihabiskan melalui API ditagihkan ke organisasi dan diatribusikan ke kunci yang menghabiskannya. Di Penggunaan kredit, pengeluaran API tampil sebagai satu anggota tambahan, 'API', dan tagihan dari kunci bernama tampil sebagai 'API · ' diikuti nama kunci.
- Di 'Ringkasan', aktifkan 'Rinci API per kunci' untuk memecah pengeluaran API per kunci.
- Run Partner API yang dimulai dengan
user_emailyang bukan salah satu anggota Anda dicantumkan di bawah email tersebut di 'Riwayat penggunaan', sehingga Anda bisa melihat berapa yang dihabiskan masing-masing pengguna Anda. Run denganuser_emailmilik seorang anggota dihitung sebagai milik anggota itu. Lihat Mulai run alur kerja.
Jika Anda mengalami kendala atau memiliki pertanyaan, jangan ragu untuk menghubungi kami. Kami dengan senang hati akan membantu. Tulis kepada kami di support@morphic.com.
Konektor
Cara menghubungkan Google Drive Anda serta akun ElevenLabs dan Epidemic Sound organisasi Anda ke Morphic, serta mengelola koneksinya.
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.