API ImaScreen

Une API REST pour piloter le studio depuis votre code : créer des projets, fabriquer des plans, des voix et des images, récupérer les médias et programmer vos publications. L'API est incluse dans la formule Studio.

Authentification

Créez une clé depuis votre compte. Elle n'est affichée qu'une fois. Envoyez-la sur chaque appel dans l'en-têteAuthorization.

Authorization: Bearer ims_live_xxxxxxxxxxxxxxxx

Les portées disponibles sont projects, generate, export et publish. Les générations consomment les crédits de votre formule, exactement comme dans le studio.

Compte

GET/api/public/v1/me
Formule en cours, crédits restants et portées autorisées par la clé.
```
curl https://imascreen.app/api/public/v1/me \
  -H "Authorization: Bearer ims_live_..."
```

Projets

GET/api/public/v1/projects
Liste vos projets (paramètres : limit jusqu'à 100, purpose = film ou ad).

POST/api/public/v1/projects

Crée un projet à partir d'une idée.

curl -X POST https://imascreen.app/api/public/v1/projects \
  -H "Authorization: Bearer ims_live_..." \
  -H "Content-Type: application/json" \
  -d '{"idea":"Portrait d un artisan verrier","format":"vertical"}'

GET/api/public/v1/projects/{id}
Détail d'un projet, avec la liste des plans et leurs durées.
PATCH/api/public/v1/projects/{id}
Met à jour le titre, l'idée, la logline ou le format.

Montage automatique

POST/api/public/v1/montage

Lance un montage complet à partir d'une idée : découpage en plans puis fabrication de chaque plan. Renvoie 202 avec un jobId. Alias : /api/public/montage.

curl -X POST https://imascreen.app/api/public/v1/montage \
  -H "Authorization: Bearer ims_live_..." \
  -H "Content-Type: application/json" \
  -d '{"idea":"Portrait d un artisan verrier","seconds":30,"format":"vertical","engine":"minimax-h3"}'

GET/api/public/v1/montage/{jobId}
Suivi du montage : chaque appel avance d'un plan et renvoie status (queued, running, succeeded, failed), progress, total. Interrogez jusqu'à succeeded pour récupérer les liens signés.
```
curl https://imascreen.app/api/public/v1/montage/JOB_ID \
  -H "Authorization: Bearer ims_live_..."
```

Génération IA

POST/api/public/v1/shots

Fabrique un plan vidéo (5 à 30 s selon le moteur) et renvoie un lien MP4 signé.

curl -X POST https://imascreen.app/api/public/v1/shots \
  -H "Authorization: Bearer ims_live_..." \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Un verrier souffle une bulle incandescente, gros plan","seconds":10,"engine":"minimax-h3"}'

POST/api/public/v1/voice
Synthétise une voix off (MP3) à partir d'un texte.
POST/api/public/v1/images
Génère une image fixe (PNG), qualité standard ou hd.

Export

GET/api/public/v1/projects/{id}/assets
Liens signés (6 h) des médias du projet : plan par plan en MP4, images, voix off et musique. Le master final .mp4 / .mov est encodé dans le studio.

Publication

GET/api/public/v1/publications
Publications déjà effectuées et publications programmées.

POST/api/public/v1/publications

Programme une vidéo sur un ou plusieurs réseaux déjà connectés (youtube, tiktok, instagram, facebook, x).

curl -X POST https://imascreen.app/api/public/v1/publications \
  -H "Authorization: Bearer ims_live_..." \
  -H "Content-Type: application/json" \
  -d '{"projectId":"...","platforms":["tiktok"],"scheduledAt":"2026-09-10T08:00:00Z","title":"Le verrier"}'

Erreurs

Les erreurs renvoient un JSON de la forme{"error":{"code":"...","message":"..."}}: 401 clé absente ou révoquée, 402 formule Studio requise, 403 portée refusée, 404 ressource introuvable, 409 réseau non connecté, 422 requête invalide, 502 moteur indisponible.