Przejdź do treści
Dokumentacja API
Dokumentacja API

Kling Zamiana obrazu na wideo

Użyj punktu końcowego image to video, aby utworzyć asynchroniczne zadanie.

Zobacz Markdown
01

Omówienie

Użyj punktu końcowego image to video z obsługiwanym modelem. Użyj zwróconego identyfikatora zadania, aby pobrać jego stan, lub podaj callback_url dla dostarczeń udokumentowanych poniżej.

Szybki start

  1. Utwórz klucz API i ustaw go jako RUNAPI_API_KEY.
  2. Wybierz obsługiwany model i wyślij żądanie POST, którego treść odpowiada schematowi tego modelu.
  3. Zapisz zwrócony identyfikator zadania, a następnie odpytuj do momentu osiągnięcia stanu końcowego lub obsłuż wywołania zwrotne opisane poniżej.

Punkt końcowy

POST /api/v1/kling/image_to_video
Bazowy URL
https://runapi.ai
Wersja API
v1
Uwierzytelnianie
Authorization: Bearer YOUR_API_TOKEN
02

Obsługiwane modele

Otwórz stronę modelu, aby zapoznać się z aktualnymi cenami, limitami żądań i szczegółami dotyczącymi użytku komercyjnego.

03

Schemat żądania

Treść JSON

Pola i dozwolone wartości zależą od wybranego modelu. Jeśli zostanie podany, callback_url będzie odbierać dostarczenia zadań (Task) opisane poniżej.

kling-o113 pola
aspect_ratiostring
Opcjonalne

Współczynnik proporcji danych wyjściowych.

Dozwolone wartości: 16:9, 9:16, 1:1 Domyślna wartość: 16:9
callback_urlstring
Opcjonalne

URL webhooka dla powiadomień asynchronicznych.

duration_secondsinteger
Opcjonalne

Czas trwania w sekundach.

Dozwolone wartości: 5 Domyślna wartość: 5
enable_soundboolean
Opcjonalne

Generowanie dźwięku musi pozostać wyłączone.

Domyślna wartość: false
first_frame_image_urlstring
Wymagane

Publiczny adres URL HTTP(S) obrazu pierwszej klatki w formacie JPG, JPEG lub PNG.

last_frame_image_urlstring
Opcjonalne

Publiczny adres URL HTTP(S) obrazu ostatniej klatki w formacie JPG, JPEG lub PNG; nie można łączyć z reference_image_urls ani reference_video_url.

modestring
Opcjonalne

Tryb generowania.

Dozwolone wartości: std, pro Domyślna wartość: std
modelstring
Wymagane

Identyfikator modelu.

preserve_reference_video_audioboolean
Opcjonalne

Zachowaj oryginalną ścieżkę dźwiękową z referencyjnego wideo.

Domyślna wartość: false
promptstring
Wymagane

Opis wideo; odwołuj się do mediów za pomocą pasujących ponumerowanych znaczników.

Zakres: 1 - 2500
reference_image_urlsarray
Opcjonalne

Uporządkowane publiczne adresy URL obrazów referencyjnych HTTP(S) JPG, JPEG lub PNG; nie można łączyć z last_frame_image_url.

Zakres elementów: 1 - 7
reference_video_typestring
Opcjonalne

Użyj wideo jako bazy do edycji lub odniesienia do funkcji.

Dozwolone wartości: base, feature Domyślna wartość: base
reference_video_urlstring
Opcjonalne

Publiczny adres URL HTTP(S) referencyjnego wideo w formacie MP4 lub MOV; nie można łączyć z last_frame_image_url.

kling-v2.1-master-image-to-video9 pola
aspect_ratiostring
Opcjonalne

Współczynnik proporcji danych wyjściowych.

callback_urlstring
Opcjonalne

URL webhooka dla powiadomień asynchronicznych.

cfg_scalenumber
Opcjonalne

Skala prowadzenia (0–1).

duration_secondsinteger
Opcjonalne

Czas trwania w sekundach.

Dozwolone wartości: 5, 10
first_frame_image_urlstring
Wymagane

Adres URL pierwszej klatki.

last_frame_image_urlstring
Opcjonalne

Adres URL ostatniej klatki dla obsługiwanych modeli konwertujących obraz na wideo.

modelstring
Wymagane

Identyfikator modelu.

negative_promptstring
Opcjonalne

Negatywny monit.

promptstring
Wymagane

Opis wideo.

kling-v2.1-pro9 pola
aspect_ratiostring
Opcjonalne

Współczynnik proporcji danych wyjściowych.

callback_urlstring
Opcjonalne

URL webhooka dla powiadomień asynchronicznych.

cfg_scalenumber
Opcjonalne

Skala prowadzenia (0–1).

duration_secondsinteger
Opcjonalne

Czas trwania w sekundach.

Dozwolone wartości: 5, 10
first_frame_image_urlstring
Wymagane

Adres URL pierwszej klatki.

last_frame_image_urlstring
Opcjonalne

Adres URL ostatniej klatki dla obsługiwanych modeli konwertujących obraz na wideo.

