Luma AImodelli - Amazon Bedrock
Text-to-Video GenerazioneImage-to-Video GenerazioneRisoluzione dei problemiNote sulle prestazioniDocumentazione correlata

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Luma AImodelli

Questa sezione descrive i parametri di richiesta e i campi di risposta per i modelli Luma AI. Usa queste informazioni per effettuare chiamate di inferenza ai modelli Luma AI con l'operazione. StartAsyncInvoke Questa sezione include anche esempi di codice Python che mostrano come chiamare i modelli Luma AI. Per utilizzare un modello in un'operazione di inferenza, è necessario l'ID del modello.

  • ID del modello: luma.ray-v 2:0

  • Nome del modello: Luma Ray 2

  • Modello da testo a video

I modelli Luma AI elaborano i prompt dei modelli in modo asincrono utilizzando Async, tra cui, e. APIs StartAsyncInvokeGetAsyncInvokeListAsyncInvokes

Il modello Luma AI elabora i prompt utilizzando i seguenti passaggi.

  • L'utente richiede al modello di utilizzare. StartAsyncInvoke

  • Attendi che InvokeJob sia terminato. È possibile utilizzare GetAsyncInvoke o ListAsyncInvokes per controllare lo stato di completamento del lavoro.

  • L'output del modello verrà inserito nel bucket Amazon S3 di output specificato

Per ulteriori informazioni sull'utilizzo dei modelli Luma AI con APIs, consulta Generazione video.

Luma AIchiamata di inferenza. 

POST /async-invoke HTTP/1.1
Content-type: application/json
{
  "modelId": "luma.ray-v2:0",
  "modelInput": {
    "prompt": "your input text here",
    "aspect_ratio": "16:9",
    "loop": false,
    "duration": "5s",
    "resolution": "720p"
  },
  "outputDataConfig": {
    "s3OutputDataConfig": {
      "s3Uri": "s3://your-bucket-name"
    }
  }
}

Campi

  • prompt — (stringa) Il contenuto necessario nel video in uscita (1 <= lunghezza <= 5000 caratteri).

  • aspect_ratio — (enum) Le proporzioni del video in uscita (» 1:1 «," 16:9 «," 9:16 «," 4:3 «," 3:4 «," 21:9 «," 9:21 «).

  • loop — (boolean) Indica se riprodurre in loop il video in uscita.

  • duration — (enum) - La durata del video in uscita («5s», «9s»).

  • risoluzione — (enum) La risoluzione del video in uscita («540p», «720p»).

Il MP4 file verrà archiviato nel bucket Amazon S3 come configurato nella risposta.

Text-to-Video Generazione

Genera video da istruzioni di testo utilizzando il modello Luma Ray 2. Il modello supporta varie opzioni di personalizzazione tra cui proporzioni, durata, risoluzione e loop.

Text-to-VideoRichiesta di base

{
  "modelId": "luma.ray-v2:0",
  "modelInput": {
    "prompt": "an old lady laughing underwater, wearing a scuba diving suit"
  },
  "outputDataConfig": {
    "s3OutputDataConfig": {
      "s3Uri": "s3://your-bucket-name"
    }
  }
}

Text-to-VideoAvanzato con opzioni

{
  "modelId": "luma.ray-v2:0",
  "modelInput": {
    "prompt": "an old lady laughing underwater, wearing a scuba diving suit",
    "aspect_ratio": "16:9",
    "loop": true,
    "duration": "5s",
    "resolution": "720p"
  },
  "outputDataConfig": {
    "s3OutputDataConfig": {
      "s3Uri": "s3://your-bucket-name"
    }
  }
}

Text-to-VideoEsempio aggiuntivo

Esempio con parametri di risoluzione e durata.

{
  "modelId": "luma.ray-v2:0",
  "modelInput": {
    "prompt": "a car",
    "resolution": "720p",
    "duration": "5s"
  },
  "outputDataConfig": {
    "s3OutputDataConfig": {
      "s3Uri": "s3://your-bucket-name"
    }
  }
}

