API développeurs

Envoyez une image, récupérez un verdict explicable : verdict, indice de risque, score IA, répartition par générateur et signaux. Une requête, une décision. Chaque analyse consomme 1 crédit du compte propriétaire de la clé.

Générer ma clé API Voir les crédits

Ce que vous pouvez construire

Réclamations e-commerce

Vérifiez automatiquement chaque photo de réclamation avant de traiter un remboursement.

Assurance & sinistres

Ajoutez un score de confiance aux photos jointes à une déclaration de sinistre.

Marketplaces & annonces

Filtrez les visuels générés en masse à grande échelle, avec traçabilité par empreinte.

Médias & modération

Vérifiez la provenance d'une image avant publication ou mise en ligne.

Authentification

Créez une clé dans votre compte (onglet API), puis envoyez-la dans l'en-tête Authorization.

Authorization: Bearer VOTRE_CLE

Analyser une image

POST /v1/check en multipart, champ image, ou en JSON avec image_url. La réponse contient verdict, ai_score, risk_score, duplicate, signals, generators.
Le même contrat est aussi disponible sur POST /v1/assess.

curl https://api.maripix.com/v1/check \
  -F "image=@photo.jpg" \
  -H "Authorization: Bearer VOTRE_CLE"

# Variante JSON avec une URL d'image :
curl https://api.maripix.com/v1/check \
  -H "Authorization: Bearer VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{ "image_url": "https://exemple.com/photo.jpg" }'

Lire le verdict

verdict vaut authentic, review ou suspect. l'indice de risque risk_score et le score IA vont de 0 à 1.

{
  "id": "job_9f2c…",
  "verdict": "suspect",
  "ai_score": 0.98,
  "risk_score": 0.72,
  "duplicate": false,
  "signals": ["indecis"],
  "generators": [
    { "name": "flux", "score": 0.88 },
    { "name": "sdxl", "score": 0.06 }
  ]
}

Solde de crédits

GET /v1/me renvoie l'email, les crédits restants et la formule.

curl https://api.maripix.com/v1/me \
  -H "Authorization: Bearer VOTRE_CLE"

# -> { "email": "...", "credits": 1900, "plan": "pro" }

Relire une analyse

GET /v1/jobs/{id} renvoie une analyse déjà effectuée par son identifiant.

curl https://api.maripix.com/v1/jobs/job_9f2c… \
  -H "Authorization: Bearer VOTRE_CLE"

Humain dans la boucle

Maripix éclaire la décision mais ne la remplace pas. Conformément à l'AI Act, un verdict review invite à un contrôle humain, et la décision finale reste toujours de votre ressort.