runwayml_text_to_image

Especificações técnicas de runwayml-text-to-image

O que é runwayml-text-to-image?

runwayml-text-to-image é o identificador de plataforma da CometAPI para acessar a geração de imagens a partir de texto com tecnologia da Runway. Com base na documentação oficial da API da Runway e em seus materiais de produto, a capacidade subjacente é projetada para transformar prompts em linguagem natural em imagens geradas, com o lineup atual de modelos da API da Runway incluindo modelos de imagem dedicados, como gen4_image e gen4_image_turbo.

Na prática, essa categoria de modelo é destinada a desenvolvedores e equipes de produto que desejam incorporar criação de imagens de alta qualidade em aplicativos, ferramentas internas, fluxos criativos ou experiências voltadas ao usuário. A Runway posiciona sua API como uma plataforma para desenvolvedores integrarem mídia generativa em aplicativos e produtos, e sua API de imagem oferece suporte tanto à geração baseada em prompt quanto, em alguns casos, a fluxos orientados por referências para saídas mais controladas.

Como a CometAPI usa seu próprio formato normalizado de ID de modelo, você deve continuar usando runwayml-text-to-image ao chamar o modelo pela CometAPI, embora a documentação nativa da Runway faça referência a nomes específicos de modelos upstream, como gen4_image.

Principais recursos de runwayml-text-to-image

• Geração de imagens a partir de texto: Converte prompts em linguagem simples em imagens geradas por IA adequadas a fluxos criativos, visuais e orientados a produto.
• Baseado em modelos de imagem da Runway: A capacidade está alinhada ao stack dedicado de geração de imagens da Runway, especialmente gen4_image, apresentado como o modelo de imagem carro-chefe no catálogo da API da Runway.
• Fluxos de trabalho com referências: A documentação da API de imagem da Runway destaca suporte a padrões de texto mais referência de imagem, permitindo maior controle sobre composição, estilo ou orientação do assunto quando suportado pelo modelo upstream.
• Acesso à API voltado para desenvolvedores: A Runway fornece uma API documentada, guias de configuração e SDKs que visam simplificar a integração em aplicações de produção.
• Múltiplas opções de qualidade/custo: A Runway publica modelos de imagem distintos com diferentes perfis de preço, incluindo gen4_image e gen4_image_turbo, o que sugere flexibilidade entre qualidade de saída e custo de geração.
• Produção criativa: O modelo é bem adequado para ideação, geração de assets, prototipagem visual, exploração de conceitos e assistência de design. Esse enquadramento de caso de uso é inferido com base no posicionamento da Runway em geração de imagens para apps e equipes criativas.

Como acessar e integrar runwayml-text-to-image

Etapa 1: Cadastre-se para obter a chave de API

Cadastre-se na CometAPI e crie uma chave de API no painel. Armazene a chave com segurança em variáveis de ambiente ou em um gerenciador de segredos antes de fazer solicitações de produção.

Etapa 2: Envie solicitações para a API runwayml-text-to-image

Use o formato oficial da API da Runway via CometAPI. O endpoint é POST /runwayml/v1/text_to_image. Inclua o cabeçalho X-Runway-Version.

curl https://api.cometapi.com/runwayml/v1/text_to_image \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -H "X-Runway-Version: 2024-11-06" \
  -d '{
    "model": "gen4_aleph",
    "promptText": "Your prompt here."
  }'

Etapa 3: Recupere e verifique os resultados

A API retorna um objeto de tarefa com um ID de tarefa. Faça polling em GET /runwayml/v1/tasks/{task_id} para verificar o status da geração e, em seguida, recupere a URL de saída da resposta da tarefa concluída.