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

# Server tool Image generation

> Permita que um modelo gere uma imagem durante uma solicitação da Responses API com um modelo de imagem configurado.

A ferramenta `orq:image_generation` permite que um modelo de texto crie uma imagem durante uma resposta. A entrada da ferramenta seleciona o modelo de imagem e as opções de renderização. O modelo chamador fornece apenas o prompt da imagem.

Esta ferramenta está disponível apenas em `POST /v3/router/responses`. Chat Completions retorna `400` para uma solicitação que a inclui.

## Início rápido

Os exemplos usam a configuração de cliente da [Visão geral das server tools](/docs/pt-BR/ai-gateway/features/server-tools.md).

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST https://router.toqan.ai/eu/v3/router/responses \
  -H "Authorization: Bearer $TOQAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.4-mini",
    "input": "Create a square product illustration of a green desk lamp.",
    "tools": [
      {
        "type": "orq:image_generation",
        "model": "openai/gpt-image-2",
        "size": "1024x1024",
        "quality": "high"
      }
    ]
  }'
```

```typescript TypeScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
const response = await client.responses.create({
  model: 'openai/gpt-5.4-mini',
  input: 'Create a square product illustration of a green desk lamp.',
  tools: [
    {
      type: 'orq:image_generation',
      model: 'openai/gpt-image-2',
      size: '1024x1024',
      quality: 'high',
    },
  ] as any,
});

console.log(response.output_text);
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
response = client.responses.create(
    model="openai/gpt-5.4-mini",
    input="Create a square product illustration of a green desk lamp.",
    tools=[
        {
            "type": "orq:image_generation",
            "model": "openai/gpt-image-2",
            "size": "1024x1024",
            "quality": "high",
        }
    ],
)

print(response.output_text)
```

A ferramenta retorna `status`, `model` e `image_url` ao modelo chamador. O **Toqan Router** armazena a imagem gerada no armazenamento do workspace quando os uploads estão disponíveis e adiciona `image_path` como referência de armazenamento durável. Nesse caso, `image_url` é um link pré-assinado que expira após 7 dias; portanto, persista `image_path` em vez da URL. Quando o armazenamento não está disponível, `image_url` é uma URL hospedada pelo provedor e `image_path` não está presente.

## Configuração

| Parâmetro | Tipo | Obrigatório | Descrição |
| - | - | - | - |
| `type` | string | Sim | Deve ser `orq:image_generation`. |
| `model` | string | Sim | Modelo de imagem no formato `provider/model`. |
| `size` | string | Não | Dimensões da imagem compatíveis com o modelo selecionado. |
| `quality` | string | Não | Qualidade da imagem compatível com o modelo selecionado. |
| `background` | string | Não | Opção de fundo compatível com o modelo selecionado. |
| `output_format` | string | Não | Formato de saída compatível com o modelo selecionado. |
| `output_compression` | integer | Não | Nível de compressão de 0 a 100, quando compatível. |
| `moderation` | string | Não | Configuração de moderação compatível com o modelo selecionado. |
| `style` | string | Não | Estilo de imagem compatível com o modelo selecionado. |

As opções de renderização dependem do modelo. Valores não compatíveis retornam um erro do provedor de imagens selecionado.

## Custo e uso

A chamada ao modelo de imagem é cobrada pela tarifa padrão do modelo selecionado. Cada chamada da ferramenta aparece em `usage.server_tool_use.image_generation_calls`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.