İçeriğe geç
API Referansı
API Referansı

Kling Görüntüden Videoya

Asenkron bir Görev oluşturmak için görüntüden videoya uç noktasını kullanın.

Markdown'ı görüntüle
01

Genel Bakış

Görüntüden videoya uç noktasını desteklenen bir modelle kullanın. Durumunu almak için döndürülen Görev Kimliğini kullanın veya aşağıda belgelenen teslimler için callback_url sağlayın.

Hızlı başlangıç

  1. Bir API anahtarı oluşturun ve RUNAPI_API_KEY olarak ayarlayın.
  2. Desteklenen bir model seçin ve gövdesi o modelin şemasıyla eşleşen bir POST isteği gönderin.
  3. Döndürülen görev kimliğini saklayın, ardından bir terminal durumuna ulaşana kadar yoklama yapın ya da aşağıda belgelenen geri çağırmaları işleyin.

Uç Nokta

POST /api/v1/kling/image_to_video
Temel URL
https://runapi.ai
API sürümü
v1
Kimlik doğrulama
Authorization: Bearer YOUR_API_TOKEN
02

Desteklenen modeller

Güncel fiyatlandırma, hız sınırları ve ticari kullanım ayrıntıları için bir model sayfası açın.

03

İstek şeması

JSON gövdesi

Alanlar ve izin verilen değerler seçili modele göre değişir. Sağlandığında, callback_url aşağıda belgelenen Görev teslimatlarını alır.

kling-o113 alan
aspect_ratiostring
İsteğe bağlı

Çıktı en boy oranı.

İzin verilen değerler: 16:9, 9:16, 1:1 Varsayılan: 16:9
callback_urlstring
İsteğe bağlı

Asenkron bildirimler için webhook URL'si.

duration_secondsinteger
İsteğe bağlı

Saniye cinsinden süre.

İzin verilen değerler: 5 Varsayılan: 5
enable_soundboolean
İsteğe bağlı

Ses üretimi devre dışı bırakılmış kalmalıdır.

Varsayılan: false
first_frame_image_urlstring
Zorunlu

Genel HTTP(S) JPG, JPEG veya PNG ilk kare görsel URL'si.

last_frame_image_urlstring
İsteğe bağlı

Genel HTTP(S) JPG, JPEG veya PNG son kare görsel URL'si; reference_image_urls veya reference_video_url ile birlikte kullanılamaz.

modestring
İsteğe bağlı

Üretim modu.

İzin verilen değerler: std, pro Varsayılan: std
modelstring
Zorunlu

Model tanımlayıcısı.

preserve_reference_video_audioboolean
İsteğe bağlı

Referans videonun orijinal sesini koruyun.

Varsayılan: false
promptstring
Zorunlu

Video açıklaması; eşleşen numaralı işaretçilerle medyaya başvurun.

Aralık: 1 - 2500
reference_image_urlsarray
İsteğe bağlı

Sıralı genel HTTP(S) JPG, JPEG veya PNG referans resim URL'leri; last_frame_image_url ile birleştirilemez.

Öğe aralığı: 1 - 7
reference_video_typestring
İsteğe bağlı

Videoyu temel düzenleme veya özellik referansı olarak kullanın.

İzin verilen değerler: base, feature Varsayılan: base
reference_video_urlstring
İsteğe bağlı

Genel HTTP(S) MP4 veya MOV referans video URL'si; last_frame_image_url ile birlikte kullanılamaz.

kling-v2.1-master-image-to-video9 alan
aspect_ratiostring
İsteğe bağlı

Çıktı en boy oranı.

callback_urlstring
İsteğe bağlı

Asenkron bildirimler için webhook URL'si.

cfg_scalenumber
İsteğe bağlı

Rehberlik ölçeği (0-1).

duration_secondsinteger
İsteğe bağlı

Saniye cinsinden süre.

İzin verilen değerler: 5, 10
first_frame_image_urlstring
Zorunlu

İlk kare görüntü URL'si.

last_frame_image_urlstring
İsteğe bağlı

Desteklenen görüntüden videoya modeller için son kare görüntü URL'si.

modelstring
Zorunlu

Model tanımlayıcısı.

negative_promptstring
İsteğe bağlı

Negatif istem.

promptstring
Zorunlu

Video açıklaması.

kling-v2.1-pro9 alan
aspect_ratiostring
İsteğe bağlı

