Documentation API

Transcribe and wait for the result

Submit a source and receive the finished transcript in the SAME response — no job id, no polling loop. Returns **200** with `transcript` (and `segments`) once the transcription completes, which is immediate when the source is already in the shared cache. Long audio does not fit in one HTTP request. When the transcription is still running after the wait window (default 30s, `?wait=` up to 120s), the response is **202** with the job `id` and `status: "processing"` — the job keeps running, and GET /transcriptions/{id} retrieves it exactly as with the asynchronous API. Treat 202 as "not finished yet", never as a failure. A job that fails within the window returns **200** with `status: "failed"` and `error` set: the request succeeded, the transcription did not.

curl -X POST https://api.techtuel.com/v1/transcribe \
  -H "Authorization: Bearer txl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "preferred_language": "fr"
  }'

{
  "api_key_id": "key_abc123",
  "created_at": "2026-07-21T09:30:00Z",
  "degraded_windows": 0,
  "detected_language": "it",
  "error": "source could not be resolved",
  "id": "job_abc123",
  "language": "fr",
  "minutes": 12.5,
  "segments": [
    {
      "start_seconds": 12.5,
      "text": "Bonjour et bienvenue dans cet"
    }
  ],
  "source_kind": "url",
  "source_url": "https://youtu.be/dQw4w9WgXcQ",
  "status": "completed",
  "title": "Le 6-9 de France Inter",
  "transcript": "Bonjour et bienvenue dans cet épisode…",
  "translated": true
}

400

Bad Request

401

Unauthorized

402

Refused: `reason` says which — `quota_exceeded`, `source_too_long` (longer than the plan's whole monthly allowance covers) or `payment_failed`

Transcribe a local file in one call

Send the audio/video file itself and receive the finished transcript in the SAME response — no upload slot, no polling loop. This is the one-call form of the three-step upload flow (POST /uploads → PUT → POST /transcribe). Send `multipart/form-data` with the bytes in a `file` part; `Content-Type` of that part decides the accepted format. Limited to 100 MiB per request, well below what POST /uploads accepts (200 MiB audio, 1 GiB video): here the bytes travel through the API, whereas a presigned upload goes straight to storage. A larger file gets **413** naming the presigned flow — use it, it is not a downgrade but the shape that works for big files. Wait semantics are identical to POST /transcribe: **200** once the transcription completes, **202** with the job `id` when it is still running after the wait window (default 30s, `?wait=` up to 120s). Upload time counts against that window, so a large file is likelier to answer 202 — the job keeps running and GET /transcriptions/{id} retrieves it.

curl -X POST https://api.techtuel.com/v1/transcribe/file \
  -H "Authorization: Bearer txl_your_api_key" \
  -F file=@/path/to/episode.mp3 \
  -F preferred_language=fr

{
  "api_key_id": "key_abc123",
  "created_at": "2026-07-21T09:30:00Z",
  "degraded_windows": 0,
  "detected_language": "it",
  "error": "source could not be resolved",
  "id": "job_abc123",
  "language": "fr",
  "minutes": 12.5,
  "segments": [
    {
      "start_seconds": 12.5,
      "text": "Bonjour et bienvenue dans cet"
    }
  ],
  "source_kind": "url",
  "source_url": "https://youtu.be/dQw4w9WgXcQ",
  "status": "completed",
  "title": "Le 6-9 de France Inter",
  "transcript": "Bonjour et bienvenue dans cet épisode…",
  "translated": true
}

400

Missing file part or unsupported format

401

Unauthorized

402

Refused: `reason` says which — `quota_exceeded` or `payment_failed`

413

File exceeds the inline limit — use POST /uploads

503

Uploads not configured

Lister les transcriptions

Retourne les jobs de transcription du compte authentifié, du plus récent au plus ancien, page par page. Utilisez ?page= (à partir de 1) et ?per_page= (20 par défaut, 100 au maximum) ; la réponse porte `total` et `has_more` pour permettre à un client d'enchaîner la page suivante. Les lignes n'incluent PAS le transcript complet — seulement `preview_segments`.

curl -X GET https://api.techtuel.com/v1/transcriptions \
  -H "Authorization: Bearer txl_your_api_key"

{
  "has_more": true,
  "jobs": [
    {
      "api_key_id": "key_abc123",
      "created_at": "2026-07-21T09:30:00Z",
      "error": "string",
      "has_transcript": true,
      "id": "job_abc123",
      "minutes": 12.5,
      "preview_segments": [],
      "source_kind": "url",
      "source_url": "https://youtu.be/dQw4w9WgXcQ",
      "status": "processing",
      "title": "Le 6-9 de France Inter"
    }
  ],
  "page": 1,
  "per_page": 10,
  "total": 47
}

401

Unauthorized

Créer une transcription

Soumet un audio à transcrire. Répond immédiatement avec un job en cours de traitement ; interrogez ensuite l'endpoint de récupération, ou appuyez-vous sur un webhook pour être notifié du résultat.

curl -X POST https://api.techtuel.com/v1/transcriptions \
  -H "Authorization: Bearer txl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "preferred_language": "fr"
  }'

