Skip to main content
POST
O Playground da documentação não suporta upload de arquivos: Use os exemplos de código em cURL, Python ou JavaScript abaixo para testar.
Armazenamento temporário: As imagens enviadas são armazenadas por apenas 72 horas. Após esse período, a URL da imagem deixará de ser válida. Use a imagem dentro desse prazo ou salve-a a tempo em seu próprio serviço de armazenamento.
Mudança importante: Para melhor desempenho e controle de custos, não suportamos mais a passagem direta de dados de imagem em base64 nas APIs de geração. Use esta API para fazer o upload das imagens, obter a URL e, em seguida, chamar a API de geração.

Por que fazer upload das imagens primeiro?

  1. Otimização de desempenho - a codificação base64 aumenta os dados em 33%; fazer o upload primeiro reduz significativamente o tamanho do corpo da requisição
  2. Reutilização de imagens - faça o upload uma vez e reutilize a URL várias vezes sem transferências redundantes

Fluxo de trabalho

Autorizações

string
obrigatório
Todas as APIs exigem autenticação por Bearer TokenObtenha sua chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave de APIAdicione-a aos cabeçalhos da requisição:

Body

file
obrigatório
Arquivo de imagemFormatos suportados: JPEG (.jpg, .jpeg), PNG (.png), WebP (.webp), GIF (.gif)Tamanho máximo do arquivo: 20 MB

Resposta

string
URL pública de acesso à imagem, podendo ser usada diretamente nas APIs de geração (válida por 72 horas)
string
Nome original do arquivo
string
Tipo MIME detectado, por exemplo image/jpeg
integer
Tamanho do arquivo em bytes
integer
Horário do upload como timestamp Unix (segundos)

Exemplo completo: fluxo de imagem para imagem

Python