modelstring
Wymagane

Identyfikator modelu.

negative_promptstring
Opcjonalne

Negatywny monit.

promptstring
Wymagane

Opis wideo.

kling-v2.1-standard9 pola
aspect_ratiostring
Opcjonalne

Współczynnik proporcji danych wyjściowych.

callback_urlstring
Opcjonalne

URL webhooka dla powiadomień asynchronicznych.

cfg_scalenumber
Opcjonalne

Skala prowadzenia (0–1).

duration_secondsinteger
Opcjonalne

Czas trwania w sekundach.

Dozwolone wartości: 5, 10
first_frame_image_urlstring
Wymagane

Adres URL pierwszej klatki.

last_frame_image_urlstring
Opcjonalne

Adres URL ostatniej klatki dla obsługiwanych modeli konwertujących obraz na wideo.

modelstring
Wymagane

Identyfikator modelu.

negative_promptstring
Opcjonalne

Negatywny monit.

promptstring
Wymagane

Opis wideo.

kling-v2.5-turbo-image-to-video-pro9 pola
aspect_ratiostring
Opcjonalne

Współczynnik proporcji danych wyjściowych.

callback_urlstring
Opcjonalne

URL webhooka dla powiadomień asynchronicznych.

cfg_scalenumber
Opcjonalne

Skala prowadzenia (0–1).

duration_secondsinteger
Opcjonalne

Czas trwania w sekundach.

Dozwolone wartości: 5, 10
first_frame_image_urlstring
Wymagane

Adres URL pierwszej klatki.

last_frame_image_urlstring
Opcjonalne

Adres URL ostatniej klatki dla obsługiwanych modeli konwertujących obraz na wideo.

modelstring
Wymagane

Identyfikator modelu.

negative_promptstring
Opcjonalne

Negatywny monit.

promptstring
Wymagane

Opis wideo.

kling-v2.69 pola
aspect_ratiostring
Opcjonalne

Współczynnik proporcji danych wyjściowych.

Dozwolone wartości: 16:9, 9:16, 1:1 Domyślna wartość: 16:9
callback_urlstring
Opcjonalne

URL webhooka dla powiadomień asynchronicznych.

duration_secondsinteger
Opcjonalne

Czas trwania w sekundach.

Dozwolone wartości: 5, 10 Domyślna wartość: 5
enable_soundboolean
Opcjonalne

Włącz generowanie dźwięku; wymaga trybu pro.

Domyślna wartość: false
first_frame_image_urlstring
Wymagane

Adres URL pierwszej klatki.

last_frame_image_urlstring
Opcjonalne

Adres URL ostatniej klatki; wymaga trybu pro i 5 sekund.

modestring
Opcjonalne

Tryb generowania.

Dozwolone wartości: std, pro Domyślna wartość: std
modelstring
Wymagane

Identyfikator modelu.

promptstring
Wymagane

Opis wideo.

Zakres: 1 - 2500
kling-v3-omni9 pola
aspect_ratiostring
Opcjonalne

Współczynnik proporcji danych wyjściowych.

Dozwolone wartości: 16:9, 9:16, 1:1 Domyślna wartość: 16:9
callback_urlstring
Opcjonalne

URL webhooka dla powiadomień asynchronicznych.

duration_secondsinteger
Opcjonalne

Czas trwania w sekundach.

Dozwolone wartości: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Domyślna wartość: 5
enable_soundboolean
Opcjonalne

Włącz synchroniczne generowanie dźwięku.

Domyślna wartość: false
first_frame_image_urlstring
Wymagane

Adres URL pierwszej klatki.

last_frame_image_urlstring
Opcjonalne

Adres URL ostatniej klatki; wymaga czasu trwania 5 sekund.

modelstring
Wymagane

Identyfikator modelu.

output_resolutionstring
Opcjonalne

Rozdzielczość wyjściowa.

Dozwolone wartości: 720p, 1080p, 4k Domyślna wartość: 720p
promptstring
Wymagane

Opis wideo.

Zakres: 1 - 2500
kling-v3-turbo-image-to-video6 pola
callback_urlstring
Opcjonalne

URL webhooka dla powiadomień asynchronicznych.

duration_secondsinteger
Opcjonalne

Czas trwania w sekundach.

Dozwolone wartości: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Domyślna wartość: 5
first_frame_image_urlstring
Wymagane

Adres URL pierwszej klatki.

modelstring
Wymagane

Identyfikator modelu.

output_resolutionstring
Opcjonalne

Rozdzielczość wyjściowa.

Dozwolone wartości: 720p, 1080p Domyślna wartość: 720p
promptstring
Wymagane

Opis wideo.

Zakres: 1 - 2500

Reguły warunkowe