{
  "api_key_id": "key_abc123",
  "created_at": "2026-07-21T09:30:00Z",
  "degraded_windows": 0,
  "detected_language": "it",
  "error": "source could not be resolved",
  "id": "job_abc123",
  "language": "fr",
  "minutes": 12.5,
  "segments": [
    {
      "start_seconds": 12.5,
      "text": "Bonjour et bienvenue dans cet"
    }
  ],
  "source_kind": "url",
  "source_url": "https://youtu.be/dQw4w9WgXcQ",
  "status": "completed",
  "title": "Le 6-9 de France Inter",
  "transcript": "Bonjour et bienvenue dans cet épisode…",
  "translated": true
}

400

Bad Request

401

Unauthorized

402

Refused: `reason` says which — `quota_exceeded` (the period's allowance is spent; it refills on renewal), `source_too_long` (the source is longer than the plan's whole monthly allowance can cover; only a larger plan helps, waiting does not), or `payment_failed` (the subscription is unpaid; update the payment method)

Récupérer une transcription

Récupère un job de transcription par son id. La réponse par défaut est l'enveloppe JSON du job (statut + texte assemblé). Passez ?format= pour télécharger le transcript dans un format horodaté une fois le job terminé : `txt` (texte brut), `json` (texte + segments horodatés), `srt` (sous-titres SubRip), `vtt` (sous-titres WebVTT).

curl -X GET https://api.techtuel.com/v1/transcriptions/job_abc123 \
  -H "Authorization: Bearer txl_your_api_key"

{
  "api_key_id": "key_abc123",
  "created_at": "2026-07-21T09:30:00Z",
  "degraded_windows": 0,
  "detected_language": "it",
  "error": "source could not be resolved",
  "id": "job_abc123",
  "language": "fr",
  "minutes": 12.5,
  "segments": [
    {
      "start_seconds": 12.5,
      "text": "Bonjour et bienvenue dans cet"
    }
  ],
  "source_kind": "url",
  "source_url": "https://youtu.be/dQw4w9WgXcQ",
  "status": "completed",
  "title": "Le 6-9 de France Inter",
  "transcript": "Bonjour et bienvenue dans cet épisode…",
  "translated": true
}

401

Unauthorized

404

Not Found

409

Conflict

422

Unprocessable Entity

Supprimer une transcription

Retire de l'historique de l'appelant une transcription terminée (réussie ou en échec). Le transcript lui-même reste dans le cache de sources partagé : resoumettre la même source plus tard reste servi sans re-transcrire. Un job encore en cours ne peut pas être supprimé — attendez qu'il se termine.

curl -X DELETE https://api.techtuel.com/v1/transcriptions/job_abc123 \
  -H "Authorization: Bearer txl_your_api_key"

"string"

404

Not Found

Relancer une transcription en échec

