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

# Panoramica dell'API Runway

> Scegli un modello di immagini, video o audio Runway e il relativo endpoint CometAPI, quindi recupera il risultato del task.

Usa i modelli Runway tramite CometAPI per generare immagini, creare o modificare video,
produrre voce ed effetti sonori oppure elaborare l'audio. Ogni richiesta di creazione
restituisce un task `id`; usa l'endpoint del task per recuperarne lo stato e gli URL di output.

## Scegli un modello e un endpoint

I seguenti modelli sono disponibili tramite questi endpoint Runway. Ogni
riferimento collegato descrive i parametri dei relativi modelli.

| Task                                                | ID modello                                          | Endpoint                                                                   |
| --------------------------------------------------- | --------------------------------------------------- | -------------------------------------------------------------------------- |
| Generare un'immagine                                | `gen4_image`, `gen4_image_turbo`                    | [Da testo a immagine](./official-format/generate-an-image-from-text)       |
| Animare un'immagine                                 | `gen4.5`, `gen4_turbo`                              | [Da immagine a video](./official-format/runway-images-raw-video)           |
| Generare un video dal testo                         | `gen4.5`                                            | [Da testo a video](./official-format/generate-a-video-from-text)           |
| Modificare un video                                 | `aleph2`                                            | [Da video a video](./official-format/generate-a-video-from-a-video)        |
| Animare un personaggio a partire da una performance | `act_two`                                           | [Performance del personaggio](./official-format/control-a-character)       |
| Migliorare la risoluzione di un video               | `magnific_video_upscaler_creative`                  | [Miglioramento della risoluzione video](./official-format/upscale-a-video) |
| Generare effetti sonori                             | `eleven_text_to_sound_v2`, `seed_audio`             | [Effetti sonori](./official-format/generate-sound-effects)                 |
| Generare voce dal testo                             | `eleven_multilingual_v2`, `eleven_v3`, `seed_audio` | [Da testo a voce](./official-format/generate-speech-from-text)             |
| Convertire una voce                                 | `eleven_multilingual_sts_v2`                        | [Da voce a voce](./official-format/convert-speech)                         |
| Doppiare l'audio in un'altra lingua                 | `eleven_voice_dubbing`                              | [Doppiaggio vocale](./official-format/dub-audio)                           |
| Separare la voce dall'audio di sottofondo           | `eleven_voice_isolation`                            | [Isolamento della voce](./official-format/isolate-voice)                   |

`gen4.5` supporta richieste sia text-to-video sia image-to-video.
`gen4_turbo` utilizza richieste image-to-video. `seed_audio` presenta campi di input diversi
per gli effetti sonori e text-to-speech; segui la variante di modello dell'endpoint selezionato.
variante di modello.

## Creare un task e recuperare il risultato

<Steps>
  <Step title="Scegli l'endpoint e il modello">
    Seleziona il task sopra, quindi usa lo schema di richiesta specifico del modello e
    l'esempio nella pagina di tale endpoint.
  </Step>

  <Step title="Invia la richiesta">
    [Archivia localmente la tua chiave API](/it/overview/quick-start#store-your-api-key-locally)
    come `$COMETAPI_KEY` prima di eseguire gli esempi.
    Invia JSON a `https://api.cometapi.com/runwayml/v1` seguito dal
    percorso dell'endpoint. Autenticati con `Authorization: Bearer <COMETAPI_KEY>`.
  </Step>

  <Step title="Salva l'ID del task">
    Salva il valore `id` restituito per la richiesta di recupero del task.
  </Step>

  <Step title="Recupera l'output">
    Usa [Recupera un task Runway](./official-format/runway-to-get-task-details)
    con una chiave API dello stesso account CometAPI. Quando `status` è
    `SUCCEEDED`, scarica e archivia le risorse elencate in `output`.
  </Step>
</Steps>

Per gli input multimediali, usa URL HTTPS accessibili o il formato URI data mostrato in
lo schema dell'endpoint. Sostituisci gli URL dei contenuti multimediali di esempio con i tuoi input quando
l'esempio richiede un file video o audio sorgente.