Espace de travail

Un espace de travail = une marque. GET /v1/workspace renvoie son identité, son profil de marque (celui qui nourrit la génération de scripts), le plan en cours et le solde de crédits. C'est l'appel à faire en premier dans une intégration ou un agent : il dit qui vous êtes et ce que vous pouvez encore faire.

Principe

GET

/v1/workspace

Identité, marque, plan et crédits

Scope : workspace:read. Toute clé disposant d'un scope d'action (publish:posts, media:write) y a également accès — connaître son espace est un prérequis pour agir dessus.

Lire l'espace

curl https://api.kreatoai.com/v1/workspace \
  -H "x-api-key: sk-kre-v1-votre_cle"

// 200 OK
{
  "id": "0e98ae67-…",
  "name": "FootballWorld",
  "description": "Le meilleur du football, chaque jour.",
  "currency": "EUR",
  "logoUrl": "https://media.kreatoai.com/…/logo.png",
  "brand": {
    "targetAudience": "Fans de football 18-35 ans",
    "uniqueValueProp": "Des moments cultes racontés en 30 secondes",
    "voiceTone": "energetic",
    "contentTopics": ["Messi", "Ligue des champions", "transferts"]
  },
  "plan": {
    "name": "STARTER",
    "subscribed": "STARTER",
    "status": "active",
    "periodEnd": "2026-09-25T00:00:00.000Z",
    "monthlyCredits": 250
  },
  "credits": {
    "balance": 42,
    "cost": { "IMAGE": 2, "VIDEO": 15 },
    "clip": { "5": 15, "10": 30, "15": 45 }
  },
  "createdAt": "2026-08-23T15:50:50.000Z"
}

Champs

Champ	Description
`brand`	Profil de marque : nom, ton, sujets et couleurs de l’espace
`plan.name`	Plan réellement actif maintenant : FREE, STARTER ou GROWTH
`plan.subscribed`	Plan souscrit. Peut différer de plan.name si l’abonnement est arrivé à échéance
`plan.status`	État de l’abonnement chez le prestataire de paiement : active, cancelled, on_hold… ; null sans abonnement
`plan.periodEnd`	Fin de la période payée. Un abonnement annulé garde l’accès jusque-là
`plan.monthlyCredits`	Dotation mensuelle du plan actif, en crédits
`credits.balance`	Solde disponible. Les crédits non utilisés se reportent tant que l’abonnement est actif
`credits.cost`	Tarif d’une image et d’un clip de 5 secondes, pour n’avoir aucun prix à recopier
`credits.clip`	Tarif du clip durée par durée : 5, 10 et 15 secondes, facturées à la seconde