Remet en file une transcription en échec sur le MÊME job, afin que l'historique conserve une ligne par source au lieu d'en accumuler une par tentative. Seuls les jobs en échec peuvent être relancés, et la relance est soumise au quota mensuel.

curl -X POST https://api.techtuel.com/v1/transcriptions/job_abc123/retry \
  -H "Authorization: Bearer txl_your_api_key"

{
  "api_key_id": "key_abc123",
  "created_at": "2026-07-21T09:30:00Z",
  "degraded_windows": 0,
  "detected_language": "it",
  "error": "source could not be resolved",
  "id": "job_abc123",
  "language": "fr",
  "minutes": 12.5,
  "segments": [
    {
      "start_seconds": 12.5,
      "text": "Bonjour et bienvenue dans cet"
    }
  ],
  "source_kind": "url",
  "source_url": "https://youtu.be/dQw4w9WgXcQ",
  "status": "completed",
  "title": "Le 6-9 de France Inter",
  "transcript": "Bonjour et bienvenue dans cet épisode…",
  "translated": true
}

402

Refused: `reason` is `quota_exceeded`, `source_too_long` or `payment_failed`

404

Not Found

Translate a transcript into another language

Renders a completed transcript into `language` (ISO 639-1), preserving timings. Cached per language, so asking twice is free. Translating into the transcript's own language returns it unchanged. Costs no extra credit today.

curl -X POST https://api.techtuel.com/v1/transcriptions/job_abc123/translate \
  -H "Authorization: Bearer txl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "language": "fr"
  }'

{
  "degraded_windows": 0,
  "detected_language": "en",
  "language": "fr",
  "segments": [
    {
      "start_seconds": 12.5,
      "text": "Bonjour et bienvenue dans cet"
    }
  ],
  "source_id": "string",
  "transcript": "string"
}

400

language is required or malformed

404

transcript not found

409

transcript is not ready to translate

422

this transcript cannot be translated

503

translation backend is not configured

List a transcript's available translations

Returns the languages already produced for this transcript, without their content.

curl -X GET https://api.techtuel.com/v1/transcriptions/job_abc123/translations \
  -H "Authorization: Bearer txl_your_api_key"

{
  "languages": [
    "fr",
    "es"
  ]
}

404

transcript not found

Read one translation of a transcript

Returns the transcript rendered into `lang` when it exists, else 404. Produce it first with POST /transcriptions/{id}/translate.

curl -X GET https://api.techtuel.com/v1/transcriptions/job_abc123/translations/fr \
  -H "Authorization: Bearer txl_your_api_key"

{
  "degraded_windows": 0,
  "detected_language": "en",
  "language": "fr",
  "segments": [
    {
      "start_seconds": 12.5,
      "text": "Bonjour et bienvenue dans cet"
    }
  ],
  "source_id": "string",
  "transcript": "string"
}

404

transcript or translation not found

Extract clean, structured text from a web page

Fetches a public web page, strips navigation/ads/boilerplate, and returns its title, metadata and readable text — both flattened and split into positioned segments. Synchronous: the text comes back in this response, with no polling. The extraction is also recorded under an `id`, so it is listed by GET /v1/transcriptions and can be re-read or deleted like a transcription. Costs 1 credit; a page already in the global cache is free.

curl -X POST https://api.techtuel.com/v1/extract \
  -H "Authorization: Bearer txl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://example.com/article",
    "url": "https://example.com/article"
  }'

{
  "author": "string",
  "cached": false,
  "char_count": 0,
  "credits_charged": 0,
  "description": "string",
  "extracted_at": "string",
  "id": "string",
  "image_url": "string",
  "segments": [
    {
      "char_length": 0,
      "char_offset": 0,
      "section_title": "string",
      "text": "string"
    }
  ],
  "site_name": "string",
  "source_id": "string",
  "source_type": "webpage",
  "text": "string",
  "title": "string",
  "url": "string"
}

400

invalid or disallowed url

402

Refused: `reason` says which — `quota_exceeded` or `payment_failed`

404

page not found

422

page yielded no readable content (paywall, JS-only app, or no prose)

502

page could not be fetched

