Visão geral

Changelog

Mudanças relevantes na API e na plataforma da Stac.

Mudanças aditivas saem sem troca de versão. Qualquer mudança incompatível ganha um novo prefixo /v e uma janela de migração anunciada aqui antes.

2026-09-14

Uso de tokens nas rotas de imagem. /v1/images/generations e /v1/images/edits agora devolvem um bloco usage no mesmo formato das rotas de chat: um token por bloco de 16×16 px da imagem gerada (completion_tokens) e de cada imagem de referência (prompt_tokens), mais os tokens de texto do prompt. O uso de imagem aparece em tokens na página de Uso e no dashboard, e entra na cota diária de tokens do plano (hoje sem teto). Aditiva — fora isso, a resposta não mudou.

2026-09-09

Geração e edição de imagens. Dois novos endpoints, /v1/images/generations e /v1/images/edits, disponíveis para stacks da categoria image. Entra um prompt e sai um PNG, ou até quatro imagens de referência editadas por instrução.

Estas rotas devolvem um segundo formato de erro, além do { "detail": "..." } usado em toda a API — o da OpenAI, { "error": { "code": ... } }, com um code estável em que você pode ramificar. Os endpoints existentes não mudaram.