Zum Inhalt springen
API-Referenz
API-Referenz

Kling Bild zu Video

Verwenden Sie den Endpunkt „Bild zu Video", um einen asynchronen Task zu erstellen.

Markdown anzeigen
01

Übersicht

Verwenden Sie den Endpunkt „Bild zu Video" mit einem unterstützten Modell. Verwenden Sie die zurückgegebene Task-ID, um den Status abzurufen, oder geben Sie callback_url für die unten dokumentierten Zustellungen an.

Schnellstart

  1. Erstellen Sie einen API-Schlüssel und setzen Sie ihn als RUNAPI_API_KEY.
  2. Wählen Sie ein unterstütztes Modell und senden Sie eine POST-Anfrage, deren Body dem Schema dieses Modells entspricht.
  3. Speichern Sie die zurückgegebene Task-ID und fragen Sie den Status ab, bis ein Endzustand erreicht ist, oder verarbeiten Sie die unten dokumentierten Callbacks.

Endpunkt

POST /api/v1/kling/image_to_video
Basis-URL
https://runapi.ai
API-Version
v1
Authentifizierung
Authorization: Bearer YOUR_API_TOKEN
02

Unterstützte Modelle

Öffnen Sie eine Modellseite für aktuelle Preise, Ratenlimits und Details zur kommerziellen Nutzung.

03

Anfrage-Schema

JSON-Body

Felder und zulässige Werte hängen vom ausgewählten Modell ab. Wenn angegeben, empfängt callback_url die unten dokumentierten Task-Zustellungen.

kling-o113 Felder
aspect_ratiostring
Optional

Ausgabe-Seitenverhältnis.

Zulässige Werte: 16:9, 9:16, 1:1 Standard: 16:9
callback_urlstring
Optional

Webhook-URL für asynchrone Benachrichtigungen.

duration_secondsinteger
Optional

Dauer in Sekunden.

Zulässige Werte: 5 Standard: 5
enable_soundboolean
Optional

Die Klanggenerierung muss deaktiviert bleiben.

Standard: false
first_frame_image_urlstring
Erforderlich

Öffentliche HTTP(S)-JPG-, JPEG- oder PNG-Bild-URL des ersten Frames.

last_frame_image_urlstring
Optional

Öffentliche HTTP(S)-JPG-, JPEG- oder PNG-Bild-URL des letzten Frames; kann nicht mit reference_image_urls oder reference_video_url kombiniert werden.

modestring
Optional

Generierungsmodus.

Zulässige Werte: std, pro Standard: std
modelstring
Erforderlich

Modell-Slug.

preserve_reference_video_audioboolean
Optional

Den Originalton des Referenzvideos beibehalten.

Standard: false
promptstring
Erforderlich

Videobeschreibung; Referenzmedien mit entsprechend nummerierten Markierungen angeben.

Bereich: 1 - 2500
reference_image_urlsarray
Optional

Geordnete öffentliche HTTP(S) JPG-, JPEG- oder PNG-ReferenzbildURLs; kann nicht mit last_frame_image_url kombiniert werden.

Elementbereich: 1 - 7
reference_video_typestring
Optional

Verwenden Sie das Video als Basis für die Bearbeitung oder als Funktionsreferenz.

Zulässige Werte: base, feature Standard: base
reference_video_urlstring
Optional

Öffentliche HTTP(S)-MP4- oder MOV-Referenzvideo-URL; kann nicht mit last_frame_image_url kombiniert werden.

kling-v2.1-master-image-to-video9 Felder
aspect_ratiostring
Optional

Ausgabe-Seitenverhältnis.

callback_urlstring
Optional

Webhook-URL für asynchrone Benachrichtigungen.

cfg_scalenumber
Optional

Führungsskala (0–1).

duration_secondsinteger
Optional

Dauer in Sekunden.

Zulässige Werte: 5, 10
first_frame_image_urlstring
Erforderlich

URL des ersten Frames.

last_frame_image_urlstring
Optional

URL des abschließenden Frames für unterstützte Bild-zu-Video-Modelle.

modelstring
Erforderlich

Modell-Slug.

negative_promptstring
Optional

Negativer Prompt.

promptstring
Erforderlich

Videobeschreibung.

kling-v2.1-pro9 Felder
aspect_ratiostring
Optional

Ausgabe-Seitenverhältnis.

callback_urlstring
Optional

