Autentikasi
Buat kunci Direct API di Studio, pilih cakupan dan batas kreditnya, lalu kirimkan bersama setiap permintaan.
Setiap permintaan membawa kunci API organisasi sebagai token bearer.
Authorization: Bearer mor_live_9f2c…Sebuah kunci milik organisasi, bukan milik orang yang membuatnya. Setiap admin organisasi dapat melihat dan mencabutnya, dan kunci tetap berfungsi ketika pembuatnya keluar dari tim. Kunci berhenti berfungsi ketika dicabut, ketika kedaluwarsa, ketika akun pembuatnya ditangguhkan, atau ketika Morphic menonaktifkan Direct API untuk organisasi tersebut.
Buat kunci
Cakupan Direct API baru muncul setelah Morphic mengaktifkan Direct API untuk organisasi Anda. Lihat Mendapatkan akses.
- Di Morphic Studio, buka dropdown organisasi (logo Morphic, kiri atas) lalu pilih 'Pengaturan'.
- Di sidebar kiri, klik 'Kunci API'. Hanya admin yang melihat tab ini.
- Klik 'Kunci baru'.
- Isi 'Nama', pilih 'Cakupan' yang dibutuhkan kunci, dan jika kunci tidak seharusnya berlaku selamanya, tentukan kapan 'Kedaluwarsa'.
- Di bawah 'Batas kredit', tetapkan total yang boleh dibelanjakan kunci, serta batas harian dan bulanan jika perlu.
- Centang 'Saya menyetujui Ketentuan Penggunaan Morphic, termasuk bagian API Developer'. Ini menyetujui Ketentuan Penggunaan atas nama organisasi.
- Klik 'Buat kunci', lalu salin rahasianya ke pengelola rahasia Anda. Rahasia hanya ditampilkan sekali.
Siapa pun yang memegang rahasia dapat membelanjakan kredit organisasi Anda hingga batas kunci tersebut. Jangan pernah menaruh kunci di browser, aplikasi seluler, atau repositori publik.
Format kunci
mor_live_<64 hex characters>Awalannya memberi tahu Anda, dan pemindai rahasia, untuk deployment mana kunci itu dibuat.
Cakupan
Sebuah kunci hanya menjangkau alat yang diizinkan oleh cakupannya. Pilih kumpulan yang paling sempit.
| Cakupan | Label di Studio | Mengizinkan |
|---|---|---|
projects:read | Baca proyek dan filenya | menampilkan daftar proyek, alur kerja, dan timeline Compose |
assets:read | Cari dan baca aset | menampilkan daftar pustaka, membaca generasi dan statusnya, karakter |
assets:write | Unggah aset dan edit | meneruskan media lewat URL, membuat timeline Compose |
generations:write | Buat gambar, video, dan audio (memakai kredit) | setiap alat yang memulai, mengedit, atau menganalisis media |
Panggilan ke alat di luar cakupan kunci dijawab dengan 403 insufficient_scope dan menyebutkan cakupan yang kurang di data.required_scopes. Endpoint dan alat yang tidak membutuhkan cakupan, seperti list_voices dan /me, terbuka untuk setiap kunci. Katalog alat mencantumkan cakupan yang dibutuhkan setiap alat.
Batas kredit
Setiap kunci memiliki batas pemakaian yang ditetapkan saat dibuat. Admin dapat mengubahnya nanti dengan 'Edit batas'.
| Batas | Wajib | Periode |
|---|---|---|
total_credit_limit | ya | seumur hidup kunci |
monthly_credit_limit | tidak | bulan kalender, UTC |
daily_credit_limit | tidak | hari kalender, UTC |
- Panggilan berbayar yang akan membuat kunci melampaui salah satu batas ditolak dengan
402 api_key_credit_limit_reachedsebelum apa pun dimulai;data.periodmenyebutkan batas mana. - Saldo organisasi sendiri juga berlaku: panggilan yang tidak dapat dibayar oleh saldo itu ditolak dengan
402 insufficient_credits. GET /v1/direct/memengembalikan batas kunci dan pemakaiannya saat ini. Lihat Kredit dan pemakaian.
Rotasi kunci
- Buat kunci baru.
- Terapkan kunci itu.
- Cabut kunci lama dengan 'Cabut kunci'.
Sebuah organisasi dapat memiliki hingga 10 kunci aktif, sehingga rotasi tidak pernah memerlukan jeda.
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.