Zum Inhalt springen
API-Referenz

Kling Text zu Video

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

Markdown anzeigen
01

Übersicht

Verwenden Sie den Endpunkt „Text 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/text_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-3.014 Felder
aspect_ratiostring
Optional

Ausgabe-Seitenverhältnis.

Zulässige Werte: 16:9, 9:16, 1:1
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: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
enable_soundboolean
Optional

Tongenerierung aktivieren.

first_frame_image_urlstring
Optional

URL des ersten Frames.

kling_elementsarray
Optional

Elementreferenzen mit Bild-, Video- oder Audiomaterial.

last_frame_image_urlstring
Optional

URL des letzten Frame-Bildes für den Einzelaufnahme-Modus.

modelstring
Erforderlich

Modell-Slug.

multi_promptarray
Optional

Prompt-Segmente für den Multi-Shot-Modus.

multi_shotsboolean
Optional

Multi-Shot-Generierung aktivieren.

negative_promptstring
Optional

Negativer Prompt.

output_resolutionstring
Optional

Ausgabeauflösung.

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

Videobeschreibung. Erforderlich, sofern multi_shots nicht aktiviert ist.

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

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.

kling-v2.1-master-text-to-video8 Felder
aspect_ratiostring
Optional

Ausgabe-Seitenverhältnis.

Zulässige Werte: 16:9, 9:16, 1:1
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
enable_soundboolean
Optional

Tongenerierung aktivieren.

modelstring
Erforderlich

Modell-Slug.

negative_promptstring
Optional

Negativer Prompt.

promptstring
Optional

Videobeschreibung.

kling-v2.5-turbo-text-to-video-pro8 Felder
aspect_ratiostring
Optional

Ausgabe-Seitenverhältnis.

Zulässige Werte: 16:9, 9:16, 1:1
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
enable_soundboolean
Optional

Tongenerierung aktivieren.

modelstring
Erforderlich

Modell-Slug.

negative_promptstring
Optional

Negativer Prompt.

promptstring
Optional

Videobeschreibung.

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

Generierungsmodus.

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

Modell-Slug.

promptstring
Erforderlich

Videobeschreibung.

Bereich: 1 - 2500
kling-v3-omni7 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
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-omni-reference8 Felder
aspect_ratiostring
Erforderlich

Ausgabe-Seitenverhältnis.

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

Webhook-URL für asynchrone Benachrichtigungen.

duration_secondsinteger
Optional

Ausgabedauer 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
modelstring
Erforderlich

Modell-Slug.

output_resolutionstring
Optional

Ausgabeauflösung.

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

Videobeschreibung.

Bereich: 1 - 2500
reference_image_urlsarray
Erforderlich

Geordnete ReferenzbildURLs.

Elementbereich: 1 - 7
kling-v3-turbo-text-to-video6 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
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-3.0
    Erforderlich
    Nicht akzeptiert
    reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
  2. Wenn model = kling-o1
    Erforderlich
    Nicht akzeptiert
    output_resolution, negative_prompt, cfg_scale, multi_shots, multi_prompt, first_frame_image_url, last_frame_image_url, kling_elements
  3. Wenn model = kling-v2.1-master-text-to-video
    Erforderlich
    Nicht akzeptiert
    mode, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
  4. Wenn model = kling-v2.5-turbo-text-to-video-pro
    Erforderlich
    Nicht akzeptiert
    mode, reference_image_urls, reference_video_url, reference_video_type, preserve_reference_video_audio
  5. Wenn model = kling-v2.6
    Erforderlich
    Nicht akzeptiert
    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
  6. Wenn model = kling-v3-omni
    Erforderlich
    Nicht akzeptiert
    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
  7. Wenn model = kling-v3-turbo-text-to-video
    Erforderlich
    Nicht akzeptiert
    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

Annahme erstellen

HTTP 202

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

Fehler

HTTP 402

POST /api/v1/kling/text_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/text_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/text_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/text_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/text_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/text_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/text_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.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"
)