Çıktı en boy oranı.

callback_urlstring
İsteğe bağlı

Asenkron bildirimler için webhook URL'si.

cfg_scalenumber
İsteğe bağlı

Rehberlik ölçeği (0-1).

duration_secondsinteger
İsteğe bağlı

Saniye cinsinden süre.

İzin verilen değerler: 5, 10
first_frame_image_urlstring
Zorunlu

İlk kare görüntü URL'si.

last_frame_image_urlstring
İsteğe bağlı

Desteklenen görüntüden videoya modeller için son kare görüntü URL'si.

modelstring
Zorunlu

Model tanımlayıcısı.

negative_promptstring
İsteğe bağlı

Negatif istem.

promptstring
Zorunlu

Video açıklaması.

kling-v2.1-standard9 alan
aspect_ratiostring
İsteğe bağlı

Çıktı en boy oranı.

callback_urlstring
İsteğe bağlı

Asenkron bildirimler için webhook URL'si.

cfg_scalenumber
İsteğe bağlı

Rehberlik ölçeği (0-1).

duration_secondsinteger
İsteğe bağlı

Saniye cinsinden süre.

İzin verilen değerler: 5, 10
first_frame_image_urlstring
Zorunlu

İlk kare görüntü URL'si.

last_frame_image_urlstring
İsteğe bağlı

Desteklenen görüntüden videoya modeller için son kare görüntü URL'si.

modelstring
Zorunlu

Model tanımlayıcısı.

negative_promptstring
İsteğe bağlı

Negatif istem.

promptstring
Zorunlu

Video açıklaması.

kling-v2.5-turbo-image-to-video-pro9 alan
aspect_ratiostring
İsteğe bağlı

Çıktı en boy oranı.

callback_urlstring
İsteğe bağlı

Asenkron bildirimler için webhook URL'si.

cfg_scalenumber
İsteğe bağlı

Rehberlik ölçeği (0-1).

duration_secondsinteger
İsteğe bağlı

Saniye cinsinden süre.

İzin verilen değerler: 5, 10
first_frame_image_urlstring
Zorunlu

İlk kare görüntü URL'si.

last_frame_image_urlstring
İsteğe bağlı

Desteklenen görüntüden videoya modeller için son kare görüntü URL'si.

modelstring
Zorunlu

Model tanımlayıcısı.

negative_promptstring
İsteğe bağlı

Negatif istem.

promptstring
Zorunlu

Video açıklaması.

kling-v2.69 alan
aspect_ratiostring
İsteğe bağlı

Çıktı en boy oranı.

İzin verilen değerler: 16:9, 9:16, 1:1 Varsayılan: 16:9
callback_urlstring
İsteğe bağlı

Asenkron bildirimler için webhook URL'si.

duration_secondsinteger
İsteğe bağlı

Saniye cinsinden süre.

İzin verilen değerler: 5, 10 Varsayılan: 5
enable_soundboolean
İsteğe bağlı

Ses oluşturmayı etkinleştirin; pro modu gerektirir.

Varsayılan: false
first_frame_image_urlstring
Zorunlu

İlk kare görüntü URL'si.

last_frame_image_urlstring
İsteğe bağlı

Son kare görüntü URL'si; pro modu ve 5 saniye gerektirir.

modestring
İsteğe bağlı

Üretim modu.

İzin verilen değerler: std, pro Varsayılan: std
modelstring
Zorunlu

Model tanımlayıcısı.

promptstring
Zorunlu

Video açıklaması.

Aralık: 1 - 2500
kling-v3-omni9 alan
aspect_ratiostring
İsteğe bağlı

Çıktı en boy oranı.

İzin verilen değerler: 16:9, 9:16, 1:1 Varsayılan: 16:9
callback_urlstring
İsteğe bağlı

Asenkron bildirimler için webhook URL'si.

duration_secondsinteger
İsteğe bağlı

Saniye cinsinden süre.

İzin verilen değerler: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Varsayılan: 5
enable_soundboolean
İsteğe bağlı

Senkronize ses oluşturmayı etkinleştirin.

Varsayılan: false
first_frame_image_urlstring
Zorunlu

İlk kare görüntü URL'si.

last_frame_image_urlstring
İsteğe bağlı

Son kare görüntü URL'si; 5 saniyelik süre gerektirir.

modelstring
Zorunlu

