Image API Workbench

O que Image API Workbench faz?

Propósito

Execute geração ou edição reproduzível de imagens via API OpenAI ou um gateway compatível revisado. A CLI valida requisições, cataloga streaming parcial, saídas e evidências. Padrão gpt-image-2; os catálogos são evidências de rota, não prova de endpoint.

Fluxo de Trabalho

1. Leia suporte a modelos antes de alterar modelos ou parâmetros avançados.
2. Use scripts/image_api_workbench.py --dry-run para cada nova combinação de parâmetros.
3. Use --list-remote-models para inspecionar o gateway configurado sem gastar créditos de imagem.
4. Gere com /v1/images/generations; adicione --input-image para alternar para /v1/images/edits.
5. Use --background transparent --output-format png ou webp para canal alfa.
6. Use --stream --partial-images 1..3 apenas quando o gateway retransmitir SSE de imagem.
7. Salve os ativos fora desta habilidade e inspecione a imagem mais o arquivo de metadados.

Padrões de Segurança

• gpt-image-1.5, gpt-image-1-mini e chatgpt-image-latest exigem --allow-deprecated-model; todos estão programados para desligamento em 2026-12-01.
• Modelos DALL-E aposentados são bloqueados a menos que --allow-retired-model seja explícito.
• Parâmetros conhecidos de GPT Image são validados por modelo. Extensões de provedor exigem --allow-provider-extensions.
• Credenciais vêm de variáveis de ambiente ou arquivos de token. Nunca persista chaves em prompts, metadados, arquivos de habilidade, relatórios ou logs.
• Metadados armazenam um hash do prompt por padrão. A pré-visualização do prompt é opcional.

Edição e Localização

Para visuais bilíngues combinados, crie um mestre aprovado e edite exatamente essa imagem para cada idioma. Preserve a composição e detalhes não textuais; substitua apenas o texto visível. Construa uma revisão lado a lado com scripts/bilingual_contact_sheet.py.

Veja o guia operacional para comandos, classificação de erros, comportamento de streaming e verificação. Os limites de roteamento são cobertos por evals/trigger_cases.json.

Contrato de Saída

Uma chamada paga bem-sucedida exige:

• stdout JSON com ok: true;
• imagem final existe e não está vazia;
• arquivo de metadados existe, a menos que explicitamente desabilitado;
• formato e dimensões detectados são plausíveis;
• actual_size_matches_request é verificado, não inferido;
• metadados de edição identificam cada entrada por caminho, bytes, SHA-256 e dimensões.

Catálogos e execuções secas não provam suporte de endpoint. Sondas pagas exigem aprovação do usuário.