Te wymagania obowiązują, gdy spełnione są wszystkie wymienione warunki.

  1. Kiedy model = kling-o1
    Wymagane
    Nie jest akceptowane
    output_resolution, negative_prompt, cfg_scale
  2. Kiedy model = kling-v2.1-master-image-to-video
    Wymagane
    Nie jest akceptowane
    output_resolution, enable_sound, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
  3. Kiedy model = kling-v2.1-pro
    Wymagane
    Nie jest akceptowane
    output_resolution, enable_sound, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
  4. Kiedy model = kling-v2.1-standard
    Wymagane
    Nie jest akceptowane
    output_resolution, enable_sound, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
  5. Kiedy model = kling-v2.5-turbo-image-to-video-pro
    Wymagane
    Nie jest akceptowane
    output_resolution, enable_sound, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
  6. Kiedy model = kling-v2.6
    Wymagane
    Nie jest akceptowane
    output_resolution, negative_prompt, cfg_scale, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
  7. Kiedy model = kling-v3-omni
    Wymagane
    Nie jest akceptowane
    negative_prompt, cfg_scale, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
  8. Kiedy model = kling-v3-turbo-image-to-video
    Wymagane
    Nie jest akceptowane
    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

Tworzenie akceptacji

HTTP 202

POST /api/v1/kling/image_to_video

Schemat odpowiedzi
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
}

Przykład odpowiedzi

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

Odpytywanie w toku

HTTP 200

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

Schemat odpowiedzi
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
}

Przykład odpowiedzi

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

Odpytywanie zakończone

HTTP 200

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

Schemat odpowiedzi
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
}

Przykład odpowiedzi

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

Odpytywanie nie powiodło się

HTTP 200

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

Schemat odpowiedzi
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
}

Przykład odpowiedzi

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

Wywołanie zwrotne klienta: ukończono

HTTP 200

POST callback_url

Schemat odpowiedzi
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
}

Przykład odpowiedzi

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

Wywołanie zwrotne klienta: niepowodzenie

HTTP 200

POST callback_url

Schemat odpowiedzi
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
}

Przykład odpowiedzi

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

Błędy

HTTP 401

POST /api/v1/kling/image_to_video

Schemat odpowiedzi
JSON 
{
  "properties": {
    "error": {
      "description": "Czytelny dla człowieka komunikat o błędzie.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Przykład odpowiedzi

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

Błędy

HTTP 401

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

Schemat odpowiedzi
JSON 
{
  "properties": {
    "error": {
      "description": "Czytelny dla człowieka komunikat o błędzie.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Przykład odpowiedzi

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

Błędy

HTTP 400

POST /api/v1/kling/image_to_video

Schemat odpowiedzi
JSON 
{
  "oneOf": [
    {
      "properties": {
        "error": {
          "description": "Czytelny dla człowieka komunikat o błędzie.",
          "type": "string"
        }
      },
      "required": [
        "error"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    {
      "properties": {
        "error": {
          "description": "Czytelne dla człowieka podsumowanie walidacji.",
          "type": "string"
        },
        "errors": {
          "additionalProperties": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": "Komunikaty walidacyjne identyfikowane przez publiczne pole żądania, z tablicą czytelnych dla człowieka ciągów znaków dla każdego pola.",
          "type": "object"
        }
      },
      "required": [
        "error",
        "errors"
      ],
      "type": "object",
      "unevaluatedProperties": false
    }
  ]
}

Przykład odpowiedzi

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

Błędy

HTTP 402

POST /api/v1/kling/image_to_video

Schemat odpowiedzi
JSON 
{
  "properties": {
    "error": {
      "description": "Czytelny dla człowieka komunikat o błędzie.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Przykład odpowiedzi

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

Błędy

HTTP 429

POST /api/v1/kling/image_to_video

Schemat odpowiedzi
JSON 
{
  "properties": {
    "error": {
      "description": "Czytelny dla człowieka komunikat o błędzie.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Przykład odpowiedzi

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

Błędy

HTTP 409

POST /api/v1/kling/image_to_video

Schemat odpowiedzi
JSON 
{
  "properties": {
    "error": {
      "description": "Czytelny dla człowieka komunikat o błędzie.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Przykład odpowiedzi

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

Błędy

HTTP 429

POST /api/v1/kling/image_to_video

Schemat odpowiedzi
JSON 
{
  "properties": {
    "error": {
      "description": "Czytelny dla człowieka komunikat o błędzie.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Przykład odpowiedzi

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

Błędy

HTTP 503

POST /api/v1/kling/image_to_video

Schemat odpowiedzi
JSON 
{
  "properties": {
    "error": {
      "description": "Czytelny dla człowieka komunikat o błędzie.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Przykład odpowiedzi

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

Błędy

HTTP 504

POST /api/v1/kling/image_to_video

Schemat odpowiedzi
JSON 
{
  "properties": {
    "error": {
      "description": "Czytelny dla człowieka komunikat o błędzie.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Przykład odpowiedzi

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

Błędy

HTTP 404

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

Schemat odpowiedzi
JSON 
{
  "properties": {
    "error": {
      "description": "Czytelny dla człowieka komunikat o błędzie.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Przykład odpowiedzi

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

Wygenerowane przykłady kodu

Używaj bezpośrednio cURL lub zainstaluj SDK dla swojego języka. Każdy przykład przesyła zwalidowane żądanie pokazane w tej dokumentacji.

Instalacja

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"
)