Clevera REST API'yi kullanma

Clevera'nın REST API'si, kendi betiklerinizin ve servislerinizin bir temsilcinin MCP üzerinden yapabildiği her şeyi yapmasını sağlar: kütüphanenizi okumak, video ve makale talep etmek, videoları dışa aktarmak, dokümantasyon siteleri üzerinde çalışmak ve işleri takip etmek. Bu makale temel URL'yi, kimlik doğrulamasını, ücretli işler için istek akışını, hataları ve hız sınırlarını kapsar.

Temeller#

Bir token'ı GET /docs/me ile kontrol edin:

curl -H "Authorization: Bearer $CLEVERA_TOKEN" \
     -H "Accept: application/json" \
     https://app.clevera.ai/api/v1/docs/me

Yanıt, token'ın kimin adına hareket ettiğini söyler: token'ın adı ve son kullanma tarihi, kişi ve mevcut rolü, çalışma alanı, kapsamdaki siteler ve şu anda çalışan izinler (token'ın izinlerinin kişinin mevcut rolüne göre kırpılmış hali). Bir çağrı reddedildiğinde önce bunu çağırın.

Uç Noktalar#

Her uç nokta gösterilen izne ihtiyaç duyar. Bu izin olmadan birini çağırmak 403 forbidden_ability döndürür. Bkz. Temsilci izinleri.

Kütüphane ve materyaller#

Videolar ve makaleler#

İşler ve krediler#

Dokümantasyon siteleri#

Temsilciler ve dokümantasyon siteleri hakkında daha fazla bilgi: AI temsilcilerini dokümantasyon sitelerinize bağlayın.

Ücretli iş talep etme#

Kredi harcayan işler her zaman önce fiyat teklifi, sonra başlatma şeklinde ilerler:

1. Fiyat teklifi alın. İstediğiniz şeyle POST /videos/quotes (veya /clips/quotes). Yanıt bir quote_id ve kredi aralığını içerir. Teklif 15 dakika geçerlidir ve bir kez kullanılabilir.
2. İsteğe bağlı olarak deneme çalışması yapın. Başlayıp başlamayacağını, onay gerekip gerekmediğini veya engellenip engellenmeyeceğini öğrenmek için "dry_run": true ile başlatma isteği gönderin. Hiçbir şey yazılmaz.
3. Başlatın. POST /videos ile quote_id ve bir Idempotency-Key başlığı gönderin. Yanıt, bir iş ile birlikte 202 olur.
4. Takip edin. İşin status değişene kadar GET /jobs/{job}/wait kullanın veya web kancalarını dinleyin.

curl -X POST https://app.clevera.ai/api/v1/videos/quotes \
  -H "Authorization: Bearer $CLEVERA_TOKEN" -H "Content-Type: application/json" \
  -d '{"type": "how_to", "recording_id": "<recording id>", "language": "en-US"}'

curl -X POST https://app.clevera.ai/api/v1/videos \
  -H "Authorization: Bearer $CLEVERA_TOKEN" -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3f6c1a2e-8d4b-4f7a-9c1e-2b5d7e9f0a13" \
  -d '{"quote_id": "<quote id>"}'

İş durumları:

Bir başlatma işleminin hemen mi çalışacağı yoksa bir kişiyi mi bekleyeceği, token'ın harcama sınırlarına ve Aşağıdakileri otomatik onayla ayarına bağlıdır. Bkz. Temsilci harcamalarını ve onaylarını kontrol etme.

Yeniden denemeler ve eşdeğerlik#

Her oluşturma ve başlatma işleminde bir Idempotency-Key başlığı (eylem başına yeni bir UUID) gönderin. Ağ bağlantısı koparsa ve aynı anahtar ve gövde ile yeniden denerseniz, ikinci bir video yerine ilk yanıtı alırsınız. Anahtarlar 24 saat boyunca hatırlanır.

Hatalar#

Her hata aynı yapıya sahiptir ve bir sonraki adımda ne yapmanız gerektiğini söyleyen bir mesaj içerir:

{
  "error": {
    "code": "forbidden_ability",
    "message": "This token lacks the videos:create ability. Ask the workspace member who owns it for a token that has it.",
    "details": { "ability": "videos:create" }
  },
  "request_id": "req_example"
}

Destek ekibiyle iletişime geçtiğinizde request_id bilgisini ekleyin.

Her mesaj ve çözümü: Temsilci ve API hatalarını düzeltme.

Hız sınırları#

Bir 429 yanıtı, Retry-After başlığına ve gövdede retry_after (saniye) değerine sahiptir. Yeniden denemeden önce o kadar süre bekleyin. Okumalar, fiyat teklifleri ve durum kontrolleri kredi harcamaz.

İlgili#