Kling Metinden Videoya

01

Genel Bakış

Metinden 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ıç

Bir API anahtarı oluşturun ve RUNAPI_API_KEY olarak ayarlayın.
Desteklenen bir model seçin ve gövdesi o modelin şemasıyla eşleşen bir POST isteği gönderin.
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.

POST /api/v1/kling/text_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-3.014 alan

aspect_ratiostring

İsteğe bağlı

Çıktı en boy oranı.

İzin verilen değerler: 16:9, 9:16, 1:1

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: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

enable_soundboolean

İsteğe bağlı

Ses oluşturmayı etkinleştirin.

first_frame_image_urlstring

İsteğe bağlı

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

kling_elementsarray

İsteğe bağlı

Görüntü, video veya ses materyalleri içeren öğe referansları.

last_frame_image_urlstring

İsteğe bağlı

Tek çekim modunda son kare resim URL'si.

modelstring

Zorunlu

Model tanımlayıcısı.

multi_promptarray

İsteğe bağlı

Çok çekimli mod için istem bölümleri.

multi_shotsboolean

İsteğe bağlı

Çok çekimli oluşturmayı etkinleştirin.

negative_promptstring

İsteğe bağlı

Negatif istem.

output_resolutionstring

İsteğe bağlı

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

İzin verilen değerler: 720p, 1080p, 4k

promptstring

İsteğe bağlı

Video açıklaması. multi_shots etkinleştirilmediği sürece zorunludur.

kling-o111 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

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.

Öğ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.

kling-v2.1-master-text-to-video8 alan

aspect_ratiostring

İsteğe bağlı

Çıktı en boy oranı.

İzin verilen değerler: 16:9, 9:16, 1:1

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

enable_soundboolean

İsteğe bağlı

Ses oluşturmayı etkinleştirin.

modelstring

Zorunlu

Model tanımlayıcısı.

negative_promptstring

İsteğe bağlı

Negatif istem.

promptstring

İsteğe bağlı

Video açıklaması.

kling-v2.5-turbo-text-to-video-pro8 alan

aspect_ratiostring

İsteğe bağlı

Çıktı en boy oranı.

İzin verilen değerler: 16:9, 9:16, 1:1

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

enable_soundboolean

İsteğe bağlı

Ses oluşturmayı etkinleştirin.

modelstring

Zorunlu

Model tanımlayıcısı.

negative_promptstring

İsteğe bağlı

Negatif istem.

promptstring

İsteğe bağlı

Video açıklaması.

kling-v2.67 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

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-omni7 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

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-omni-reference8 alan

aspect_ratiostring

Zorunlu

Çıktı en boy oranı.

İzin verilen değerler: 16:9, 9:16, 1:1

callback_urlstring

İsteğe bağlı

Asenkron bildirimler için webhook URL'si.

duration_secondsinteger

İsteğe bağlı

Saniye cinsinden çıktı süresi.

İ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

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

reference_image_urlsarray

Zorunlu

Sıralı referans resim URL'leri.

Öğe aralığı: 1 - 7

kling-v3-turbo-text-to-video6 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

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.

Şu durumlarda model = kling-3.0

Gerekli

Kabul edilmez

reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
Şu durumlarda model = kling-o1

Gerekli

Kabul edilmez

output_resolution, negative_prompt, cfg_scale, multi_shots, multi_prompt, first_frame_image_url, last_frame_image_url, kling_elements
Şu durumlarda model = kling-v2.1-master-text-to-video

Gerekli

Kabul edilmez

mode, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
Şu durumlarda model = kling-v2.5-turbo-text-to-video-pro

Gerekli

Kabul edilmez

mode, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
Şu durumlarda model = kling-v2.6

Gerekli

Kabul edilmez

output_resolution, negative_prompt, cfg_scale, multi_shots, multi_prompt, first_frame_image_url, last_frame_image_url, kling_elements, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
Şu durumlarda model = kling-v3-omni

Gerekli

Kabul edilmez

negative_prompt, cfg_scale, multi_shots, multi_prompt, first_frame_image_url, last_frame_image_url, kling_elements, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
Şu durumlarda model = kling-v3-turbo-text-to-video

Gerekli

Kabul edilmez

enable_sound, negative_prompt, cfg_scale, multi_shots, multi_prompt, first_frame_image_url, last_frame_image_url, kling_elements, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio

04

Kabul oluştur

HTTP 202

POST /api/v1/kling/text_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/text_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/text_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/text_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/text_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/text_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/text_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-3.0, kling-o1, kling-v2.1-master-text-to-video, kling-v2.5-turbo-text-to-video-pro, kling-v2.6, kling-v3-omni, kling-v3-omni-reference, kling-v3-turbo-text-to-video"
}

13

Hatalar

HTTP 402

POST /api/v1/kling/text_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/text_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/text_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/text_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/text_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/text_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/text_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.text_to_video.create(
  model="kling-v3-turbo-text-to-video",
  prompt="A paper kite flying above a quiet coastal town at sunrise",
  duration_seconds=5,
  aspect_ratio="16:9",
  output_resolution="720p"
)

Yükle

Shell

npm install @runapi.ai/kling

JAVASCRIPT

import { KlingClient } from "@runapi.ai/kling";

const client = new KlingClient({ apiKey: process.env.RUNAPI_API_KEY });
const task = await client.textToVideo.create({
  "model": "kling-v3-turbo-text-to-video",
  "prompt": "A paper kite flying above a quiet coastal town at sunrise",
  "duration_seconds": 5,
  "aspect_ratio": "16:9",
  "output_resolution": "720p"
});

CURL

curl -X POST https://runapi.ai/api/v1/kling/text_to_video \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"model":"kling-v3-turbo-text-to-video","prompt":"A paper kite flying above a quiet coastal town at sunrise","duration_seconds":5,"aspect_ratio":"16:9","output_resolution":"720p"}'

Yükle

Shell

go get github.com/runapi-ai/kling-sdk/go@latest

GO

package main

import (
  "context"
  "log"
  "os"

  "github.com/runapi-ai/core-sdk/go/option"
  kling "github.com/runapi-ai/kling-sdk/go/kling"
)

func main() {
  client, err := kling.NewClient(option.WithAPIKey(os.Getenv("RUNAPI_API_KEY")))
  if err != nil {
    log.Fatal(err)
  }

  task, err := client.TextToVideo.Create(context.Background(), kling.TextToVideoParams{
    Model: kling.TextToVideoModel("kling-v3-turbo-text-to-video"),
    Prompt: "A paper kite flying above a quiet coastal town at sunrise",
    DurationSeconds: 5,
    AspectRatio: "16:9",
    OutputResolution: kling.KlingTextToVideoOutputResolution("720p"),
  })
  if err != nil {
    log.Fatal(err)
  }
  _ = task
}

21

Kling Metinden Videoya

Genel Bakış

Hızlı başlangıç

Uç Nokta

Desteklenen modeller

İstek şeması

Koşullu kurallar

Kabul oluştur

Yanıt örneği

Yoklama işleniyor

Yanıt örneği

Yoklama tamamlandı

Yanıt örneği

Yoklama başarısız oldu

Yanıt örneği

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

Yanıt örneği

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

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Oluşturulan Kod Örnekleri

Yükle

İlgili Kılavuzlar