Genel Bakış/OpenAPI/Oluştur ve al

Oluştur ve al

Kaynakları yükleyin, içerik oluşturun ve ilerleme durumunu, kredileri ve çıktıları alın.

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ışı

  1. Yetenekleri okuyun
  2. 1 geçerli bir oluşturma isteği gönderin.
  3. Her birkaç saniye aynı yaratıcılığı yapın.
  4. Hazır olduktan sonra çıkışları okuyun.
  5. Durdurulduğunda, mevcut_aksiyonları gösterin ve gerekli kullanıcı eylemini bekleyin.
  6. Başarısızlık durumunda, güvenli nedenini gösterin ve kullanıcının talepleri gözden geçirmesine izin verin.
  7. Eğer ağ durumu belirsiz ise, bir başka oluşturmadan önce mevcut yaratımı elde edin.