Kling 4.0 API

Riferimento completo dell’API per i modelli di generazione video Kling 4.0 di Kuaishou.

Varianti del modello

Questa API supporta cinque varianti del modello:

Confronto rapido

Rapporti d’aspetto supportati

Text-to-Video, Image-to-Video, Reference-to-Video e Video Edit supportano:

16:9, 9:16, 1:1, 21:9

Il valore predefinito è 16:9. Video Extend non supporta il parametro aspect_ratio; l’output mantiene il rapporto d’aspetto del video sorgente.

Opzioni di risoluzione

Tutti e cinque i modelli richiedono resolution e duration. Includere esplicitamente resolution anche se il suo valore predefinito è 720p. duration non ha un valore predefinito.

Kling 4.0 Text to Video

Punto di accesso

POST /api/v1/video/task

Parametri della richiesta

Obbligatori

Facoltativi

Esempio di richiesta

javascriptCopia
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-v4.0-text-to-video',
    prompt: 'A drone flying over a mountain range at sunrise, smooth forward camera movement',
    resolution: '720p',
    duration: 5,
    aspect_ratio: '16:9'
  })
});

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

Kling 4.0 Image to Video

Parametri della richiesta

Obbligatori

Facoltativi

Quando vengono forniti sia image_url sia image_end_url, key_frames può contenere al massimo 8 immagini. I fotogrammi intermedi vengono utilizzati nell’ordine dell’array; la loro collocazione temporale è determinata dal modello.

Esempio di richiesta

javascriptCopia
{
  model_name: 'kling-v4.0-image-to-video',
  prompt: 'Camera slowly pulls back from the character to reveal the surrounding mountain landscape',
  image_url: 'https://example.com/start-frame.jpg',
  image_end_url: 'https://example.com/end-frame.jpg',
  key_frames: [
    'https://example.com/middle-frame-1.jpg',
    'https://example.com/middle-frame-2.jpg'
  ],
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Reference to Video

Parametri della richiesta

Obbligatori

Facoltativi

Immagini, video e audio di riferimento sono tutti facoltativi. Fornire un solo tipo di contenuto multimediale, combinare più tipi oppure ometterli tutti e tre.

Il valore duration dell’output viene impostato indipendentemente tra 3 e 30 secondi e non rientra nel limite di durata complessiva dei video di riferimento.

Esempio di richiesta

javascriptCopia
{
  model_name: 'kling-v4.0-reference-to-video',
  prompt: 'Use the character from the reference image, follow the camera movement in the reference video, and use the reference audio for voice guidance',
  images: ['https://example.com/character-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3'],
  keep_original_sound: false,
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Video Edit

Parametri della richiesta

Obbligatori

Facoltativi

Esempio di richiesta

javascriptCopia
{
  model_name: 'kling-v4.0-video-edit',
  prompt: 'Replace the background with warm sunset colors while preserving the subject and camera movement',
  video_url: 'https://example.com/source.mp4',
  images: ['https://example.com/sunset-reference.jpg'],
  keep_original_sound: true,
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Video Extend

Parametri della richiesta

Obbligatori

Facoltativi

Non inviare aspect_ratio; l’output mantiene il rapporto d’aspetto del video sorgente. Il risultato contiene il video completo, inclusi il video sorgente e l’estensione. La durata totale è pari alla durata del video sorgente più duration.

Esempio di richiesta

javascriptCopia
{
  model_name: 'kling-v4.0-video-extend',
  prompt: 'Continue the camera movement forward through the valley as the sun rises above the mountains',
  video_url: 'https://example.com/source.mp4',
  image_end_url: 'https://example.com/target-end-frame.jpg',
  resolution: '720p',
  duration: 5
}

Regole di fatturazione

Text-to-Video e Image-to-Video vengono fatturati in base alla risoluzione di output e alla durata del video generato. Video Extend viene fatturato in base alla risoluzione e alla durata del segmento aggiuntivo, non alla durata totale del video restituito.

Le richieste Reference-to-Video che contengono video di riferimento e le richieste Video Edit tengono conto sia della durata dei video in ingresso sia di quella dei video in uscita alla risoluzione selezionata. La durata fatturata del video in ingresso ha un minimo di 3 secondi e un massimo di 30 secondi. In presenza di più video di riferimento, questi limiti si applicano alla loro durata complessiva, non a ciascun video separatamente. I limiti della durata fatturata non definiscono i limiti di caricamento.

Senza video di riferimento, Reference-to-Video utilizza le stesse regole di fatturazione di Text-to-Video, indipendentemente dalla presenza di immagini o audio di riferimento. Per le richieste con video in ingresso, le immagini di riferimento supportate, l’audio di riferimento e keep_original_sound non comportano addebiti separati.

Formato della risposta

Risposta iniziale

Tutti i modelli restituiscono un task_id per le interrogazioni periodiche:

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

Eseguire 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

1. Parametri obbligatori: fornire sempre resolution e duration, anche quando si utilizza la risoluzione predefinita 720p
2. Numero di fotogrammi: mantenere il totale del fotogramma iniziale, del fotogramma finale e dei fotogrammi intermedi entro 10
3. Contenuti multimediali di riferimento: rispettare i limiti documentati relativi a quantità e durate dei contenuti multimediali di riferimento
4. Audio originale: utilizzare keep_original_sound solo per Reference-to-Video o Video Edit
5. Estensione del video: impostare duration sulla durata aggiuntiva e omettere aspect_ratio