Rivya AI Dokümanları
Model API Sayfaları

Kling AI Avatar Standard API Entegrasyonu

Kling AI Avatar Standard modelini Rivya Public API v1 üzerinden model id kling-ai-avatar-standard, desteklenen girişler, parametreler, Files API kuralları, krediler ve yanıt örnekleriyle kullanın.

API üzerinden kullanılabilirHazırlıkVideo
API model kimliği

kling-ai-avatar-standard

Girişler

file

Files API

Referans modları için gerekli

Temel krediler

per_input_second · default=8 · ⌈total⌉

Yetenek

Video

Faturalandırma

METERED

Prompt limiti

5000 karakter

İstek sözleşmesi

Model id değerini en üst seviyede gönderin. Modele özel kontroller params içine aittir.

AnahtarTürGerekliVarsayılanAçıklama
modelstringEvetkling-ai-avatar-standardkling-ai-avatar-standard API model kimliği değerini kullanın.
promptstringHayır-Bu model için en fazla 5000 karakter.
paramsobjectHayır-Modele özel parametre nesnesi. İzin verilen anahtarlar için aşağıdaki satırları kullanın.
client_request_idstringHayır-Sisteminizde istekleri izlemek için isteğe bağlı istemci tarafı id.

Model parametreleri

Bu model, model, prompt ve isteğe bağlı client_request_id dışında ek params gerektirmez.

Yükleme politikası

Önce referans dosyalarını yükleyin, ardından dönen URLyi ve duration token değerini params.referenceMediaItems içine yerleştirin.

Referans kuralı

Portre görseli ve ses: Bir portre görselini ve bir ses klibini birlikte yükleyin.

Maks. dosya

2

Kabul edilen dosya türleri

image, audio

Süre belirteci

Süre doğrulaması gerektiğinde video ve ses referansları /api/v1/files içinden durationToken taşımalıdır.

kindMaks. boyutMIME türleri
image10 MBimage/jpeg, image/png
audio95 MBaudio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/aac, audio/ogg

Minimal istek

{
  "model": "kling-ai-avatar-standard"
}

Referans dosyalı istek

{
  "model": "kling-ai-avatar-standard",
  "params": {
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Create yanıtı

Create endpointi herkese açık task id döndürür. Görev başarılı veya başarısız olana kadar status endpointini sorgulayın.

{
  "id": "task_kling_ai_avatar_standard_example",
  "status": "queued",
  "model": "kling-ai-avatar-standard",
  "reserved_credits": 8,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Yaygın hatalar

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Bazı modlar Files API referans yüklemeleri gerektirir.