Kimlik doğrulama, erişim ve faturalandırma
https://api.krea.ai adresine yapılan her istekte Authorization: Bearer KREA_API_KEY gönderin. Kişisel, servis ve eski API anahtarları standart genel API kimlik doğrulamasını kullanır.
Yalnızca kimliği doğrulanmış çalışma alanında, kimliği doğrulanmış çağırana ait oturumları okuyabilir veya sürdürebilirsiniz. Bir oturum ID’sini bilmek erişim sağlamaz. Krea dosya ekleri de o çalışma alanında o çağıran tarafından erişilebilir olmalıdır.
Ajan turları çalışma alanının hesaplama birimi bakiyesini kullanır. API bakiyesini kullanmaz. Agent plan hakları ve Free plan mesaj limitleri yine geçerlidir. Agent planları, erişim ve krediler sayfasına bakın.
url içerir.
Bir oturum başlatın ve sonucunu bekleyin
Önce ortamınızdaKREA_API_KEY değişkenini ayarlayın. curl ve jq ile Bash, requests ile Python veya yerleşik fetch ya da Krea SDK ile Node.js seçin.
1
İlk turu gönderin
Oturum oluşturmak için
sessionId alanını belirtmeyin. Dönen sessionId ve runId değerlerini kaydedin. Yanıt status: "running" ile hemen döner.2
Bu turu bekleyin
Her iki ID’yi de
wait-for-session uç noktasına iletin. timedOut değeri true ise aynı ID’lerle tekrar çağırın. Zaman aşımı turu iptal etmez.3
Sonucu okuyun
finished değeri true olduğunda status alanını kontrol edin. text, media ve varsa error alanlarını inceleyin veya dönen url adresini açın.requests paketini pip install requests ile kurun. Node.js için Node.js 22+ kullanın ve örneği example.mjs olarak kaydedin. SDK örneği npm install @krea-ai/sdk gerektirir ve HTTP uç noktalarını çağırmak için requestRaw kullanır.
Bu örnekler tek bir mesaj gönderir ve en fazla beş dakika bekler. HTTP hatalarında ve başarısız ya da iptal edilen turlarda dururlar. Bir gönderimi asla otomatik olarak yeniden denemezler. Bir gönderim isteği zaman aşımına uğrarsa, tekrar göndermeden önce oturumu Krea’da kontrol edin; ilk istek bir tur başlatmış olabilir.
Bekleme süresi dolduğunda tur arka planda devam eder. Beklemeye daha sonra devam etmek için yazdırılan oturum ve çalıştırma ID’lerini kaydedin.
timeoutSeconds, 1 ile 300 arasında bir tam sayıdır ve varsayılan değeri 60’tır. HTTP istemcinizin zaman aşımını istenen bekleme süresinden uzun tutun. Bir gönderimden sonra beklerken her zaman en son runId değerini iletin; böylece önceki turun son durumu yeni turun durumu sanılmaz.
Beklemeden okuma
Mevcut oturumun anlık görüntüsünü almak içinGET /agent/session/{sessionId} kullanın:
cURL
Oturumu sürdürme
Tur bittikten sonra,sessionId değeriyle yeni bir mesaj gönderin:
cURL
code: "conflict" ile 409 döndürür.
Girdiler ve ekler
send-message şu alanları kabul eder. Tam model enum’u ve şemalar için referansa bakın.
Ek
url alanı, erişilebilir bir HTTP(S) URL’sini veya file:550e8400-e29b-41d4-a716-446655440000 gibi yetkili bir Krea Files URI’sini kabul eder. İsteğe bağlı name ve contentType, boşlukları kırpılmış, boş olmayan ve en fazla 255 karakterlik dizelerdir. Çağıranın yerel yolları ve OpenAI file_ ID’leri desteklenmez. Önce asıl dosyayı aktarın; istem metnindeki bir ID dosyanın içeriğini aktarmaz.
Ajan, uygulamanızın konuşmasını veya eklerini devralmaz. Başka şekilde erişilemeyen referans dosyalarını ekleyin. İstemdeki kullanılabilir URL’leri, mevcut Krea context’ini veya önceki oturum dosyalarını tekrarlamanız gerekmez.
Oturum sonuçları
send-message; sessionId, threadId, runId, status (her zaman "running") ve url döndürür.
GET /agent/session/{sessionId} ve wait-for-session aşağıdaki oturum görünümünü döndürür. Zorunlu timedOut alanını yalnızca wait-for-session ekler.
Her
media öğesi bir üretimi (jobId ve isteğe bağlı mediaKind: image, video, audio veya 3d), yeniden barındırılan medyayı (url, isteğe bağlı mimeType ile) veya bir Krea dosyasını (uri, name, mimeType) temsil edebilir. Üretim ayrıntılarını GET /jobs/{jobId} ile alın. Bir Krea dosya URI’sini ek olarak yeniden kullanabilir veya dosyalarını görmek için oturumun url adresini açabilirsiniz. Medya, tur hâlâ çalışırken görünebilir.
Hatalar
Uç nokta hataları{ "error": "...", "code": "...", "allowedModels": ["..."] } biçimini kullanır. Yalnızca error zorunludur. Gönderimden sonra başarısız olan bir tur, bunun yerine başarılı bir oturum yanıtında status: "failed" olarak görünür.