Habilidades do agente Uwear
Crie com Uwear a partir de uma única página legível pelo agente.
Baixe UWEAR.md, visualize o manifesto e forneça ao seu agente de código as regras API para visuais de catálogo, combinações de roupas, renderizações de teste, retoques, upscales e vídeo.
curl -L https://uwear.ai/UWEAR.md -o UWEAR.md
# Load UWEAR.md as context.
# Keep the API key server-side.
export UWEAR_API_KEY="..."
# Core contract
POST https://api.uwear.ai/generation
GET https://api.uwear.ai/generation/{generation_id}URL base
https://api.uwear.ai
Autenticação
Autorização: Portador YOUR_API_KEY
Estilo de campo
Snake_case para solicitações e respostas
Crie um trabalho
POST/geração
Índice de recursos
Comece explorando isso.
Aqui estão os URLs duráveis que um agente deve visitar antes de ligar para API ou escrever código incorporado.
| Recurso | Tipo | Uso |
|---|---|---|
| Central de habilidades do agente https://uwear.ai/skills | HTML | Ponto de partida canônico para agentes e rastreadores. |
| UWEAR.md https://uwear.ai/UWEAR.md | redução | Carregue este arquivo como um contexto de tarefa antes de construir com API Uwear. |
| Manifesto de competências https://uwear.ai/skills/manifest.json | JSON | API Uwear índice legível por máquina de recursos e regras do agente. |
| llms.txt https://uwear.ai/llms.txt | Texto | Resumo amplo para rastreadores de produtos, referências de agentes API e Uwear. |
| Documentação API https://platform.uwear.ai/api/introduction | Documentos | Documentação API voltada para humanos para rotas de construção Uwear. |
| Guia API para agentes https://uwear.ai/blog/ai-fashion-generation-api-for-agents | Guia | Explicação detalhada do fluxo de trabalho de geração pronto para agente. |
Contrato básico
Um único modelo de geração assíncrona.
Os fluxos de trabalho de geração, edição, upscale e vídeo do Uwear compartilham o mesmo modelo mental: criar um trabalho, aguardar um estado terminal e, em seguida, persistir os ativos gerados.
- URL base
- https://api.uwear.ai
- Autenticação
- Autorização: Portador YOUR_API_KEY
- Estilo de campo
- Snake_case para solicitações e respostas
- Crie um trabalho
- POST/geração
- Solicite um emprego
- OBTER /geração/{generation_id}
- Resultados por votação
- generation_results
- Resultados por webhook
- data.results
- Vida útil do ativo
- Baixe URLs gerados em 4 horas
Fluxo de trabalho do agente
Do prompt aos ativos de produção.
1. Carregue a habilidade
Recupere UWEAR.md e mantenha-o no contexto do agente antes de escrever código ou agendar um fluxo de trabalho.
2. Escolha o tipo de ativo
Use itens de vestuário para roupas, avatares para modelos reutilizáveis e geração de resultados para retoques, upscales ou suítes de vídeo.
3. Crie um trabalho por saída
Chame POST/geração com configurações explícitas: model_slug, use_case, camera, aspecto_ratio, resolução e num_images.
4. Espere corretamente
Pesquise scripts ou use webhooks assinado para produção e fluxos de trabalho em todo o catálogo.
5. Persistir resultados
Faça upload dos ativos concluídos para seu próprio armazenamento antes que os URLs de entrega temporária expirem.
Cobertura de habilidades
O que UWEAR.md ensina ao agente.
O arquivo markdown é o contrato prático. Ele informa ao agente como usar rotas documentadas, lidar com URLs temporários, evitar a divulgação de chaves API e estruturar um catálogo real ou trabalho de ajuste.
- Criação e reutilização de peças de vestuário
- Geração assíncrona para imagens, retoques, upscales e vídeos
- Esquemas de conclusão por polling e por webhook assinado
- Recuperando resultados de geração e pesquisa semântica
- Avatares salvos para modelos consistentes
- Manifestos de catálogo em massa e processamento tolerante ao retrabalho
- Arquitetura de back-end experimental para uma loja online
- Proteção do agente: segredos, código do cliente e URLs temporários
Forma mínima de solicitação
Comece com configurações explícitas.
Os agentes devem preferir campos estruturados API a prompts vagos. O prompt descreve a direção visual; Os campos em API definem o fluxo de trabalho.
POST /generation
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"clothing_item_id": 123,
"model_slug": "seedream-4-5",
"use_case": "generate",
"prompt": "professional ecommerce studio photo",
"num_images": 2,
"camera": "full_body_front",
"aspect_ratio": "9:16",
"resolution": "2K",
"enhance_user_prompt": true
}Ponto de partida do agente: colete a habilidade e depois construa.
Na produção, mantenha a chave API Uwear no backend, processe grandes catálogos por meio de uma fila e armazene cada resultado gerado antes do final da janela de URL de 4 horas.