Pular para o conteúdo
Alfa
  • Modelos
  • Classificações
  • Ori
Falar com vendas

Rodapé

OpenRouterOpenRouter
© 2026 OpenRouter, Inc

Produto

  • Chat
  • Classificações
  • Avaliações de desempenho
  • Aplicativos
  • Descobrir
  • Modelos
  • Ori
  • Coleções
  • Provedores
  • Ferramentas
  • Preços
  • Business
  • Enterprise
  • Laboratório

Empresa

  • Sobre
  • Blog
  • Clientes
  • Carreiras
    Vagas
  • Privacidade
  • Termos de serviço
  • Central de confiança
  • Suporte
  • Funciona com OR
  • Dados
  • Marca

Desenvolvedor

  • Documentação
  • Referência da API
  • Plataforma para desenvolvedores
  • Status
  • Mapa do site para IA

Conectar

  • Discord
  • GitHub
  • LinkedIn
  • X
  • YouTube
Todas as ferramentas do servidor

Image generation

openrouter:image_generation

DocumentaçãoExperimentar esta ferramenta

Permite que qualquer modelo de texto produza imagens. O modelo escreve um prompt de imagem, o OpenRouter gera a imagem com o modelo de imagem configurado (openai/gpt-5-image por padrão), e a imagem é retornada junto com a resposta.

DocumentaçãoExperimentar esta ferramenta
Como funcionaProvedores e preçosUso desta ferramentaPerguntas frequentes

Como funciona

Para adicionar imagens às respostas de qualquer modelo, incluindo modelos somente de texto.

  1. 1

    Seu modelo decide que uma imagem ajudaria e escreve um prompt para ela.

  2. 2

    OpenRouter gera a imagem com o modelo de imagem configurado e retorna a URL.

  3. 3

    Seu modelo inclui a imagem na resposta e pode criar várias.

Provedores e preços

  • Favicon de https://openrouter.ai

    OpenRouter

    Preços de modelos de imagem

    O preço é definido pelo modelo de imagem que a ferramenta chama; qualquer modelo com saída de imagem pode ser selecionado.

Os custos padrão de tokens do modelo se aplicam a todas as solicitações.

Como usar esta ferramenta

O OpenRouter executa a ferramenta durante a solicitação e retorna o resultado ao modelo, portanto não é necessário um ciclo de ferramentas no lado do cliente.

APIs compatíveis: Chat Completions, Responses, and Anthropic Messages.

shell
curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "openai/gpt-5.2",
  "tools": [
    {
      "type": "openrouter:image_generation"
    }
  ],
  "messages": [
    {
      "role": "user",
      "content": "Draw a watercolor painting of a lighthouse at dusk."
    }
  ]
}'

Configuração, parâmetros e exemplos na documentação.

Ler o guia de integração

Perguntas frequentes

Yes. Add the openrouter:image_generation tool to the request’s tools array. The model writes an image prompt when the conversation calls for one, OpenRouter generates the image with an image model, and the image comes back with the response. A model with text-only output, such as openai/gpt-5.2, can answer with images this way.

The tool uses openai/gpt-5-image unless you set parameters.model on the tool entry. Any model with image output on OpenRouter can be selected, so switching image models changes one field and keeps the same API key and request shape. Other parameters such as quality, size and aspect_ratio pass through to that model.

Each image is billed at the selected image model’s price, on top of the token cost of the model that calls the tool. Each image model’s price is on its model page and in the image models collection.

With the Images API (POST /api/v1/images), your code writes the prompt and calls the image model directly. With the tool, the model decides when an image helps, writes the prompt itself and can create several images in one Chat Completions, Responses or Anthropic Messages request.