API do Social Studio | Documentação do Desenvolvedor Fit It On

Aplique efeitos criativos e modelos altamente estilizados a imagens de moda para mídias sociais.

O endpoint Social Studio aplica modelos estéticos criativos e altamente estilizados às suas imagens de moda, transformando-as em conteúdo atraente perfeitamente adequado para marketing em mídias sociais.

Nome do Modelo: social-studio

Ciclo de Vida: estável

Tempo de Processamento: ~15s–30s

Formato de Saída: Automático (JPEG ou PNG)

Métodos de Entrega: URL

Créditos: 2 a 5 por geração (depende da qualidade)

Requisição

Envie sua imagem e o ID de estilo selecionado para o endpoint universal /v1/run:

POSThttps://fititon.app/api/v1/run

Exemplos de Requisição

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "social-studio",
           "inputs": {
             "personImage": "https://example.com/model-shot.jpg",
             "styleId": "action-figure",
             "quality": "2k",
             "sampleCount": 1
           }
         }'

Resposta

Como a geração de imagens pode levar até 30 segundos, o endpoint /v1/run retorna um status 201 Created imediatamente com um id de job assíncrono. Você deve consultar a API de Status usando este id para recuperar a imagem final. Alternativamente, você pode configurar webhooks para receber notificações automaticamente. Observe que nosso despachante de webhook impõe um tempo limite estrito de 15 segundos. Seu servidor deve reconhecer o webhook com um código de status 2xx dentro de 15 segundos, ou o consideraremos falho e o tentaremos novamente mais tarde.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2024-03-10T12:00:00Z",
  "model_name": "social-studio"
}

Quando o job é concluído (status: "success"), o campo output conterá um array das URLs resultantes:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://cdn.fititon.app/users/123/results/social-studio-123-0.png"
  ],
  "error": null,
  "created_at": "2024-03-10T12:00:00Z",
  "updated_at": "2024-03-10T12:00:20Z"
}

Parâmetros da Requisição

Parâmetros Obrigatórios

personImageRequiredstring

A imagem de origem para estilizar. Pode ser uma URL publicamente acessível ou uma string de imagem codificada em Base64.

Dica Profissional: Fotos de corpo inteiro onde a pessoa está totalmente visível produzem os melhores resultados estilizados. A visibilidade clara do rosto é importante — a IA usa características faciais para criar sua versão estilizada. Evite fotos de grupo ou imagens onde você está parcialmente escondido atrás de objetos.

Requisito de Formatação Ao enviar uma string Base64, ela deve incluir o prefixo URI de dados padrão (por exemplo, data:image/jpeg;base64,...). Embora personImage aceite strings Base64, recomendamos fortemente o uso de URLs HTTP padrão para imagens maiores que 3MB para evitar atingir os limites globais de tamanho de payload JSON (HTTP 413) em sua requisição.

styleIdRequiredstring

O ID do estilo fotográfico a ser aplicado à imagem gerada. Isso determina a iluminação, estética e humor.

Estilos Disponíveis:

Style Name	Style ID (`styleId`)

Parâmetros Opcionais

quality'1k' | '2k' | '4k'

Nível de resolução de saída. Padrão: 1k

sampleCountinteger

Número de variações de imagem a serem geradas por requisição. Deve estar entre 1 e 4. Padrão: 1

ratiostring

Sobrescrita da proporção da imagem. Se vazio, o sistema assume 1:1 (ideal para feeds do Instagram/redes sociais).

Valores suportados: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

Erros de Tempo de Execução

Os erros de tempo de execução para este recurso usam o conjunto compartilhado documentado em Tratamento de Erros. Se ocorrer um erro durante o processamento, o status será atualizado para "error" e o campo error conterá o motivo específico da falha.

Custo de Crédito

Para requisições da API de Desenvolvedor, o custo depende do nível de quality de saída escolhido multiplicado pelo sampleCount.

Fórmula: Custo = CréditosQualidade × sampleCount

Nível de Qualidade	Créditos por Imagem
1k (Padrão)	2
2k	3
4k	5