Model tanımlayıcısı.

output_resolutionstring
İsteğe bağlı

Çıktı çözünürlüğü.

İzin verilen değerler: 720p, 1080p, 4k Varsayılan: 720p
promptstring
Zorunlu

Video açıklaması.

Aralık: 1 - 2500
kling-v3-turbo-image-to-video6 alan
callback_urlstring
İsteğe bağlı

Asenkron bildirimler için webhook URL'si.

duration_secondsinteger
İsteğe bağlı

Saniye cinsinden süre.

İzin verilen değerler: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Varsayılan: 5
first_frame_image_urlstring
Zorunlu

İlk kare görüntü URL'si.

modelstring
Zorunlu

Model tanımlayıcısı.

output_resolutionstring
İsteğe bağlı

Çıktı çözünürlüğü.

İzin verilen değerler: 720p, 1080p Varsayılan: 720p
promptstring
Zorunlu

Video açıklaması.

Aralık: 1 - 2500

Koşullu kurallar

Bu gereksinimler, listelenen tüm koşulların eşleştiği durumlarda uygulanır.

  1. Şu durumlarda model = kling-o1
    Gerekli
    Kabul edilmez
    output_resolution, negative_prompt, cfg_scale
  2. Şu durumlarda model = kling-v2.1-master-image-to-video
    Gerekli
    Kabul edilmez
    output_resolution, enable_sound, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
  3. Şu durumlarda model = kling-v2.1-pro
    Gerekli
    Kabul edilmez
    output_resolution, enable_sound, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
  4. Şu durumlarda model = kling-v2.1-standard
    Gerekli
    Kabul edilmez
    output_resolution, enable_sound, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
  5. Şu durumlarda model = kling-v2.5-turbo-image-to-video-pro
    Gerekli
    Kabul edilmez
    output_resolution, enable_sound, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
  6. Şu durumlarda model = kling-v2.6
    Gerekli
    Kabul edilmez
    output_resolution, negative_prompt, cfg_scale, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
  7. Şu durumlarda model = kling-v3-omni
    Gerekli
    Kabul edilmez
    negative_prompt, cfg_scale, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
  8. Şu durumlarda model = kling-v3-turbo-image-to-video
    Gerekli
    Kabul edilmez
    enable_sound, aspect_ratio, negative_prompt, cfg_scale, last_frame_image_url, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
04

Kabul oluştur

HTTP 202

POST /api/v1/kling/image_to_video

Yanıt şeması
JSON 
{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "processing"
      ],
      "type": "string"
    },
    "task_replayed": {
      "type": "boolean"
    }
  },
  "required": [
    "id",
    "status",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "processing"
}
05

Yoklama işleniyor

HTTP 200

GET /api/v1/kling/image_to_video/:id

Yanıt şeması
JSON 
{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "processing"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "processing"
}
06

Yoklama tamamlandı

HTTP 200

GET /api/v1/kling/image_to_video/:id

Yanıt şeması
JSON 
{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "completed"
      ],
      "type": "string"
    },
    "videos": {
      "items": {
        "properties": {
          "url": {
            "type": "string",
            "x-runapi-generated-media": true
          }
        },
        "required": [
          "url"
        ],
        "type": "object",
        "unevaluatedProperties": false
      },
      "type": "array"
    }
  },
  "required": [
    "id",
    "status",
    "videos",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "completed",
  "videos": [
    {
      "url": "https://file.runapi.ai/reference-video.mp4"
    }
  ]
}
07

Yoklama başarısız oldu

HTTP 200

GET /api/v1/kling/image_to_video/:id

Yanıt şeması
JSON 
{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "error": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "failed"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "error",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "error": "Task processing failed.",
  "id": "tsk_reference_demo",
  "status": "failed"
}
08

Müşteri geri çağırması: tamamlandı

HTTP 200

POST callback_url

Yanıt şeması
JSON 
{
  "properties": {
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "completed"
      ],
      "type": "string"
    },
    "videos": {
      "items": {
        "properties": {
          "url": {
            "type": "string",
            "x-runapi-generated-media": true
          }
        },
        "required": [
          "url"
        ],
        "type": "object",
        "unevaluatedProperties": false
      },
      "type": "array"
    }
  },
  "required": [
    "id",
    "status",
    "videos"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "id": "tsk_reference_demo",
  "status": "completed",
  "videos": [
    {
      "url": "https://file.runapi.ai/reference-video.mp4"
    }
  ]
}
09

