API di Kling 3.0 Motion Control

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

Varianti del modello

Questa API supporta una variante del modello:

Modello	ID	Descrizione
Kling 3.0 Motion Control	`kling-3.0-motion-control`	Generazione di video tramite un prompt testuale, un’immagine di riferimento e un video di riferimento

Kling 3.0 Motion Control

Punto di accesso

POST /api/v1/video/task

Parametri della richiesta

Obbligatori

Parametro	Tipo	Descrizione
`model_name`	string	Deve essere `"kling-3.0-motion-control"`
`prompt`	string	Prompt per la generazione del video, fino a 5000 caratteri
`images`	string[]	Esattamente un URL di immagine di riferimento. Sono supportati `.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. Sono supportati `.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 corrisponde a quella del video sorgente. Il parametro duration non è supportato. Il rapporto d’aspetto dell’output è determinato dai contenuti multimediali di input 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 multimediali di esempio con quelli dei tuoi file che soddisfano i requisiti sopra indicati.

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-3.0-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 per le interrogazioni periodiche:

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 interrogazioni periodiche 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 del video in corso
succeed: Generazione del video completata
failed: Generazione del 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 cambi character_orientation, soprattutto quando selezioni "image"
Audio originale: Imposta keep_original_sound su false per disattivare il mantenimento dell’audio originale del video di riferimento; omettendo il parametro, l’audio viene mantenuto