Image-to-Video Generazione

Trasforma immagini statiche in video dinamici fornendo fotogrammi chiave. È possibile specificare fotogrammi iniziali, fotogrammi finali o entrambi per controllare il processo di generazione del video.

Basic Image-to-Video con Start Frame

{
  "modelId": "luma.ray-v2:0",
  "modelInput": {
    "prompt": "A tiger walking in snow",
    "keyframes": {
      "frame0": {
        "type": "image",
        "source": {
          "type": "base64",
          "media_type": "image/jpeg",
          "data": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3"
        }
      }
    }
  },
  "outputDataConfig": {
    "s3OutputDataConfig": {
      "s3Uri": "s3://your-bucket-name"
    }
  }
}

Image-to-Video con frame iniziale e finale

{
  "modelId": "luma.ray-v2:0",
  "modelInput": {
    "prompt": "A tiger walking in snow",
    "keyframes": {
      "frame0": {
        "type": "image",
        "source": {
          "type": "base64",
          "media_type": "image/jpeg",
          "data": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3"
        }
      },
      "frame1": {
        "type": "image",
        "source": {
          "type": "base64",
          "media_type": "image/jpeg",
          "data": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3"
        }
      }
    },
    "loop": false,
    "aspect_ratio": "16:9"
  },
  "outputDataConfig": {
    "s3OutputDataConfig": {
      "s3Uri": "s3://your-bucket-name"
    }
  }
}

Parametri aggiuntivi per Image-to-Video

  • fotogrammi chiave — (oggetto) Definisce i fotogrammi chiave di inizio (frame0) e and/or fine (frame1)

    • frame0 — Immagine del fotogramma chiave iniziale

    • frame1 — Immagine del fotogramma chiave finale

    • type — Deve essere «immagine»

    • fonte: fonte dell'immagine

Risoluzione dei problemi

Problemi e soluzioni comuni quando si lavora con i modelli Luma AI:

  • Job Status «Failed»: verifica che il bucket S3 disponga delle autorizzazioni di scrittura corrette e che il bucket esista nella stessa regione del servizio Bedrock.

  • Errori di accesso all'URL dell'immagine: assicurati che le immagini URLs siano accessibili pubblicamente e utilizza HTTPS. Le immagini devono essere nei formati supportati (JPEG, PNG).

  • Errori dei parametri non validi: verifica che i valori delle proporzioni corrispondano alle opzioni supportate (» 1:1 «," 16:9 «," 9:16 «," 4:3 «," 3:4 «," 21:9 «," 9:21 «) e la durata sia «5s» o «9s».

  • Problemi di timeout: da utilizzare per controllare lo stato del lavoro anziché attendere in modo sincrono. GetAsyncInvoke La generazione di video può richiedere diversi minuti.

  • Errori di lunghezza dei prompt: mantieni i prompt compresi tra 1 e 5000 caratteri. Le richieste più lunghe verranno rifiutate.

Note sulle prestazioni

Considerazioni importanti relative alle prestazioni e ai limiti del modello Luma AI:

  • Tempo di elaborazione: la generazione di video richiede in genere 2-5 minuti per video di 5 secondi e 4-8 minuti per video di 9 secondi, a seconda della complessità.

  • Requisiti relativi alle immagini: le immagini di input devono essere di alta qualità con una risoluzione minima di 512x512 pixel. La dimensione massima supportata dell'immagine è 4096x4096 pixel.

  • Dimensioni video di output: i video generati variano da 5 a 50 MB a seconda della durata, della risoluzione e della complessità del contenuto.

  • Limiti di velocità: le chiamate API asincrone sono soggette a quote di servizio. Monitora l'utilizzo e richiedi aumenti delle quote, se necessario.

  • Storage S3: garantisci una capacità di archiviazione S3 sufficiente per i video in uscita e prendi in considerazione le politiche del ciclo di vita per l'ottimizzazione dei costi.

Documentazione correlata

Per ulteriori informazioni e servizi correlati: