Projetos e referências

Projetos

GET /projects lista seus projetos. POST /projects cria um projeto com { "name": "Campanha de novembro" }, escopo projects:write e UUID em Idempotency-Key. A resposta contém project.id.

Use GET /projects/{id} para consultar, PATCH /projects/{id} com { "name": "Novo nome" } para renomear e DELETE /projects/{id} para remover. Projetos com pedidos pendentes ou referências em uso são protegidos; 409 pede que você aguarde, não que force a exclusão.

Se não enviar projectId ao gerar, o Infinity Flow usa o projeto padrão da sua conta. Um projeto ou arquivo de outra conta não pode ser usado mesmo que seu ID seja conhecido.

Enviar imagem de referência

A API recebe JSON com projectId, filename e data em base64 puro, sem prefixo data:image/.... O limite é 8 MB de imagem decodificada; o tipo é validado pelo conteúdo do arquivo, não apenas pelo nome.

{
  "projectId": "6aedffb0-cead-4387-9fae-5201fd1679f1",
  "filename": "personagem.png",
  "data": "BASE64_DO_ARQUIVO"
}

Envie para POST /references com references:write e UUID em Idempotency-Key. O retorno contém reference.id; use esse ID em referenceIds de uma geração. Reutilizar a mesma chave com bytes ou metadados diferentes é conflito.

O arquivo é privado. Não há importação automática de URLs arbitrárias. Para arquivos grandes, não coloque todo o conteúdo em um prompt de assistente; prefira enviar pelo seu código e fornecer apenas o ID resultante.

Biblioteca e remoção

GET /references lista até 100 referências da conta; GET /references/{id} retorna metadados de uma referência. DELETE /references/{id} remove uma referência que não está em uso por trabalho pendente.

A biblioteca atual admite até 32 referências salvas e 128 MB totais. Remova imagens não utilizadas antes de enviar novas. O servidor mantém a proteção de referências usadas por pedidos aceitos, mesmo se um projeto for alterado em outra aba.