Skip to main content
Krea Agent’a kendi uygulamanızdan görev vermek için Agent API’yi kullanın. İstekler ve yanıtlar camelCase JSON alanları kullanır. Ajan arka planda çalışırken uygulamanız ilerlemesini ve sonuçlarını okur.
Ajan arka planda çalışır. Soru sormaz; maliyet ve izin onayları otomatik olarak kabul edilir. Tüm gereksinimleri ve kısıtlamaları isteminize ekleyin. Göndermeden önce görevi gözden geçirin.

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.
Her yanıt, uygun hesap ve çalışma alanı erişimiyle oturumu Krea uygulamasında açabileceğiniz bir url içerir.

Bir oturum başlatın ve sonucunu bekleyin

Önce ortamınızda KREA_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.
Python için 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çin GET /agent/session/{sessionId} kullanın:
cURL

Oturumu sürdürme

Tur bittikten sonra, sessionId değeriyle yeni bir mesaj gönderin:
cURL
Bir oturum aynı anda tek bir tur çalıştırır. Bir tur çalışırken yeni mesaj göndermek 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.