503

site is rate limiting us; retry later

Créer un emplacement d'envoi de fichier

Retourne une URL PUT présignée. Envoyez le fichier audio/vidéo directement sur `put_url` avec exactement les `size_bytes` déclarés, puis appelez POST /transcriptions avec l'`upload_id` retourné. `content_type` et `size_bytes` sont signés dans l'URL : le stockage rejette un envoi qui ne correspond pas. Les limites de taille dépendent du médium : 25 Mio pour l'audio, 200 Mio pour la vidéo.

curl -X POST https://api.techtuel.com/v1/uploads \
  -H "Authorization: Bearer txl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "content_type": "audio/mpeg",
    "filename": "episode.mp3",
    "size_bytes": 18400000
  }'

{
  "expires_at": "2026-06-04T12:15:00Z",
  "put_url": "https://s3.fr-par.scw.cloud/...",
  "upload_id": "up_3f8c2a1e-9d41-4e7b-a12b-c45de6789012"
}

400

Missing/unsupported content_type or size_bytes

401

Unauthorized

413

File exceeds the size limit

503

Uploads not configured

Lister les clés API

Liste les clés API de l'utilisateur authentifié. Le hash du jeton et le secret brut ne sont jamais retournés — uniquement les métadonnées (id, nom, préfixe, 4 derniers caractères, dates).

curl -X GET https://api.techtuel.com/v1/keys \
  -H "Authorization: Bearer txl_your_api_key"

{
  "keys": [
    {
      "created_at": "2026-06-05T10:00:00Z",
      "id": "key_abc123",
      "last4": "a1b2",
      "last_used_at": "2026-06-05T12:30:00Z",
      "name": "production server",
      "prefix": "txl_"
    }
  ]
}

401

Unauthorized

Créer une clé API

Génère une nouvelle clé API pour l'utilisateur authentifié. Le jeton brut n'est retourné qu'une seule fois, dans le champ `token` — conservez-le immédiatement, il ne pourra plus jamais être récupéré. Accessible uniquement depuis une session web connectée (une clé API ne peut pas en générer une autre).

curl -X POST https://api.techtuel.com/v1/keys \
  -H "Authorization: Bearer txl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "production server"
  }'

{
  "created_at": "2026-06-05T10:00:00Z",
  "id": "key_abc123",
  "last4": "a1b2",
  "last_used_at": "2026-06-05T12:30:00Z",
  "name": "production server",
  "prefix": "txl_",
  "token": "txl_a1b2c3d4e5f6..."
}

400

Bad Request

401

Unauthorized

403

Authenticated with an API key, not a session

Révoquer une clé API

Révoque définitivement une des clés API de l'utilisateur authentifié. Idempotent : révoquer une clé inconnue ou déjà révoquée retourne quand même 204. Accessible uniquement depuis une session web connectée.

curl -X DELETE https://api.techtuel.com/v1/keys/key_abc123 \
  -H "Authorization: Bearer txl_your_api_key"

401

Unauthorized

403

Authenticated with an API key, not a session

Démarrer un paiement (abonnement ou crédits)

Retourne l'URL d'une page de paiement hébergée pour le plan demandé. Redirigez l'utilisateur vers cette URL pour souscrire ou acheter des crédits.

curl -X POST https://api.techtuel.com/v1/billing/checkout \
  -H "Authorization: Bearer txl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "cancel_url": "https://app.example.com/billing/return",
    "email": "dev@example.com",
    "name": "Ada Lovelace",
    "payment_method": "card",
    "plan": "pro",
    "success_url": "https://app.example.com/billing/return"
  }'

{
  "checkout_url": "string"
}

400

Bad Request

401

Unauthorized

409

Already subscribed

503

Unavailable: `reason` says which — `billing_not_configured` (nothing wired, normal in dev) or `billing_unavailable` (configured and broken)

Read how a checkout ended

Reports the state of a checkout the caller opened, for the page the provider returns to. The redirect itself carries no outcome — a refused card lands on the same URL as a paid one — so poll this while `status` is `pending` or `redirected`, and open access on `paid`. Someone else's session reads as not found.

