Doks & Crédits

Fonctionnement du système de crédits DokJet.

Dok

1 génération PDF standard = 1 Dok. Les options activées ajoutent des Doks.

Coût des options

Option	Coût	Description
Génération standard	1 Dok	Chaque appel POST /v1/generate, /v1/transform ou /v1/studio/{slug}.
goDokMode	+1 Dok	Optimisation IA de la mise en page. `false` par défaut sur /v1/generate, `true` par défaut sur /v1/transform.
goDokMode + fichier joint	+2 Doks	goDokMode activé + fichier source joint (multipart/form-data). Mode /v1/generate uniquement.
compress	+1 Dok	Compression qpdf du PDF généré.
factur_x	+1 Dok	Force PDF/A-3b + préparation Factur-X (données XML embarquées).
embed_files	+1 Dok	Embarque des fichiers comme pièces jointes invisibles. Forfait : +1 Dok quel que soit le nombre de fichiers.
attachments	+1 Dok / fichier	Fusion de PDFs externes dans le document généré. Compté par fichier joint.
header_html / footer_html	Gratuit	En-têtes et pieds de page HTML personnalisés. Styles inline requis.
pdf_format	Gratuit	Format PDF/A (archivage). Valeurs : PDF/A-1a, 1b, 2b, 3b.
password	Gratuit	Chiffrement AES du PDF. Plans payants uniquement (HTTP 403 sur Free).

Exemples de calcul

1 Dok

Facture standard

1 appel à POST /v1/generate, sans option activée.

3 Doks

Facture avec Factur-X + compression

Base (1) + factur_x: true (+1) + compress: true (+1) = 3 Doks total.

10 Doks

Batch de 5 avec goDokMode

5 entrées × 2 Doks chacune (goDokMode activé) = 10 Doks minimum.

Limites par plan

Plan	Doks mensuels	Batch max entries	Chiffrement PDF	Workspaces
Free	50 Doks / mois	3	Non	1
Pro	500 Doks / mois	10	Oui	3
Max	2 000 Doks / mois + recharge auto	10	Oui	Illimités

Vérifier votre solde

Utilisez GET /v1/credits à tout moment pour vérifier votre solde de Doks et votre plan actif.

curl https://dokjet.ptitlabo.xyz/v1/credits \
  -H "X-API-Key: dk_live_••••••••••••"
→  200 OK
{
  "credits_left": 42,
  "plan":         "Free"
}

const balance = await fetch('https://dokjet.ptitlabo.xyz/v1/credits', {
  headers: { 'X-API-Key': 'dk_live_••••••••••••' },
}).then(r => r.json());
// { credits_left: 42, plan: 'Free' }

$data = json_decode(file_get_contents(
  'https://dokjet.ptitlabo.xyz/v1/credits', false,
  stream_context_create(['http' => [
    'header' => "X-API-Key: dk_live_••••••••••••\r\n"
  ]])
), true);

balance = requests.get(
    'https://dokjet.ptitlabo.xyz/v1/credits',
    headers={'X-API-Key': 'dk_live_••••••••••••'}
).json()
# {'credits_left': 42, 'plan': 'Free'}

Recharge automatique (plan Max)

Le plan Max bénéficie d'une recharge automatique lorsque le solde de Doks descend sous le seuil configuré dans le dashboard. Configurez le seuil et le montant de recharge dans Paramètres → Facturation.