Get started
Authentication
Every request carries your API key in an Authorization: Bearer header. Keys start with nb_, belong to one account and use its credits.
Get a key
- Subscribe to the API plan (€59.99 or $59.99 a month). Basic and Pro do not include REST access.
- Open Dashboard → API and click Create API key.
- Copy the key right away. It is shown once: we only keep a hash, so nobody can show it to you again.
One key is active per account. Regenerate in the dashboard if a key leaks or gets lost: the old key stops working at once.
Send the key
Add the header to every request:
HTTP
Authorization: Bearer nb_your_keyThe same call in each language, reading the key from NB_API_KEY:
curl "https://lannevideo.com/api/v1/video-status?video_id=48213" \
-H "Authorization: Bearer $NB_API_KEY"import os
import requests
resp = requests.get(
"https://lannevideo.com/api/v1/video-status",
headers={"Authorization": f"Bearer {os.environ['NB_API_KEY']}"},
params={
"video_id": 48213,
},
timeout=30,
)
resp.raise_for_status()
print(resp.json())// Node.js 18+
const res = await fetch("https://lannevideo.com/api/v1/video-status?video_id=48213", {
headers: {
Authorization: `Bearer ${process.env.NB_API_KEY}`,
},
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error}`);
console.log(data);<?php
$ch = curl_init('https://lannevideo.com/api/v1/video-status?video_id=48213');
curl_setopt_array($ch, [
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('NB_API_KEY'),
],
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status !== 200) {
throw new RuntimeException($data['error'] ?? "HTTP $status");
}
print_r($data);Only the Bearer header is accepted by the generation endpoints. Keys in a query string or an
X-API-Key header are refused there.Keep keys secret
- Server side only. Call the API from your backend. A key in browser JavaScript or a mobile app can be read by anyone.
- Environment variables or a secrets manager, never committed to git.
- Rotate when someone leaves the team or a key shows up in logs. Regenerating takes one click and invalidates the old key.
- Watch usage. The dashboard shows when the key was last used.
Authentication errors
| Status | Error | What to check |
|---|---|---|
| 401 | Missing or invalid Authorization header… | The header is missing or does not start with Bearer . |
| 401 | Invalid API key format | Whitespace or a truncated copy. Keys start with nb_. |
| 401 | Invalid API key | The key was regenerated, or the account is not active. |
| 403 | API access requires the API plan… | The account is not on the API plan. The body includes current_plan. |