curl -X GET https://api.techtuel.com/v1/billing/checkout/6f1c2a0e-9b7d-4c3e-8a5f-2d1e0b9c8a7f \
  -H "Authorization: Bearer txl_your_api_key"

{
  "failure_reason": "insufficient_funds",
  "paid": false,
  "session_id": "6f1c…",
  "status": "failed",
  "subscription_status": "incomplete"
}

401

Unauthorized

404

Not Found

503

Service Unavailable

List how a plan may be paid for

Returns the payment methods this plan accepts, in the order to offer them. Ask before showing a choice: a method absent here is one the checkout refuses.

curl -X GET https://api.techtuel.com/v1/billing/checkout/methods?plan= \
  -H "Authorization: Bearer txl_your_api_key"

{
  "methods": [
    {
      "id": "card",
      "label": "Carte bancaire"
    }
  ]
}

400

Bad Request

401

Unauthorized

503

Unavailable: `reason` says which

Schedule a move to a smaller tier

Schedules a move DOWN to a smaller tier at the next renewal. Nothing changes today: the tier already paid for keeps its full allowance and rate limit until the end of the current period, and the smaller price is charged from the renewal that applies the smaller tier. Nothing is refunded and nothing is shortened. Refused when the target is larger than the current tier (use /billing/upgrade, which is immediate) or is the free tier (use DELETE /billing/subscription, which is a cancellation), and when the subscription is unpaid or already cancelled.

curl -X POST https://api.techtuel.com/v1/billing/downgrade \
  -H "Authorization: Bearer txl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "plan": "pro"
  }'

{
  "effective_at": "2026-08-24T09:00:00Z",
  "pending_plan": "pro",
  "plan": "max"
}

400

Unknown or unsellable plan, or nothing to downgrade

401

Unauthorized

409

Not a downgrade, or the subscription cannot be downgraded (unpaid or cancelled)

503

Unavailable: `reason` says which — `billing_not_configured` (nothing wired, normal in dev) or `billing_unavailable` (configured and broken)

Withdraw a scheduled tier change

Cancels a downgrade that was scheduled but has not taken effect yet. The tier currently held stays in force and keeps being charged at its own price. Free, and idempotent: withdrawing when nothing is scheduled succeeds.

curl -X DELETE https://api.techtuel.com/v1/billing/pending-change \
  -H "Authorization: Bearer txl_your_api_key"

{
  "effective_at": "2026-08-24T09:00:00Z",
  "pending_plan": "pro",
  "plan": "max"
}

401

Unauthorized

502

Payment provider refused to restore the schedule

503

Unavailable: `reason` says which — `billing_not_configured` (nothing wired, normal in dev) or `billing_unavailable` (configured and broken)

Lister les grilles tarifaires

Retourne les plans publics (Free, Pro, Max) avec leurs allocations mensuelles et leur prix, pour la page tarifs et le choix de montée en gamme. Un plan n'est souscriptible que si `purchasable` vaut true. Aucune authentification requise.

curl -X GET https://api.techtuel.com/v1/billing/plans \
  -H "Authorization: Bearer txl_your_api_key"

{
  "plans": [
    {
      "credits": 2000,
      "currency": "EUR",
      "name": "pro",
      "price_cents": 900,
      "purchasable": true,
      "rate_per_min": 120
    }
  ]
}

Restore the caller's free-tier subscription

Grants the free tier when Lungor holds no subscription for the caller, and reports whether it now does. Idempotent on the ledger: granting an owner Lungor already holds is a no-op there, so the button is safe to press twice. It deliberately does not skip the call for an owner recorded as granted locally — that record is exactly what a repair exists to disprove. Signup grants it best-effort, so an account created while Lungor was unreachable has no allowance and is refused every job. The balance reads repair it on their own, but only once the user hits one — this is the way out that does not depend on that.

curl -X POST https://api.techtuel.com/v1/billing/repair \
  -H "Authorization: Bearer txl_your_api_key"