Müşteri geri çağırması: başarısız oldu

HTTP 200

POST callback_url

Yanıt şeması
JSON 
{
  "properties": {
    "error": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "properties": {
            "code": {
              "type": "string"
            },
            "limit_cents": {
              "type": "integer"
            },
            "message": {
              "type": "string"
            },
            "reset_at": {
              "format": "date-time",
              "type": [
                "string",
                "null"
              ]
            },
            "used_cents": {
              "type": "integer"
            },
            "window": {
              "enum": [
                "1h",
                "1d",
                "7d",
                "daily",
                "weekly",
                "monthly",
                "lifetime"
              ],
              "type": "string"
            }
          },
          "required": [
            "code",
            "message"
          ],
          "type": "object",
          "unevaluatedProperties": false
        }
      ]
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "failed"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "error": {
    "code": "generation_failed",
    "message": "Task processing failed."
  },
  "id": "tsk_reference_demo",
  "status": "failed"
}
10

Hatalar

HTTP 401

POST /api/v1/kling/image_to_video

Yanıt şeması
JSON 
{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "error": "Authentication required"
}
11

Hatalar

HTTP 401

GET /api/v1/kling/image_to_video/:id

Yanıt şeması
JSON 
{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "error": "Authentication required"
}
12

Hatalar

HTTP 400

POST /api/v1/kling/image_to_video

Yanıt şeması
JSON 
{
  "oneOf": [
    {
      "properties": {
        "error": {
          "description": "İnsan tarafından okunabilir hata mesajı.",
          "type": "string"
        }
      },
      "required": [
        "error"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    {
      "properties": {
        "error": {
          "description": "İnsan tarafından okunabilir doğrulama özeti.",
          "type": "string"
        },
        "errors": {
          "additionalProperties": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": "Herkese açık istek alanına göre anahtarlanan doğrulama mesajları; her alan için insan tarafından okunabilir dizelerden oluşan bir dizi içerir.",
          "type": "object"
        }
      },
      "required": [
        "error",
        "errors"
      ],
      "type": "object",
      "unevaluatedProperties": false
    }
  ]
}

Yanıt örneği

JSON 
{
  "error": "model must be one of: kling-o1, kling-v2.1-master-image-to-video, kling-v2.1-pro, kling-v2.1-standard, kling-v2.5-turbo-image-to-video-pro, kling-v2.6, kling-v3-omni, kling-v3-turbo-image-to-video"
}
13

Hatalar

HTTP 402

POST /api/v1/kling/image_to_video

Yanıt şeması
JSON 
{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "error": "Insufficient balance"
}
14

Hatalar

HTTP 429

POST /api/v1/kling/image_to_video

Yanıt şeması
JSON 
{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "error": "API key credit limit exceeded"
}
15

Hatalar

HTTP 409

POST /api/v1/kling/image_to_video

Yanıt şeması
JSON 
{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "error": "The request uses features that are not supported for the selected model"
}
16

Hatalar

HTTP 429

POST /api/v1/kling/image_to_video

Yanıt şeması
JSON 
{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "error": "Rate limit reached. Please retry later."
}
17

Hatalar

HTTP 503

POST /api/v1/kling/image_to_video

Yanıt şeması
JSON 
{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "error": "Service under maintenance, please try again later"
}
18

Hatalar

HTTP 504

POST /api/v1/kling/image_to_video

Yanıt şeması
JSON 
{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "error": "The request timed out"
}
19

Hatalar

HTTP 404

GET /api/v1/kling/image_to_video/:id

Yanıt şeması
JSON 
{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON 
{
  "error": "Task with id 'tsk_reference_demo' not found"
}
20

Oluşturulan Kod Örnekleri

Doğrudan cURL kullanın veya diliniz için bir SDK yükleyin. Her örnek, bu başvuruda gösterilen doğrulanmış isteği gönderir.

Yükle

Shell 
pip install runapi-kling
PYTHON 
import os
from runapi.kling import KlingClient

client = KlingClient(api_key=os.environ["RUNAPI_API_KEY"])
task = client.image_to_video.create(
  model="kling-o1",
  prompt="A gentle camera pan across the scene.",
  first_frame_image_url="https://file.runapi.ai/first-frame.png"
)