Webhook-URL für asynchrone Benachrichtigungen.

cfg_scalenumber
Optional

Führungsskala (0–1).

duration_secondsinteger
Optional

Dauer in Sekunden.

Zulässige Werte: 5, 10
first_frame_image_urlstring
Erforderlich

URL des ersten Frames.

last_frame_image_urlstring
Optional

URL des abschließenden Frames für unterstützte Bild-zu-Video-Modelle.

modelstring
Erforderlich

Modell-Slug.

negative_promptstring
Optional

Negativer Prompt.

promptstring
Erforderlich

Videobeschreibung.

kling-v2.1-standard9 Felder
aspect_ratiostring
Optional

Ausgabe-Seitenverhältnis.

callback_urlstring
Optional

Webhook-URL für asynchrone Benachrichtigungen.

cfg_scalenumber
Optional

Führungsskala (0–1).

duration_secondsinteger
Optional

Dauer in Sekunden.

Zulässige Werte: 5, 10
first_frame_image_urlstring
Erforderlich

URL des ersten Frames.

last_frame_image_urlstring
Optional

URL des abschließenden Frames für unterstützte Bild-zu-Video-Modelle.

modelstring
Erforderlich

Modell-Slug.

negative_promptstring
Optional

Negativer Prompt.

promptstring
Erforderlich

Videobeschreibung.

kling-v2.5-turbo-image-to-video-pro9 Felder
aspect_ratiostring
Optional

Ausgabe-Seitenverhältnis.

callback_urlstring
Optional

Webhook-URL für asynchrone Benachrichtigungen.

cfg_scalenumber
Optional

Führungsskala (0–1).

duration_secondsinteger
Optional

Dauer in Sekunden.

Zulässige Werte: 5, 10
first_frame_image_urlstring
Erforderlich

URL des ersten Frames.

last_frame_image_urlstring
Optional

URL des abschließenden Frames für unterstützte Bild-zu-Video-Modelle.

modelstring
Erforderlich

Modell-Slug.

negative_promptstring
Optional

Negativer Prompt.

promptstring
Erforderlich

Videobeschreibung.

kling-v2.69 Felder
aspect_ratiostring
Optional

Ausgabe-Seitenverhältnis.

Zulässige Werte: 16:9, 9:16, 1:1 Standard: 16:9
callback_urlstring
Optional

Webhook-URL für asynchrone Benachrichtigungen.

duration_secondsinteger
Optional

Dauer in Sekunden.

Zulässige Werte: 5, 10 Standard: 5
enable_soundboolean
Optional

Tongenerierung aktivieren; erfordert den Pro-Modus.

Standard: false
first_frame_image_urlstring
Erforderlich

URL des ersten Frames.

last_frame_image_urlstring
Optional

URL des abschließenden Frames; erfordert den Pro-Modus und 5 Sekunden.

modestring
Optional

Generierungsmodus.

Zulässige Werte: std, pro Standard: std
modelstring
Erforderlich

Modell-Slug.

promptstring
Erforderlich

Videobeschreibung.

Bereich: 1 - 2500
kling-v3-omni9 Felder
aspect_ratiostring
Optional

Ausgabe-Seitenverhältnis.

Zulässige Werte: 16:9, 9:16, 1:1 Standard: 16:9
callback_urlstring
Optional

Webhook-URL für asynchrone Benachrichtigungen.

duration_secondsinteger
Optional

Dauer in Sekunden.

Zulässige Werte: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Standard: 5
enable_soundboolean
Optional

Synchronisierte Tongenerierung aktivieren.

Standard: false
first_frame_image_urlstring
Erforderlich

URL des ersten Frames.

last_frame_image_urlstring
Optional

URL des abschließenden Frames; erfordert eine Dauer von 5 Sekunden.

modelstring
Erforderlich

Modell-Slug.

output_resolutionstring
Optional

Ausgabeauflösung.

Zulässige Werte: 720p, 1080p, 4k Standard: 720p
promptstring
Erforderlich

Videobeschreibung.

Bereich: 1 - 2500
kling-v3-turbo-image-to-video6 Felder
callback_urlstring
Optional

Webhook-URL für asynchrone Benachrichtigungen.

duration_secondsinteger
Optional

Dauer in Sekunden.

Zulässige Werte: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Standard: 5
first_frame_image_urlstring
Erforderlich