{
  "granted": false
}

401

Unauthorized

500

Internal Server Error

503

Service Unavailable

Résilier votre abonnement

Interrompt les prélèvements à venir. L'accès continue jusqu'à la fin de la période déjà payée — le mois entamé n'est ni remboursé, ni révoqué. Idempotent : résilier sans abonnement actif réussit quand même.

curl -X DELETE https://api.techtuel.com/v1/billing/subscription \
  -H "Authorization: Bearer txl_your_api_key"

{
  "access_until": "2026-08-24T09:00:00Z",
  "active": true,
  "status": "canceled"
}

401

Unauthorized

502

Payment provider refused the cancellation

503

Unavailable: `reason` says which — `billing_not_configured` (nothing wired, normal in dev) or `billing_unavailable` (configured and broken)

Move your subscription to another tier

Changes the tier of an active subscription. Requires explicit consent (`consented`), and charges the prorated difference for the remainder of the current period on the card already on file — call POST /billing/upgrade/quote first to obtain that amount and show it. The charge happens BEFORE the tier is applied: a declined card answers 402 and leaves the subscription untouched. Below the collection floor nothing is charged and the tier is granted anyway. The new allowance applies immediately; the new price applies from the next renewal, and the period already paid is neither re-charged in full nor refunded.

curl -X POST https://api.techtuel.com/v1/billing/upgrade \
  -H "Authorization: Bearer txl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "consent_version": "upgrade-v1",
    "consented": true,
    "locale": "fr",
    "plan": "max",
    "quoted_cents": 350
  }'

{
  "allowance_from": "now",
  "charged_from": "2026-08-24T09:00:00Z",
  "charged_now_cents": 350,
  "plan": "max"
}

400

Unknown or unsellable plan, nothing to upgrade, or consent missing

401

Unauthorized

402

The card was declined. Nothing changed: the tier is applied only once the payment lands

409

Subscription cannot be upgraded (unpaid or cancelled), or the plan is a downgrade — this endpoint only moves UP, since a smaller tier applied today would cut an allowance already paid for

503

Unavailable: `reason` says which — `billing_not_configured` (nothing wired, normal in dev) or `billing_unavailable` (configured and broken)

Quote what an upgrade will cost today

Returns the amount charged immediately for moving to a larger tier (the price difference, prorated over the days left in the period already paid), and the recurring price from the next renewal. Charges nothing — call POST /billing/upgrade to commit. A charge of 0 means the proration fell under the collection floor and the tier is granted with no payment today.

curl -X POST https://api.techtuel.com/v1/billing/upgrade/quote \
  -H "Authorization: Bearer txl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "consent_version": "upgrade-v1",
    "consented": true,
    "locale": "fr",
    "plan": "max",
    "quoted_cents": 350
  }'

{
  "charge_cents": 350,
  "charged_from": "2026-08-24T09:00:00Z",
  "consent_required": true,
  "consent_text": "J'accepte le prélèvement de 8 € aujourd'hui, puis 17 € par mois jusqu'à résiliation.",
  "consent_version": "upgrade-v1",
  "currency": "EUR",
  "pending_plan_cancelled": "pro",
  "plan": "max",
  "prorated_days": 15,
  "recurring_cents": 1200
}

400

Unknown or unsellable plan

401

Unauthorized

409

Subscription cannot be upgraded (unpaid or cancelled), or the plan is a downgrade — schedule it with /billing/downgrade

503

Service Unavailable

Lungor subscription webhook

Ingests Lungor's subscription lifecycle events. Authenticated by HMAC signature, not by API key. Not called by clients.

curl -X POST https://api.techtuel.com/v1/billing/webhook/lungor \
  -H "Authorization: Bearer txl_your_api_key"

"string"

401

invalid signature

List the caller's invoices

Returns the authenticated customer's own invoices, newest first.

curl -X GET https://api.techtuel.com/v1/invoices \
  -H "Authorization: Bearer txl_your_api_key"

