kling-3.0-turbo API

Utilisez l’ID de modèle exact kling-3.0-turbo. Le champ modèle doit correspondre exactement à cette page.

Exemple de sortiekling-3.0-turboPOST /v1/videos5.0s

Paramètres : duration=5resolution=1080pratio=16:9

Prompt : A skateboarder launches a kickflip over a concrete stair set in a skate park at golden hour. Low-angle slow-motion tracking shot, the board spins under his feet, dust and sunlight flare, he lands and rolls past the camera. Realistic physics, cinematic sports film, no text.

Requête qui a produit cet échantillon

{
  "model": "kling-3.0-turbo",
  "prompt": "A skateboarder launches a kickflip over a concrete stair set in a skate park at golden hour. Low-angle slow-motion tracking shot, the board spins under his feet, dust and sunlight flare, he lands and rolls past the camera. Realistic physics, cinematic sports film, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Authentification et point de terminaison

Utilisez une clé API Modelflare avec https://modelflare.dev/v1. Le point d’entrée de la passerelle est POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Créer une tâche

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo",
    "prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot",
    "settings": {"duration": 5, "resolution": "720p"}
  }'

Sondage et téléchargement

Enregistrez l’ID de la tâche. Sondez GET /v1/videos/{task_id} et téléchargez avec GET /v1/videos/{task_id}/content. Les URL des résultats peuvent expirer, alors transférez le fichier rapidement.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Demander des notes

Kling utilise des champs model_name, prompt, mode, duration, image_list ou contents/settings spécifiques à la famille ; Le JSON natif est préservé et transmis.

Paramètres de requête

Kling 3.0 Turbo sélectionne le modèle dans le chemin URL ; ne mettez pas model_name dans le corps. Le texte vers vidéo et l’image vers vidéo de la première image utilisent des chemins officiels différents.

Champ	Obligatoire	Remarques
prompt	Oui	Invite texte-vidéo ; utiliser la limite de longueur officielle
contents[]	Conditionnel	Pour la conversion image-vidéo, incluez prompt et first_frame
settings.resolution	Non	720p / 1080p
settings.aspect_ratio	Non	16:9 / 9:16 / 1:1
settings.duration	Non	3 à 15 secondes
options.watermark_info	Non	Configuration du filigrane

Limites d’entrée et de sortie

La conversion texte-vidéo et la conversion image-vidéo de la première image utilisent respectivement prompt et contents[]. La sortie est 720p ou 1080p pendant 3 à 15 secondes ; les invites multi-prises prennent en charge jusqu’à six prises de vue.

Exemples de flux de travail documentés

Turbo utilise l’enveloppe contents/settings/options mise à niveau. L’ID du modèle reste dans le champ model de Modelflare et les appels entrent via /v1/videos.

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo",
    "contents": [{"type": "prompt", "text": "列车缓慢驶过雨夜城市"}],
    "settings": {"resolution": "1080p", "aspect_ratio": "16:9", "duration": 5},
    "options": {"watermark_info": {"enabled": false}}
  }'

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo",
    "contents": [{"type": "prompt", "text": "角色转身看向窗外"}, {"type": "first_frame", "url": "https://example.com/first.png"}],
    "settings": {"resolution": "1080p", "duration": 5}
  }'

Erreurs et tâches ayant échoué

Les paramètres de modèle invalides renvoient un 4xx avec un ID de demande. Une tâche asynchrone peut également échouer une fois la création réussie ; utilisez error_code et error_message de la réponse au sondage comme raison finale de la tâche. Ne réessayez pas la même requête avec une forme JSON différente.

Portée prise en charge

Cette page couvre la génération et l’édition de modèles Modelflare. L’enrichissement de la recherche ou de la carte, la gestion de la voix et la gestion de la bibliothèque d’éléments sont des API de ressources en dehors de cette surface d’appel de modèle publique et ne sont pas des champs de requête obligatoires.

Tarification et facturation

Ce modèle utilise la facturation vidéo à la seconde. Consultez la page de tarification du modèle pour connaître le prix client actuel, le prix catalogue de référence et les spécifications complètes.

Note

Cette page documente l’interface publique de Modelflare ; les champs et limites indiqués ici sont le contrat en cours.