Uwear Agent Skills
Construisez avec Uwear depuis une seule page lisible par les agents.
Téléchargez UWEAR.md, consultez le manifeste et donnez à votre agent de code les règles de l’API pour les visuels catalogue, les combinaisons de tenues, les rendus d’essayage, les retouches, les upscales et la vidéo.
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 de base
https://api.uwear.ai
Auth
Authorization: Bearer YOUR_API_KEY
Style des champs
snake_case pour les requêtes et les réponses
Créer un job
POST /generation
Index des ressources
Commencez par explorer ceci.
Voici les URL durables qu’un agent doit consulter avant d’appeler l’API ou d’écrire du code d’intégration.
| Ressource | Type | Usage |
|---|---|---|
| Hub des skills d’agent https://uwear.ai/skills | HTML | Point de départ canonique pour les agents et les crawlers. |
| UWEAR.md https://uwear.ai/UWEAR.md | Markdown | Chargez ce fichier comme contexte de tâche avant de construire avec l’API Uwear. |
| Manifeste de skills https://uwear.ai/skills/manifest.json | JSON | Index lisible par machine des ressources d’agent et des règles de l’API Uwear. |
| llms.txt https://uwear.ai/llms.txt | Texte | Résumé large pour les crawlers des produits, de l’API et des références d’agent Uwear. |
| Documentation API https://platform.uwear.ai/api/introduction | Docs | Documentation de l’API destinée aux humains pour les routes de génération Uwear. |
| Guide API pour agents https://uwear.ai/blog/ai-fashion-generation-api-for-agents | Guide | Explication détaillée du workflow de génération prêt pour les agents. |
Contrat de base
Un seul modèle de génération asynchrone.
Les workflows Uwear de génération, de retouche, d’upscale et de vidéo partagent le même modèle mental : créer un job, attendre un état terminal, puis persister les assets générés.
- URL de base
- https://api.uwear.ai
- Auth
- Authorization: Bearer YOUR_API_KEY
- Style des champs
- snake_case pour les requêtes et les réponses
- Créer un job
- POST /generation
- Interroger un job
- GET /generation/{generation_id}
- Résultats par polling
- generation_results
- Résultats par webhook
- data.results
- Durée de vie des assets
- Téléchargez les URL générées sous 4 heures
Workflow de l’agent
Du prompt aux assets de production.
1. Charger le skill
Récupérez UWEAR.md et gardez-le dans le contexte de l’agent avant d’écrire du code ou de planifier un workflow.
2. Choisir le type d’asset
Utilisez les clothing items pour les vêtements, les avatars pour les mannequins réutilisables et les generation results pour les retouches, les upscales ou les suites vidéo.
3. Créer un job par sortie
Appelez POST /generation avec des réglages explicites : model_slug, use_case, camera, aspect_ratio, resolution et num_images.
4. Attendre proprement
Faites du polling pour les scripts, ou utilisez des webhooks signés pour la production et les workflows à l’échelle du catalogue.
5. Persister les résultats
Téléchargez les assets terminés vers votre propre stockage avant l’expiration des URL de livraison temporaires.
Couverture du skill
Ce qu’UWEAR.md apprend à l’agent.
Le fichier markdown est le contrat pratique. Il indique à un agent comment utiliser les routes documentées, gérer les URL temporaires, éviter de divulguer des clés API et structurer un vrai travail de catalogue ou d’essayage.
- Création et réutilisation des clothing items
- Génération asynchrone pour les images, les retouches, les upscales et la vidéo
- Schémas de complétion par polling et par webhook signé
- Récupération des résultats de génération et recherche sémantique
- Avatars sauvegardés pour des mannequins cohérents
- Manifestes de catalogue en masse et traitement tolérant aux reprises
- Architecture backend d’essayage pour une boutique en ligne
- Garde-fous pour les agents : secrets, code client et URL temporaires
Forme minimale de requête
Commencez avec des réglages explicites.
Les agents doivent préférer des champs d’API structurés à des prompts vagues. Le prompt décrit la direction visuelle ; les champs de l’API définissent le workflow.
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
}Point de départ de l’agent : récupérer le skill, puis construire.
En production, gardez la clé API Uwear côté backend, traitez les gros catalogues via une file d’attente et stockez chaque résultat généré avant la fin de la fenêtre de 4 heures des URL.