Server tool Image generation

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.

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

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);

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.

Toqan Router

Visão geral

APIs

MCP Portal

Roteamento

Segurança e privacidade

Recursos dos modelos

Ferramentas de servidor

Cenários comuns

Configuração de provedores

Início rápido

Configuração

Custo e uso

​Início rápido

​Configuração

​Custo e uso

Início rápido

Configuração

Custo e uso