Kimlik doğrulama
Studio'da bir Direct API anahtarı oluşturun, kapsamlarını ve kredi sınırlarını seçin ve her istekle birlikte gönderin.
Her istek, taşıyıcı belirteç olarak bir kuruluş API anahtarı taşır.
Authorization: Bearer mor_live_9f2c…Bir anahtar onu oluşturan kişiye değil, kuruluşa aittir. Kuruluşun her yöneticisi onu görebilir ve iptal edebilir; oluşturan kişi ekipten ayrıldığında da çalışmaya devam eder. Anahtar iptal edildiğinde, süresi dolduğunda, oluşturan kişinin hesabı askıya alındığında veya Morphic kuruluş için Direct API'yi kapattığında çalışmayı bırakır.
Bir anahtar oluşturun
Direct API kapsamları, yalnızca Morphic kuruluşunuz için Direct API'yi etkinleştirdikten sonra görünür. Bkz. Erişim alma.
- Morphic Studio'da kuruluş açılır menüsünü (sol üstteki Morphic logosu) açın ve Settings'i seçin.
- Sol kenar çubuğunda API keys'e tıklayın. Bu sekmeyi yalnızca yöneticiler görür.
- New key'e tıklayın.
- Name alanına bir ad girin, Scopes altında anahtarın ihtiyaç duyduğu kapsamları seçin ve anahtar sonsuza kadar geçerli olmayacaksa Expires alanında bitiş tarihini belirleyin.
- Credit limits altında anahtarın toplamda harcayabileceği tutarı ve isteğe bağlı olarak günlük ve aylık bir sınır belirleyin.
- "I agree to the Morphic Terms of Use, including the Developer API section" kutusunu işaretleyin. Bu, kuruluş adına Kullanım Koşulları'nı kabul eder.
- Create key'e tıklayın, ardından gizli anahtarı gizli anahtar yöneticinize kopyalayın. Yalnızca bir kez gösterilir.
Gizli anahtarı elinde bulunduran herkes, anahtarın sınırlarına kadar kuruluşunuzun kredilerini harcayabilir. Bir anahtarı asla tarayıcıya, mobil uygulamaya veya herkese açık bir depoya koymayın.
Anahtar biçimi
mor_live_<64 hex characters>Önek, size ve gizli anahtar tarayıcılarına anahtarın hangi dağıtıma ait olduğunu söyler.
Kapsamlar
Bir anahtar yalnızca kapsamlarının izin verdiği araçlara erişir. En dar kümeyi seçin.
| Kapsam | Studio'daki etiket | İzin verdikleri |
|---|---|---|
projects:read | Read projects and their files | projeleri, iş akışlarını ve Compose zaman çizelgelerini listelemek |
assets:read | Find and read assets | kütüphaneyi listelemek, üretimleri ve durumlarını, karakterleri okumak |
assets:write | Upload assets and edit them | medyayı URL ile iletmek, Compose zaman çizelgeleri oluşturmak |
generations:write | Generate images, video and audio (spends credits) | medya başlatan, düzenleyen veya analiz eden her araç |
Anahtarın kapsamları dışındaki bir araca yapılan çağrı 403 insufficient_scope yanıtını verir ve eksik kapsamı data.required_scopes içinde belirtir. list_voices ve /me gibi kapsam gerektirmeyen uç noktalar ve araçlar her anahtara açıktır. Araç kataloğu, her aracın gerektirdiği kapsamı listeler.
Kredi sınırları
Her anahtar, oluşturulurken belirlenen harcama tavanları taşır. Bir yönetici bunları daha sonra Edit limits ile değiştirebilir.
| Sınır | Zorunlu | Dönem |
|---|---|---|
total_credit_limit | evet | anahtarın tüm ömrü |
monthly_credit_limit | hayır | takvim ayı, UTC |
daily_credit_limit | hayır | takvim günü, UTC |
- Anahtarı herhangi bir sınırın ötesine taşıyacak ücretli bir çağrı, hiçbir şey başlamadan
402 api_key_credit_limit_reachedile reddedilir; hangi sınır olduğunudata.periodsöyler. - Bunun üzerine kuruluşun kendi bakiyesi de uygulanır: kuruluşun ödeyemeyeceği bir çağrı
402 insufficient_creditsile reddedilir. GET /v1/direct/me, anahtarın sınırlarını ve güncel harcamasını döndürür. Bkz. Krediler ve kullanım.
Bir anahtarı yenileyin
- Yeni anahtarı oluşturun.
- Dağıtın.
- Eski anahtarı Revoke key ile iptal edin.
Bir kuruluş en fazla 10 etkin anahtar tutabilir, bu yüzden yenileme sırasında hiçbir zaman kesinti gerekmez.
Herhangi bir sorun yaşarsanız ya da sorularınız olursa, bizimle iletişime geçmekten çekinmeyin. Yardım etmeye memnuniyet duyarız. Bize şu adresten yazın: support@morphic.com.
Direct API
Kendi arka ucunuzdan HTTPS üzerinden Morphic'te görseller, video ve ses üretin, düzenleyin ve yönetin.
Bir aracı çağırma
Herhangi bir Direct API aracını tek bir istek biçimiyle çağırın, sonucunu ve faturalandırmasını okuyun ve ücretli çağrıları bir Idempotency-Key ile güvenle yeniden deneyin.