URL des ersten Frames.

modelstring
Erforderlich

Modell-Slug.

output_resolutionstring
Optional

Ausgabeauflösung.

Zulässige Werte: 720p, 1080p Standard: 720p
promptstring
Erforderlich

Videobeschreibung.

Bereich: 1 - 2500

Bedingte Regeln

Diese Anforderungen gelten, wenn alle aufgeführten Bedingungen zutreffen.

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

Annahme erstellen

HTTP 202

POST /api/v1/kling/image_to_video

Antwort-Schema
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
}

Antwortbeispiel

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

Abfrage wird verarbeitet

HTTP 200

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

Antwort-Schema
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
}

Antwortbeispiel

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

Abfrage abgeschlossen

HTTP 200

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

Antwort-Schema
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
}

Antwortbeispiel

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

Abfrage fehlgeschlagen

HTTP 200

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

Antwort-Schema
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
}

Antwortbeispiel

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

Kunden-Callback: abgeschlossen

HTTP 200

POST callback_url

Antwort-Schema
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
}

Antwortbeispiel

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

Kunden-Callback: fehlgeschlagen

HTTP 200

POST callback_url

Antwort-Schema
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
}

Antwortbeispiel

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

Fehler

HTTP 401

POST /api/v1/kling/image_to_video

Antwort-Schema
JSON 
{
  "properties": {
    "error": {
      "description": "Für Menschen lesbare Fehlermeldung.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Antwortbeispiel

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

Fehler

HTTP 401

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

Antwort-Schema
JSON 
{
  "properties": {
    "error": {
      "description": "Für Menschen lesbare Fehlermeldung.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Antwortbeispiel

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

Fehler

HTTP 400

POST /api/v1/kling/image_to_video

Antwort-Schema
JSON 
{
  "oneOf": [
    {
      "properties": {
        "error": {
          "description": "Für Menschen lesbare Fehlermeldung.",
          "type": "string"
        }
      },
      "required": [
        "error"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    {
      "properties": {
        "error": {
          "description": "Menschenlesbare Validierungszusammenfassung.",
          "type": "string"
        },
        "errors": {
          "additionalProperties": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": "Validierungsmeldungen nach öffentlichem Anforderungsfeld gegliedert, mit einem Array menschenlesbarer Zeichenketten für jedes Feld.",
          "type": "object"
        }
      },
      "required": [
        "error",
        "errors"
      ],
      "type": "object",
      "unevaluatedProperties": false
    }
  ]
}

Antwortbeispiel

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

Fehler

HTTP 402

POST /api/v1/kling/image_to_video

Antwort-Schema
JSON 
{
  "properties": {
    "error": {
      "description": "Für Menschen lesbare Fehlermeldung.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Antwortbeispiel

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

Fehler

HTTP 429

POST /api/v1/kling/image_to_video

Antwort-Schema
JSON 
{
  "properties": {
    "error": {
      "description": "Für Menschen lesbare Fehlermeldung.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Antwortbeispiel

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

Fehler

HTTP 409

POST /api/v1/kling/image_to_video

Antwort-Schema
JSON 
{
  "properties": {
    "error": {
      "description": "Für Menschen lesbare Fehlermeldung.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Antwortbeispiel

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

Fehler

HTTP 429

POST /api/v1/kling/image_to_video

Antwort-Schema
JSON 
{
  "properties": {
    "error": {
      "description": "Für Menschen lesbare Fehlermeldung.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Antwortbeispiel

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

Fehler

HTTP 503

POST /api/v1/kling/image_to_video

Antwort-Schema
JSON 
{
  "properties": {
    "error": {
      "description": "Für Menschen lesbare Fehlermeldung.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Antwortbeispiel

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

Fehler

HTTP 504

POST /api/v1/kling/image_to_video

Antwort-Schema
JSON 
{
  "properties": {
    "error": {
      "description": "Für Menschen lesbare Fehlermeldung.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Antwortbeispiel

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

Fehler

HTTP 404

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

Antwort-Schema
JSON 
{
  "properties": {
    "error": {
      "description": "Für Menschen lesbare Fehlermeldung.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Antwortbeispiel

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

Generierte Code-Beispiele

Verwende cURL direkt oder installiere ein SDK für deine Programmiersprache. Jedes Beispiel übermittelt die in dieser Referenz gezeigte validierte Anfrage.

Installieren

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