Documents pour développeurs

API neofashion.ai

Générez des photographies de produits, des vidéos et des images de campagne par programmation. La même API utilisée par la plateforme, disponible pour votre intégration dès le premier jour.

URL de base

Tous les endpoints sont versionnés sous /api/v1 et servis via HTTPS. L’application web utilise les mêmes endpoints — il n’existe aucune route privée réservée à l’UI.

Base URL

https://app.neofashion.ai/api/v1

Authentification

Chaque requête est authentifiée avec un bearer token. Deux types de tokens sont pris en charge, et tous deux renvoient au même contexte d’espace de travail.

Clé API

Pour les intégrations de serveur à serveur. Créez des clés dans les paramètres de l’espace de travail ; chaque clé est limitée à votre espace de travail. Disponible avec les offres Enterprise.

Authorization: Bearer ne_live_xxxxxxxxxxxx

JWT de session

Émis par l’application web à la connexion. Utilisé par l’interface de la plateforme et adapté aux appels courts, associés à un utilisateur.

Authorization: Bearer eyJhbGci...

Toutes les requêtes incluent un champ source (ui ou api) ainsi qu’un api_key_id facultatif à des fins d’audit et de facturation.

Endpoints

Les endpoints essentiels de génération et de lecture. Les travaux longs, comme la génération vidéo et en masse, s’exécutent de façon asynchrone — interrogez la génération ou suivez les mises à jour de statut dans l’application.

Méthode	Endpoint	Description
POST	`/api/v1/generate/image`	Générer une seule photo de produit
POST	`/api/v1/generate/video`	Générer une courte vidéo de mode
POST	`/api/v1/generate/bulk`	Travail de génération par lots asynchrone
POST	`/api/v1/sketch-to-photo`	Sketch → photo de qualité campagne
GET	`/api/v1/generations`	Générations de liste (paginées)
GET	`/api/v1/generations/:id`	Détail de la génération + statut
GET	`/api/v1/credits/balance`	Solde créditeur actuel
GET	`/api/v1/personas`	Personnages de l'espace de travail
GET	`/api/v1/models`	API d'ADN de Marque / Personas

Format de réponse

Chaque endpoint renvoie la même enveloppe : data, meta (crédits utilisés, crédits restants, identifiant de requête) et error. Un seul de data ou error est défini.

Succès

{
  "data": {
    "id": "gen_01hwz...",
    "status": "completed",
    "output_url": "https://...",
    "credits_used": 50
  },
  "meta": {
    "credits_used": 50,
    "credits_remaining": 7950,
    "request_id": "req_01hwz..."
  },
  "error": null
}

Erreur

{
  "data": null,
  "meta": { "request_id": "req_01hwz..." },
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Credit balance too low for this operation.",
    "details": { "required": 50, "available": 20 }
  }
}

Limites de débit

Les limites s’appliquent par espace de travail. Lorsqu’une limite est dépassée, l’API renvoie 429 RATE_LIMITED avec un header retry-after.

Offre	Limite de débit
Enterprise	`Personnalisé – convenu par contrat, avec SLA`

Codes d’erreur

Les erreurs sont renvoyées dans le champ error avec un code stable, un message lisible et des détails structurés.

Code	HTTP	Signification
`INSUFFICIENT_CREDITS`	402	Le solde de l’espace de travail est insuffisant pour l’opération demandée. Rechargez vos crédits ou passez à une offre supérieure pour continuer.
`UNAUTHORIZED`	401	Le token est absent, expiré ou invalide.
`FORBIDDEN`	403	Le token est valide, mais l’offre ou le rôle n’autorise pas cette opération.
`NOT_FOUND`	404	La ressource n’existe pas ou appartient à un autre espace de travail.
`RATE_LIMITED`	429	Trop de requêtes — réessayez après l’intervalle indiqué.
`PROVIDER_ERROR`	502	Un fournisseur d’IA en amont a échoué. Les crédits sont remboursés et la requête peut être réessayée.

Accès API

Prêt à intégrer ?

L’accès API est disponible avec les offres Enterprise, avec onboarding accompagné et SLA. Réservez une démo et nous étudierons votre intégration ensemble.

Réserver une démo Voir les tarifs