[
  {
    "amount": 1900,
    "currency": "EUR",
    "customer_email": "client@example.com",
    "customer_name": "Client Test",
    "id": "3f8c2a1e-...",
    "issued_at": "2026-07-01T00:00:00Z",
    "number": "2026-0001",
    "status": "paid"
  }
]

401

Unauthorized

503

Invoicing is not configured

Get one of the caller's invoices

curl -X GET https://api.techtuel.com/v1/invoices/3f8c2a1e-7b4d-4e2a-9c11-8a6f5d3b2c10 \
  -H "Authorization: Bearer txl_your_api_key"

{
  "currency": "EUR",
  "id": "string",
  "issued_at": "string",
  "lines": [
    {
      "amount": 1900,
      "description": "Abonnement Techtuel Pro",
      "kind": "flat",
      "quantity": 1,
      "unit": "credit",
      "unit_amount": 1900
    }
  ],
  "number": "2026-0001",
  "paid_at": "string",
  "pdf_url": "/v1/invoices/3f8c.../pdf",
  "period_end": "string",
  "period_start": "string",
  "status": "paid",
  "subtotal": 1900,
  "tax_amount": 0,
  "tax_rate": 0,
  "total": 1900
}

401

Unauthorized

404

Not Found

Download an invoice as a Factur-X PDF

curl -X GET https://api.techtuel.com/v1/invoices/3f8c2a1e-7b4d-4e2a-9c11-8a6f5d3b2c10/pdf \
  -H "Authorization: Bearer txl_your_api_key"

401

Unauthorized

404

Not Found

Consulter l'usage et le quota

Retourne le statut d'abonnement de l'appelant et sa consommation de transcription sur le mois en cours.

curl -X GET https://api.techtuel.com/v1/usage \
  -H "Authorization: Bearer txl_your_api_key"

{
  "access_ends_at": "2026-08-03T00:00:00Z",
  "active": true,
  "billing_state": "healthy",
  "cancel_at_period_end": false,
  "credits_limit": 2000,
  "credits_used": 84,
  "currency": "EUR",
  "next_charge_cents": 1200,
  "pending_plan": "pro",
  "pending_plan_at": "2026-08-24T09:00:00Z",
  "period_start": "2026-07-03T00:00:00Z",
  "plan": "pro",
  "rate_per_min": 120,
  "renews_at": "2026-08-18T00:00:00Z",
  "status": "active"
}

401

Unauthorized

503

Unavailable: `reason` says which — `billing_not_configured` (nothing wired, normal in dev) or `billing_unavailable` (configured and broken)

Supprimer votre compte

Résilie l'abonnement de l'appelant auprès du prestataire de paiement et purge ses données transcript-api (clés API, jobs, usage). Irréversible.

curl -X DELETE https://api.techtuel.com/v1/account \
  -H "Authorization: Bearer txl_your_api_key"

401

Unauthorized

500

Internal Server Error

502

Subscription cancellation failed; nothing was deleted

Export all your transcriptions

Returns every transcription the account owns, in one JSON document, with the full text and timed segments of each. This is the GDPR portability export: unlike GET /transcriptions it is neither paginated nor projected — completeness is the point. Session-only: an export is the whole account history in one file, so a raw API key — which travels in scripts and CI — cannot trigger one.

curl -X GET https://api.techtuel.com/v1/account/export \
  -H "Authorization: Bearer txl_your_api_key"

{
  "count": 57,
  "exported_at": "2026-07-31T09:30:00Z",
  "transcriptions": [
    {
      "created_at": "2026-07-21T09:30:00Z",
      "detected_language": "en",
      "error": "source could not be resolved",
      "id": "job_abc123",
      "language": "fr",
      "minutes": 12.5,
      "segments": [],
      "source_kind": "url",
      "source_url": "https://youtu.be/dQw4w9WgXcQ",
      "status": "completed",
      "title": "Le 6-9 de France Inter",
      "transcript": "Bonjour et bienvenue dans cet épisode…",
      "translated": true
    }
  ]
}

401

Unauthorized

500

Internal Server Error