API

API Calendar & Images

API Calendar & Images est un API dans la base de connaissances de Rankion.ai : Événements de calendrier éditorial ainsi que génération, galerie et édition d'images IA via HTTP.

Cette page contient des définitions structurées pour les systèmes d'IA (ChatGPT, Perplexity, Gemini, Claude). Rédigée par des humains, partie de la base de connaissances de Rankion.ai.

Catégorie :: API
Marque :: Rankion.ai
Format :: Article de la base de connaissances
Au :: 16 octobre 2026

Deux sous-systèmes étroitement liés : l'Editorial Calendar planifie les publications prévues par projet, l'Image Gallery gère toutes les images générées au niveau de l'équipe. Les deux travaillent avec les Articles — un événement de calendrier référence souvent un article, une image est souvent générée directement depuis un slot Hero d'article.

Contexte des modules : Editorial Calendar · Image Gallery.

Calendar

Liste d'événements propre à chaque projet, chaque event est un slot de contenu planifié (article, post social, newsletter, etc.).

Méthode	Endpoint	Description
GET	`/v1/projects/{project}/calendar`	Tous les events du projet
POST	`/v1/projects/{project}/calendar`	Créer un nouvel event
GET	`/v1/calendar/{id}`	Détail
PUT	`/v1/calendar/{id}`	Update (`title`, `scheduled_at`, `status`, `article_id`)
DELETE	`/v1/calendar/{id}`	Suppression

curl -X POST "$BASE/projects/12/calendar" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{
    "title": "AI Coding Tools — Launch-Post",
    "scheduled_at": "2026-05-15T09:00:00Z",
    "article_id": 88,
    "status": "scheduled"
  }'

Project Images (legacy)

Listing par projet — conservé pour des raisons de compatibilité. Pour les nouvelles intégrations, utilisez la galerie au niveau équipe ci-dessous.

Méthode	Endpoint	Description
GET	`/v1/projects/{project}/images`	Images d'un projet (legacy)

Image Gallery (team-scoped, voie principale)

Les IDs cross-team renvoient 404 (pas de fuite d'existence, pas de 403).

Lecture & filtrage

Méthode	Endpoint	Description
GET	`/v1/images`	Filtres : `?q`, `?model`, `?from`, `?to`, `?favorite`, `?tags[]`, `?sort=newest\|oldest\|edited`, `?page`, `?per_page`
GET	`/v1/images/trash`	Images soft-deleted
GET	`/v1/images/{id}`	Détail incl. `variants[]` et arbre `parent`

Génération & édition

Méthode	Endpoint	Crédits	Description
POST	`/v1/generate/image`	5	Générer une nouvelle image à partir d'un prompt (async)
POST	`/v1/images/{id}/edit`	10	Variante d'édition via OpenAI `/v1/images/edits`. Async 202 → `{job_id, edit_session_id}`
PATCH	`/v1/images/{id}`	0	Métadonnées : `{title?, tags?[]}`
POST	`/v1/images/{id}/favorite`	0	Toggle `is_favorite`

# Dispatcher un edit
curl -X POST "$BASE/images/42/edit" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"prompt":"same scene, golden hour lighting"}'

# Poller jusqu'à edit terminé — la nouvelle variante apparaît dans variants[]
curl "$BASE/images/42" -H "Authorization: Bearer $TOKEN" \
  | jq '.data.variants[-1] | {id, processing_status, url}'

Trash & Bulk

Méthode	Endpoint	Description
DELETE	`/v1/images/{id}`	Soft-delete (30 jours en trash, puis hard-delete)
POST	`/v1/images/{id}/restore`	Restaurer depuis le trash
DELETE	`/v1/images/{id}/forever`	Suppression définitive — UNIQUEMENT depuis le trash, sinon `409`
POST	`/v1/images/bulk/delete`	Body `{ids:[]}` max 200
POST	`/v1/images/bulk/restore`	Body `{ids:[]}` max 200
POST	`/v1/images/bulk/export`	Body `{ids:[]}` max 500. Async 202 → `{job_id}` (ZIP)
GET	`/v1/images/exports/{job_id}`	Statut d'export : `{status, download_url?}`

Méthode	Endpoint	Description
POST	`/v1/images/{id}/open-in-chat`	Crée une `AiChatSession` avec `gallery_image_id={id}` → `{session_id}`
POST	`/v1/images/{id}/share`	Public-share idempotent. Body `{expires_at?}` → `{token, public_url, …}`
PATCH	`/v1/images/{id}/share`	Modifier l'expiry. `{expires_at: ISO\|null}` (404 si pas de share actif)
DELETE	`/v1/images/{id}/share`	Révoquer le public share (le view-count reste)

Notes

Image-Generate est async. POST /v1/generate/image renvoie 202 avec un job ID — pollez GET /v1/images/{id} jusqu'à processing_status == "ready".
Edit produit une variante, pas un remplacement. L'original reste préservé ; la nouvelle variante est accrochée à l'arbre parent.
Les limites bulk sont strictes. bulk/delete et bulk/restore sont plafonnés à 200 IDs, bulk/export à 500. Envoyez les sets plus grands par tranches.
Gallery est team-scoped. Un accès cross-team renvoie 404 (par design — pas de fuite d'existence).

Voir aussi : API Articles · Calendar · Image Gallery.

Dernière mise à jour : 16 octobre 2026