Documentation de l'API KreatoAI

Bienvenue. Cette documentation vous montre comment connecter KreatoAI à n'importe quel outil ou langage — curl, Node.js, Python, ou une plateforme no-code comme n8n ou Make — pour automatiser votre présence sur les réseaux sociaux, en commençant par les carrousels d'images TikTok.

Ce que fait l'API

La Phase 1 couvre le flux complet du carrousel TikTok en brouillon : vous envoyez vos images (elles sont automatiquement converties au format exigé par TikTok), vous publiez en mode MEDIA_UPLOAD, et le brouillon arrive dans la boîte de réception TikTok du compte connecté — titre et légende déjà pré-remplis. Un humain relit et publie en deux taps depuis l'app. La publication directe (DIRECT_POST) est également disponible.

URL de base

https://api.kreatoai.com

Toutes les routes sont versionnées sous /v1 et répondent en JSON. Les erreurs suivent un format homogène — voir Erreurs.

Démarrage rapide

1. Créez votre clé dans Paramètres → Clés API — voir Clés API. 2. Envoyez une image. 3. Publiez le carrousel. 4. Suivez le statut.

# 1. Ingérer une image (convertie JPEG ≤ 1080px, servie par media.kreatoai.com)
curl https://api.kreatoai.com/v1/media \
  -H "x-api-key: sk-kre-v1-votre_cle" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://exemple.com/image.png"}'

# 2. Publier le carrousel en brouillon
curl https://api.kreatoai.com/v1/publish/tiktok/photo \
  -H "x-api-key: sk-kre-v1-votre_cle" \
  -H "Content-Type: application/json" \
  -d '{
    "imageUrls": ["https://media.kreatoai.com/media-....jpg"],
    "title": "Mon titre",
    "description": "Ma légende #hashtags",
    "postMode": "MEDIA_UPLOAD"
  }'

Besoin d'un exemple sans écrire de code ? Suivez la recette Carrousel TikTok avec n8n — une intégration parmi d'autres.

Feuille de route

L'API est en bêta et s'élargit : publication vidéo TikTok, endpoint multi-plateformes (Facebook, Instagram, LinkedIn), webhooks de statut (fini le polling) et quotas par plan arrivent dans les prochaines versions. Les sections « À venir » de la navigation seront activées au fur et à mesure.