Credencial no cofre
Token pedido na hora pelo fluxo servidor a servidor, renovado antes de vencer, nunca colado em arquivo nem gravado em registro.
Entrega: obter_token.sh e regra de guarda do segredoOcto para a Photoshop API na nuvem
Oitocentas fotos recortadas sem abrir o Photoshop. Quem libera o catálogo é você.
A Photoshop API, parte do Firefly Services, executa recorte de fundo, máscaras, ações gravadas e composições em servidores da Adobe, chamada por HTTP. O Octo escreve o controlador que envia o lote sem estourar o limite da sua organização, mantém o segredo no cofre e confere cada imagem devolvida pelo conteúdo. O contrato, os direitos sobre a foto e a aprovação ficam com pessoas.
Fim de vida da v131/07/2026a v2 muda rotas, campos e domínio
Limite flexível de POST300/mingeral, por organização; no recorte de fundo, cerca de 40/min, segundo as notas técnicas
Arquivo na v2até 5 GBcontra 2 GB na v1
Fontes12listadas no fim da página
01
O que o Octo faz com a Photoshop API.
Seis entregas possíveis, tiradas do levantamento. Nenhuma guarda segredo fora do cofre, todas conferem a imagem devolvida, e todas vão para revisão de quem responde pelo catálogo.
URLs pré-assinadas curtas
A foto vai do seu balde para a API e volta para o balde. As URLs valem minutos e não entram em anexo nem em registro compartilhado.
Entrega: gerar_urls_assinadas.py com teto de validadeLote com controle de taxa
Teto por minuto abaixo do limite da organização, espera crescente na consulta de situação e respeito ao retry-after.
Recorte ou máscara
Recorte pronto para o que vai direto ao catálogo; máscara em tons de cinza para o que o retocador ainda ajusta no Photoshop de mesa.
Entrega: fila com o modo de cada fotoAção do estúdio na nuvem
A ação gravada pelo retocador vira passos legíveis, revisados quanto a camada e tamanho fixo, e roda na rota de ações para o lote todo.
Entrega: executar_acao.json revisadoConferência pelo conteúdo
Assinatura do arquivo, dimensões, canal alfa no recorte, saída vazia, job que falhou e imagem que não voltou.
Entrega: conferencia.csv e manifesto com sha256
02
Oito braços, um lote conferido.
O mesmo ciclo do Octo, aplicado à API na nuvem. Cada braço tem um papel estreito; quem assina o contrato, autoriza o uso da foto e libera o catálogo são pessoas.
-
Descoberta
Levanta o uso real
Que operações saem à mão, em que volume por mês, e se há rotina antiga ainda chamando a v1.
-
Dados
Escreve fila e registro
Fila de imagens, registro de jobs e padrão de nome em arquivos versionados.
-
Segurança
Cuida do segredo e da foto
Segredo no cofre, URL pré-assinada curta, registro sem token, foto com pessoa sinalizada (LGPD).
-
Arquitetura
Escolhe o caminho
API na nuvem, script no Photoshop de mesa ou ferramenta livre, pelo volume e pela restrição de dados.
-
Desenvolvimento
Escreve controlador e conferência
Teto de taxa, espera crescente, repetição só onde cabe e a fonte de cada regra anotada.
-
Revisão
Confere pela imagem
Alfa, dimensões, saída vazia, falta e sobra. "Deu 200" não é conferência.
-
Publicação
Move só o que passou
Do prefixo de saída para o de catálogo, com aprovação de uma pessoa.
-
Documentação
Registra o que vale no seu ambiente
Versão da API, domínio em uso, limites, quem aprovou cada lote e o uso do mês.
O Octo não cria conta na Adobe, não guarda segredo fora do seu cofre e não move imagem para o catálogo sem aprovação.
03
Cada tarefa, a sua rota.
O critério que o Octo usa para escolher, com o limite documentado de cada caminho.
| Tarefa | Caminho | Observação |
|---|---|---|
| Testar a credencial | Rota /v2 com o token (a hello é da v1) | Antes de qualquer lote |
| Recortar o fundo de uma pasta | /v2/remove-background, modo cutout | Uma imagem por chamada |
| Máscara para retoque fino | Mesma rota, modo mask | Retocador ajusta no Photoshop de mesa |
| Aplicar uma ação gravada | /v2/execute-actions | Revisar passos e testar em amostra |
| Ajuste automático de tom | /v2/edit | Operações combinadas numa chamada |
| Modelo de peça com produto e preço | /v2/create-composite | Fontes do servidor ou do Adobe Fonts |
| Inventário de um acervo de PSD | /v2/generate-manifest | Sem abrir o Photoshop |
| Acompanhar o lote | /v2/status/{jobId} | Espera crescente; o GET também conta |
04
Da chamada solta ao lote medido.
Três degraus. Cada um só faz sentido depois que o anterior mostrou resultado na sua equipe.
Proposta, não promessa
Inventário e migração
O Octo levanta as rotinas que já chamam a API, aponta o que ainda está na v1 e o segredo fora do cofre.
- Rotas v1 mapeadas para v2
- Domínio como configuração
- Segredo no cofre
Lote com conferência
Recorte e ação em lote, com teto de taxa, registro de jobs e conferência pelo conteúdo.
- Folga para outras equipes
- Pendência, não repetição infinita
- Amostra aprovada por pessoa
Uso medido
Uso por operação, reprocessos e picos, para a conversa de contrato com números.
- Uso do mês por operação
- Taxa de reprocesso
- Pico contra o limite
05
Confirmado em fonte.
Cada ponto abaixo tem fonte publicada pelo fabricante, pelo projeto ou pelo órgão responsável. As fontes estão na seção seguinte.
4
pontos com fonte publicada, cada um com a referência indicada ao lado.
- ConfirmadoAcesso exige contrato empresarial
- Contrato ativo com Firefly Services e projeto no Developer Console com credencial servidor a servidor; token de 24 horas.Fonte: developer.adobe.com, Photoshop API, Getting started
- Confirmadov1 encerrada em 31/07/2026
- A v2 junta rotas em
execute-actions,create-compositeeedit, trocatypepormediaTypeehrefpordestination.Fonte: developer.adobe.com, v2 GA e guia de migração - ConfirmadoLimite por organização
- Geral: flexível de 300 POST por minuto e 300 GET a cada 3 s. Remoção de fundo: 2 POST a cada 3 s (cerca de 40 por minuto). Mascaramento: 60 por minuto e 9000 por dia. 429 com
retry-after; só uma imagem de entrada por chamada.Fonte: developer.adobe.com, Technical Usage Notes - ConfirmadoEstados do job
not_started,running,succeededefailed; o controlador espera até um dos dois terminais.Fonte: developer.adobe.com, Status Migration
06
O que o Octo faz e o que fica com vocês.
O Octo prepara tudo, mas não assina. O documento que vale continua com quem responde por ele.
O Octo prepara
Levanta, calcula, organiza e gera os documentos: arquivos tratados, provas, relatórios e planilhas.
Entrega: material pronto para conferirA sua equipe confere
O cliente ou o diretor de arte confere o que o Octo entregou antes de aprovar. Se algo não fecha, volta para o Octo com a correção.
Etapa: conferência por quem aprovaQuem aprova
O Octo não aprova a arte. Numa arte não há assinatura legal: a aprovação da arte e da prova fica com o cliente ou o diretor de arte.
Aprovação: cliente ou diretor de arte
07
Fontes.
Documentação da Photoshop API e do Firefly Services em developer.adobe.com, consultada em 31/10/2026.
- Photoshop API, visão geralv2 GA, recursos, 5 GB
- Getting startedLicença, token, cabeçalhos
- Photoshop API v2 GAFim de vida da v1
- Remove background (v2)Modos, parâmetros, jobId
- ActionJSONCorpo de ações
- Migração v1 para v2Tabela de rotas
- Migração de açõesActionJSON em options.actions
- Migração da situaçãoEstados do job
- Melhorias da v2Armazenamento, ações publicadas
- Technical Usage NotesLimites por serviço, retry-after, fontes
- Firefly Services, guiasAPIs do pacote
- Firefly API, limitesSó da Firefly API
Sua Photoshop API, com limite respeitado e imagem conferida.
O diagnóstico começa pelo inventário das rotinas que já chamam a API e por uma amostra conferida. Você recebe o que ainda está na v1, onde o segredo está, o uso medido e as perguntas que só a sua equipe responde, e decide com isso na mão.