Referência · Autenticação
Autenticação da Photta API uma chave, um cabeçalho
Em uma frase
Envie sua chave como `Authorization: Bearer photta_live_xxx` em todas as chamadas à Photta API. As chaves são criadas no dashboard, não possuem escopo por endpoint e compartilham um único saldo de credits.
- Autenticação: Chave Bearer
- Limites: 600 requisições/min
- Processamento: assíncrono, polling
Todos os números nesta página vêm de a documentação da API da Photta · verificado
O que a API espera
Visão geral da autenticação
- Header
- Authorization: Bearer photta_live_xxx
- Prefixo da chave
- photta_live_
- URL base
- https://api.photta.app/api/v1
- Onde as chaves são criadas
- https://ai.photta.app
- Escopo
- Uma chave acessa todos os endpoints e um único saldo de credits
Valide uma chave em uma única chamada
O endpoint de conta é gratuito, sendo a forma segura de confirmar se uma chave funciona.
curl https://api.photta.app/api/v1/account \
-H "Authorization: Bearer $PHOTTA_API_KEY"const res = await fetch("https://api.photta.app/api/v1/account", {
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.photta.app/api/v1/account",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]Gerenciando chaves
Rotacione ao menor sinal de suspeita
A documentação é explícita: rotacione uma chave imediatamente se suspeitar de comprometimento. Gere a chave substituta primeiro, faça o deploy e só então revogue a antiga.
Mantenha no servidor
Uma chave exposta no navegador fica acessível a qualquer pessoa que abrir a página. Chame a API a partir do seu backend e repasse os resultados para o cliente.
401 refere-se à chave, não à requisição
Uma chave ausente, inválida ou expirada retorna `authentication_error`. Verifique o cabeçalho em busca de erros de digitação e espaços em branco extras antes de investigar qualquer outro ponto.
Um único saldo para todas as chaves
As chaves não têm escopo por recurso. Várias chaves para múltiplos ambientes consomem o mesmo saldo de credits, retornado por GET `/api/v1/account`.
Perguntas sobre autenticação
Como autentico uma requisição?
Envie a chave no cabeçalho Authorization como um bearer token em todas as chamadas. Não há etapa separada de login ou troca de token.
Onde crio uma chave?
No seu dashboard da Photta. O mesmo local emite substituições, que é para onde a documentação direciona você após um 401.
Posso chamar a API a partir do navegador?
Não com a sua chave. Qualquer item enviado a um navegador pode ser lido pelos visitantes, portanto coloque a chamada atrás do seu próprio servidor e encaminhe o resultado.
E se uma chave vazar?
Faça a rotação imediatamente — gere uma nova chave, faça o deploy dela e, em seguida, delete a antiga. Credits já consumidos não podem ser recuperados, então faça a rotação primeiro e investigue depois.
Endpoints e referências
Recursos
API de try-on virtual para roupas
API REST que veste roupas em manequins de IA. Assíncrona, geração em 1.5–4 minutos, 5 credits em 2K, 6 em 4K. Exemplos em cURL, Node.js e Python.
LerRecursos
API de try-on de joias para colares, anéis, pulseiras e brincos
Insira colares, anéis, pulseiras e brincos em modelos de IA via REST. 5 credits em 2K, manequins em close-up integrados, renderização sensível a reflexos direto da documentação da Photta.
LerRecursos
API de manequim invisível para fotos de produtos em manequim invisível
Endpoint de IA para manequim invisível. Remova o manequim de uma foto de roupa e preserve os detalhes internos. 3D ou flat-lay, processamento em lote, 4 credits em 2K.
LerReferência
Primeira imagem no Photta em menos de cinco minutos.
Cadastre-se, gere uma chave de API, execute sua primeira chamada cURL, faça polling até a conclusão, persista o resultado. Cinco etapas, documentadas de ponta a ponta.
LerReferência
Preços da API Photta
Quanto custa em credits cada endpoint da Photta API em 2K e 4K, como funcionam as cobranças e reembolsos, e quais endpoints são gratuitos. Sem preço monetário por imagem.
LerReferência
Rate limits da API Photta
O rate limit da API Photta, sua janela, o header Retry-After, o intervalo de polling e os limites de simultaneidade por plano, tudo extraído da documentação da API.
LerReferência
Erros da Photta API
A lista completa de tipos de erro da Photta API com seus status codes, o formato do corpo de erro e quais falhas valem a pena tentar novamente.
LerReferência
Endpoints de recursos da API Photta
Liste manequins, poses, fundos, calçados e etiquetas de marca, envie os seus próprios e consulte o saldo de credits. As consultas por trás de cada geração.
Ler
Todos os números nesta página vêm de a documentação da API da Photta · verificado
Experimente a API em cinco minutos
Gere uma chave de API do Photta, cole o snippet de cURL acima e você terá sua primeira imagem com modelo antes que o café termine de passar.
- Chave Bearer
- 600 requisições/min
- assíncrono, polling