API Kling 2.6 Motion Control

Riferimento API completo per la generazione video con Kling 2.6 Motion Control di Kuaishou.

Varianti del modello

Questa API supporta una variante del modello:

Modello	ID	Descrizione
Kling 2.6 Motion Control	`kling-2.6-motion-control`	Generazione video con un prompt testuale, un'immagine di riferimento e un video di riferimento

Kling 2.6 Motion Control

Punto di accesso

POST /api/v1/video/task

Parametri della richiesta

Obbligatori

Parametro	Tipo	Descrizione
`model_name`	string	Deve essere `"kling-2.6-motion-control"`
`prompt`	string	Prompt per la generazione video, fino a 5000 caratteri
`images`	string[]	Esattamente un URL di immagine di riferimento. Supporta `.jpg`, `.jpeg` e `.png`; la dimensione del file non deve superare 50 MB. Larghezza e altezza devono essere entrambe di almeno 300 px, con un rapporto d'aspetto dell'immagine compreso tra 1:2.5 e 2.5:1
`videos`	string[]	Esattamente un URL di video di riferimento. Supporta `.mp4` e `.mov`; la dimensione del file non deve superare 100 MB. Larghezza e altezza devono essere entrambe comprese tra 340 e 3850 px, estremi inclusi. La durata deve essere di almeno 3 secondi; il massimo dipende da `character_orientation`
`character_orientation`	string	Obbligatorio, senza valore predefinito. `"image"`: segue l'orientamento del personaggio nell'immagine di riferimento; il video di riferimento deve durare 3-10 secondi. `"video"`: segue l'orientamento del personaggio nel video di riferimento; il video di riferimento deve durare 3-30 secondi. Entrambi gli intervalli di durata includono gli estremi
`resolution`	string	Risoluzione di output: `"720p"` o `"1080p"`. Obbligatorio, senza valore predefinito

Facoltativi

Parametro	Tipo	Descrizione
`keep_original_sound`	boolean	Indica se mantenere l'audio originale del video di riferimento. Accetta `true` o `false`; il valore predefinito è `true`

La durata dell'output segue quella del video sorgente. Il parametro duration non è supportato. Il rapporto d'aspetto dell'output è determinato dai contenuti multimediali in ingresso e aspect_ratio non è supportato. Il fornitore a monte non ha specificato quale input determini il rapporto d'aspetto dell'output né la regola esatta di selezione.

La fatturazione si basa sulla durata del video sorgente arrotondata al secondo intero più vicino e sulla risoluzione di output selezionata. Ad esempio, 5,4 secondi vengono fatturati come 5 secondi e 5,5 secondi come 6 secondi.

Esempio di richiesta

Sostituisci gli URL dei contenuti multimediali di esempio con quelli dei tuoi file che soddisfano i requisiti indicati sopra.

javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'kling-2.6-motion-control',
    prompt: 'Animate the character in the reference image using the dance movements from the reference video',
    images: ['https://example.com/character.jpg'],
    videos: ['https://example.com/dance-reference.mp4'],
    character_orientation: 'video',
    resolution: '720p',
    keep_original_sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Formato della risposta

Risposta iniziale

Restituisce un task_id da usare per il polling:

json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Esegui il polling con GET /api/v1/video/{task_id} per verificare lo stato e recuperare il video generato.

Valori di stato

submitted: Attività accettata e in attesa di elaborazione
processing: Generazione video in corso
succeed: Generazione video completata
failed: Generazione video non riuscita

Buone pratiche

Contenuti multimediali di riferimento: Fornisci esattamente un'immagine e un video, verificandone formati, dimensioni dei file e dimensioni in pixel prima dell'invio
Orientamento: Ricontrolla la durata del video di riferimento quando modifichi character_orientation, soprattutto se selezioni "image"
Audio originale: Imposta keep_original_sound su false per non mantenere l'audio originale del video di riferimento; se ometti il parametro, l'audio viene mantenuto