Texte vers vidéo

Le prompt peut décrire ce qui est souhaité et ce qui doit être évité. settings règle durée, résolution et ratio ; options configure rappels et filigranes.

POST/kling/text-to-video/kling-4.0

Générez Kling 4.0 depuis un prompt. Le chemin fixe le modèle ; model n’est pas requis dans le corps.

Authentification

bearerAuth

AuthentificationBearer <token>

API Key plateforme : Authorization: Bearer your-api-key.

Emplacement: header

Corps de requête

application/json

Définitions TypeScript

Utilisez le type request body en TypeScript.

prompt*Prompt

Descriptions positives et négatives dans le prompt. Anglais seul : maximum 26000 caractères ; autres langues seules : 11000. Mélange : E/26000 + N/11000 <= 1 ; E compte les caractères anglais, N les autres.

settings?

options?

Corps de réponse

`application/json`

curl -X POST "https://api.agtcloud.cn/kling/text-to-video/kling-4.0" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Côte lumineuse, caméra avançant lentement, vagues effleurant le sable.",
    "settings": {
      "duration": 3,
      "resolution": "720p"
    }
  }'

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "REQUEST_ID",
  "data": {
    "id": "123456789012345678",
    "status": "submitted",
    "message": "",
    "create_time": 1792713600000,
    "update_time": 1792713600000
  }
}

Erreurs courantes et dépannage

Réponse ou erreur	Vérification et action
HTTP 401, `Invalid token`	Vérifiez le format Bearer et le site de l’API Key
HTTP 400, `prompt cannot be empty`	Fournissez un prompt textuel non vide
HTTP 400, `prompt value type is invalid`	`prompt` doit être une chaîne, pas un tableau ou un objet
HTTP 400, `invalid_request`	Vérifiez les types, dont `settings.duration` ; la durée doit être entière
HTTP 400, résolution ou ratio invalide	Utilisez les valeurs documentées pour `settings.resolution` et `settings.aspect_ratio`
HTTP 400, `invalid JSON request body`	Vérifiez le JSON et retirez les commentaires du corps

Les erreurs de validation génériques peuvent citer une plage plus large que celle du modèle. Cette API accepte des durées entières de 3～30 secondes, en 720p ou 1080p. Ne déduisez pas d’autres capacités du seul message d’erreur.

Une erreur de création peut renvoyer code/message/data ou un objet error, contrairement au succès. La cause de fail_to_fetch_task figure dans message, éventuellement une chaîne JSON contenant code/message/request_id. Conservez l’identifiant de requête, jamais l’API Key.

Authentification

Corps de requête

Corps de réponse

200application/json

400application/json

401application/json

Erreurs courantes et dépannage

`application/json`

`application/json`

`application/json`