Yaratın ve geri alın
Üç ürün tek bir Creations API kullanır, bu yüzden video, görüntü ve uygulama sonuçları aynı liste, ayrıntı ve çıkış çalışma akışını paylaşır.
Kaynak dosyaları yükleme
Tüm ürünler input_file_ids kabul eder. Bir dosyayı ilk olarak yükleme:
curl -s "https://api.kpainter.ai/openapi/v1/files" \ -H "Authorization: Bearer $KPAINTER_API_KEY" \ -F "file=@./handbook.pdf"
Örnek Cevap :
{ "file_id": "file_xxx", "name": "handbook.pdf", "mime_type": "application/pdf", "size_bytes": 248391}
Geri gönderilen dosya_id'i yalnızca aynı hesabın sahip olduğu yaratıklar içinde kullanın.
Oluştur
POST /creations
Ortak alanlar :
| alanı | İhtiyaç | anlamı |
|---|---|---|
| Tipi | Evet | video, görüntü veya uygulama |
| Hızlı | Evet | Ne yaratmak için |
| talimatlar | Hayır | Ek gereksinimler |
| Yorumlar_file_ids | Hayır | Önceden yüklenen kaynak kimlikleri |
| max krediler | Hayır | Bu görev için izin verilen maksimum krediler |
| Video / Görüntü / App | Evet | Tam olarak bir ayar nesne eşleşen türü |
Örnek :
{ "type": "app", "prompt": "Build a safety quiz with immediate feedback from the handbook", "input_file_ids": ["file_xxx"], "app": { "language": "en" }}
List ve Get
GET /creations?page=1&page_size=20GET /creations?type=video&page=1&page_size=20GET /creations/{id}
Faydalı Detaylı Alanlar:
| alanı | anlamı |
|---|---|
| statü | Planlama, üretme, durdurma, hazır veya başarısız |
| Gelişme / PCT | Monoton ilerleme 0'dan 100'e kadar |
| tahmini_remining_seconds | Sadece güvenilir olduğunda mevcut |
| tahmin - krediler | Bu görev için mevcut tahminler |
| Gerçek - Kredi | Başarılı bir görev için net krediler |
| has_usable_divery için tıklayınız | Kullanılabilir bir sonuç zaten var mı |
| mevcut etkinlikler | Şu anda güvende olanlar için telefon |
| İnceleme | Güvenli Açıklayıcı Video Çıkış Saatleri |
| Sonuç / Kod | Kullanıcı Güvenli Sonuç Kodu |
Normal eksiklikler gerçek kredileri kaçırır. İnanılmaz bir ETA tahmin edilmekten ziyade göz ardı edilir.
çıkışları okuyun
GET /creations/{id}/outputs
Ekran yalnızca çıkışları geri getiriyor. Bir URL'yi girmeyin veya bitmemiş bir artifakt kullanmayın.
istikrarlı müşteri akışı
- Yetenekleri okuyun
- 1 geçerli bir oluşturma isteği gönderin.
- Her birkaç saniye aynı yaratıcılığı yapın.
- Hazır olduktan sonra çıkışları okuyun.
- Durdurulduğunda, mevcut_aksiyonları gösterin ve gerekli kullanıcı eylemini bekleyin.
- Başarısızlık durumunda, güvenli nedenini gösterin ve kullanıcının talepleri gözden geçirmesine izin verin.
- Eğer ağ durumu belirsiz ise, bir başka oluşturmadan önce mevcut yaratımı elde edin.
