> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sunra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Da testo a video

### Come generare video utilizzando l'API sunra

sunra offre un'API semplice e facile da usare che ti consente di generare video dal tuo prompt utilizzando modelli pre-addestrati. Questo endpoint è perfetto per creare videoclip dal tuo prompt per vari casi d'uso come social media, marketing e altro ancora.

Ecco un esempio di come generare video utilizzando l'API sunra:

<CodeGroup>
  ```javascript Javascript theme={null}
  import { sunra } from "@sunra/client";

  const result = await sunra.subscribe("kling/kling-v2-master/text-to-video", {
    input: {
      prompt: 'Un orso polare che suona il violino sulla neve.',
      guidance_scale: 0.5,
      aspect_ratio: '16:9',
      duration: 5
    },
    logs: true,
    onQueueUpdate: (update) => {
      console.log(update)
    },
  });
  console.log(result.data);
  console.log(result.requestId);
  ```

  ```python Python theme={null}
  import sunra_client

  result = sunra_client.subscribe(
      "kling/kling-v2-master/text-to-video",
      arguments={
          "prompt": "Un orso polare che suona il violino sulla neve.",
          "guidance_scale": 0.5,
          "aspect_ratio": "16:9",
          "duration": 5
      },
      with_logs=True,
      on_enqueue=print,
      on_queue_update=print,
  )
  print(result)
  ```

  ```java Java theme={null}
  import ai.sunra.client.*;
  import ai.sunra.client.queue.*;
  import java.util.Map;
  import com.google.gson.JsonObject;
  import java.util.function.Consumer;

  ClientConfig config = ClientConfig.builder()
      .withCredentials(CredentialsResolver.fromEnv())
      .build();

  SunraClient client = SunraClient.withConfig(config);
  Map<String, Object> input = Map.of(
      "prompt", "Un orso polare che suona il violino sulla neve.",
      "guidance_scale", 0.5,
      "aspect_ratio", "16:9",
      "duration", 5
  );

  Consumer<QueueStatus.StatusUpdate> statusUpdateHandler = update -> {
      String status = update.getStatus().toString();
      String message = String.format("\nAggiornamento stato: %s, ID richiesta: %s",
          status, update.getRequestId());
      System.out.println(message);
  };

  SubscribeOptions<JsonObject> options = SubscribeOptions.<JsonObject>builder()
      .input(input)
      .resultType(JsonObject.class)
      .onQueueUpdate(statusUpdateHandler)
      .logs(true)
      .build();

  Output<JsonObject> response = client.subscribe("kling/kling-v2-master/text-to-video", options);
  System.out.println("Completato!");
  System.out.println(response.getData());
  ```

  ```bash Curl theme={null}
  curl --request POST \
    --url https://api.sunra.ai/v1/queue/kling/kling-v2-master/text-to-video \
    --header "Authorization: Key $SUNRA_KEY" \
    --header "Content-Type: application/json" \
    --data '{"prompt":"Un orso polare che suona il violino sulla neve.","negative_prompt":"","guidance_scale":0.5,"aspect_ratio":"16:9","duration":5}'
  ```
</CodeGroup>

```javascript theme={null}
import { sunra } from "@sunra/client";

const result = await sunra.subscribe("kling/kling-v2-master/image-to-video", {
  input: {
  	prompt: 'Un simpatico criceto giace tranquillamente su un salvagente, indossando occhiali da sole alla moda, e si lascia trasportare dalle dolci onde sulla superficie scintillante del mare. Il criceto si sdraia comodamente, godendosi un momento di pace e piacevole. Stile cartone animato, la telecamera segue il soggetto in movimento, con una qualità dell\'immagine commovente e alta.',
  	start_image: 'https://assets.sunra.ai/uploads/1748811753168-05ceab0d.png'
  },
  logs: true,
  onQueueUpdate: (update) => {
    console.log(update)
  },
});
console.log(result.data);
console.log(result.requestId);
```

### Come selezionare il modello da utilizzare

sunra offre una varietà di modelli di generazione video. Puoi selezionare il modello che meglio si adatta alle tue esigenze in base allo stile e alla qualità dei video che desideri generare. Ecco alcuni dei modelli disponibili:

* [kling/kling-v2-master/text-to-video](https://sunra.ai/models/kling/kling-v2-master/text-to-video): Kling V2 Master è progettato per migliorare l'aderenza ai prompt, la dinamica del movimento e l'estetica visiva.
* [wan/wan2.1-vace-14b/text-to-video](https://sunra.ai/models/wan/wan2.1-vace-14b/text-to-video): Un modello 14B all-in-one per la creazione e la modifica di video, che supporta attività come da testo a video, da immagine a video e modifica video con input multimodali e funzionalità di controllo avanzate.
* [vidu/viduq1/text-to-video](https://sunra.ai/models/vidu/viduq1/text-to-video): Vidu Q1 — Qualità estrema con immagini nitide, transizioni cinematografiche, suono preciso e animazioni espressive.
* [minimax/t2v-01-director/text-to-video](https://sunra.ai/models/minimax/t2v-01-director/text-to-video): Il modello “Camera Control” offre agli utenti un linguaggio cinematografico con la fluidità di un regista professionista e di esercitare un meticoloso controllo creativo.

Per selezionare un modello, specifica semplicemente l'ID del modello nel metodo `subscribe` come mostrato nell'esempio sopra. Puoi trovare altri modelli e le loro descrizioni nella pagina [Modelli da testo a video](https://sunra.ai/models?modalities%5B0%5D=modality-text-video).