Modelos da Luma AI - Amazon Bedrock
Text-to-Video GeraçãoImage-to-Video GeraçãoSolução de problemasNotas de desempenhoDocumentação relacionada

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Modelos da Luma AI

Esta seção descreve os parâmetros de solicitação e os campos de resposta dos modelos Luma AI. Use essas informações para fazer chamadas de inferência para modelos de IA do Luma com a StartAsyncInvokeoperação. Esta seção também inclui exemplos de código em Python que mostram como chamar modelos de IA do Luma. Para usar um modelo em uma operação de inferência, o ID do modelo é necessário.

  • ID do modelo: luma.ray-v 2:0

  • Nome do modelo: Luma Ray 2

  • Modelo de texto para vídeo

O Luma AI modela as solicitações do modelo de processo de forma assíncrona usando o Async APIs , incluindo, e. StartAsyncInvokeGetAsyncInvokeListAsyncInvokes

O modelo Luma AI processa solicitações usando as etapas a seguir.

  • O usuário solicita o modelo usando StartAsyncInvoke.

  • Espere até InvokeJob que termine. Você pode usar GetAsyncInvoke ou ListAsyncInvokes para verificar o status de conclusão do trabalho.

  • A saída do modelo será colocada no bucket Amazon S3 de saída especificado

Para obter mais informações sobre como usar os modelos Luma AI com o APIs, consulte Geração de vídeo.

Luma AIchamada de inferência. 

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"
    }
  }
}

Campos

  • prompt — (string) O conteúdo necessário no vídeo de saída (1 <= comprimento <= 5000 caracteres).

  • aspect_ratio — (enum) A proporção do vídeo de saída (” 1:1 “," 16:9 “," 9:16 “," 4:3 “," 3:4 “," 21:9 “," 9:21 “).

  • loop — (boolean) Se o vídeo de saída deve ser repetido.

  • duration — (enum) - A duração do vídeo de saída (“5s”, “9s”).

  • resolução — (enum) A resolução do vídeo de saída (“540p”, “720p”).

O MP4 arquivo será armazenado no bucket do Amazon S3 conforme configurado na resposta.

Text-to-Video Geração

Gere vídeos a partir de instruções de texto usando o modelo Luma Ray 2. O modelo oferece suporte a várias opções de personalização, incluindo proporção, duração, resolução e loop.

Text-to-VideoSolicitação básica

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

Avançado Text-to-Video com opções

{
  "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-VideoExemplo adicional

Exemplo com parâmetros de resolução e duração.

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

Image-to-Video Geração

Transforme imagens estáticas em vídeos dinâmicos fornecendo quadros-chave. Você pode especificar quadros iniciais, quadros finais ou ambos para controlar o processo de geração de vídeo.

Básico Image-to-Video com 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 com quadros inicial e final

{
  "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"
    }
  }
}

Parâmetros adicionais para Image-to-Video

  • quadros-chave — (objeto) Define quadros-chave de início (quadro0) e and/or fim (quadro1)

    • frame0 — Imagem inicial do quadro-chave

    • frame1 — Imagem final do quadro-chave

    • tipo — Deve ser “imagem”

    • fonte — Fonte da imagem

Solução de problemas

Problemas e soluções comuns ao trabalhar com modelos de IA da Luma:

  • Status do trabalho “Falha” - Verifique se seu bucket do S3 tem as permissões de gravação adequadas e se o bucket existe na mesma região do seu serviço Bedrock.

  • Erros de acesso ao URL da imagem - Certifique-se de que a imagem URLs esteja acessível ao público e use HTTPS. As imagens devem estar em formatos compatíveis (JPEG, PNG).

  • Erros de parâmetros inválidos - Verifique se os valores das proporções correspondem às opções suportadas (” 1:1 “," 16:9 “," 9:16 “," 4:3 “," 3:4 “," 21:9 “," 9:21 “) e a duração é “5s” ou “9s”.

  • Problemas de tempo limite - Use GetAsyncInvoke para verificar o status do trabalho em vez de esperar de forma síncrona. A geração de vídeo pode levar vários minutos.

  • Erros de tamanho do prompt - Mantenha os prompts entre 1 e 5000 caracteres. Solicitações mais longas serão rejeitadas.

Notas de desempenho

Considerações importantes sobre o desempenho e as limitações do modelo Luma AI:

  • Tempo de processamento - a geração de vídeo normalmente leva de 2 a 5 minutos para vídeos de 5 segundos e de 4 a 8 minutos para vídeos de 9 segundos, dependendo da complexidade.

  • Requisitos de imagem - As imagens de entrada devem ser de alta qualidade com resolução mínima de 512x512 pixels. O tamanho máximo de imagem suportado é 4096x4096 pixels.

  • Tamanho do vídeo de saída - Os vídeos gerados variam de 5 a 50 MB, dependendo da duração, resolução e complexidade do conteúdo.

  • Limites de taxa - as chamadas de API assíncronas estão sujeitas às cotas de serviço. Monitore seu uso e solicite aumentos de cota, se necessário.

  • Armazenamento S3 - Garanta capacidade de armazenamento S3 suficiente para a saída de vídeos e considere as políticas de ciclo de vida para otimização de custos.

Documentação relacionada

Para obter informações adicionais e serviços relacionados: