Konvertio API
REST API for filkonvertering. Integrer video-, lyd-, bilde-, dokument- og arkivkonvertering direkte i appen din.
Base URL
/priser/api/v1
Introduksjon
Konvertio API lar deg konvertere filer programmatisk. APIet er asynkront: du sender en fil, får en job_id tilbake, poller status, og laster ned resultatet.
📤 POST /convert
→
🔄 GET /status/{id}
→
⬇️ GET /download/{id}
Autentisering
Alle API-kall krever en API-nøkkel i headeren X-API-Key.
HTTP
X-API-Key: kv_live_din_nokkel_her
💡 Hent API-nøkkelen din på prissiden. Demo-nøkkel for testing:
kv_demo_lett_7ebe909fc78c
Quickstart (5 minutter)
1
Hent en API-nøkkel fra prissiden
2
Send en POST til
/api/v1/convert3
Poll
/api/v1/status/{port}/{job_id} til status == "done"4
Last ned filen fra
/api/v1/download/{port}/{job_id}POST /api/v1/convert
Laster opp en fil og starter konvertering.
Request
| Parameter | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
file | File | ✅ | Filen som skal konverteres (multipart/form-data) |
output_format | string | ✅ | Utdataformat, f.eks. mp4, pdf, mp3 |
quality | string | — | high / medium / low (standard: medium) |
Response 202
JSON
{
"job_id": "a3f8c2d1-...",
"status": "queued",
"status_url": "/priser/api/v1/status/5001/a3f8c2d1-...",
"service_port": 5001
}
GET /api/v1/status/{port}/{job_id}
Sjekk status på en konverteringsjobb. Poll hvert 1–2 sekund.
Response
JSON
{
"status": "processing", // queued | processing | done | error
"progress": 65, // 0–100
"message": "Konverterer… 12s / 28s",
"output_file": null // filnavn når done
}
queued
processing
done
error
GET /api/v1/download/{port}/{job_id}
Last ned den konverterte filen. Returnerer binary stream med riktig Content-Type.
⚠️ Filer er tilgjengelige i henhold til planen din (1–90 dager). Last ned før utløp.
GET /api/v1/formats
Liste over alle støttede inn- og utdataformater.
JSON
{
"video": ["mp4","avi","mov","mkv","webm","flv","wmv","gif","mp3","aac"],
"audio": ["mp3","wav","flac","aac","ogg","opus","m4a","wma","aiff","ac3"],
"image": ["jpg","png","webp","gif","bmp","tiff","ico","pdf"],
"document": ["pdf","docx","doc","odt","rtf","txt","html","xlsx","ods","csv","pptx","odp"],
"archive": ["zip","tar.gz","tar.bz2","tar.xz","tar","7z"]
}
GET /api/key/info
Sjekk gjeldende kvotestatus for din API-nøkkel.
JSON
{
"plan": "basis",
"plan_name": "Basis",
"calls_today": 47,
"calls_month": 1243,
"limit_day": 500,
"limit_month": 10000,
"max_file_mb": 2000,
"priority": "high"
}
Feilkoder
| Kode | Betydning |
|---|---|
400 | Ugyldig forespørsel (manglende felt, ugyldig format) |
401 | Ugyldig eller manglende API-nøkkel |
413 | Filen overskrider planens filstørrelsesgrense |
429 | Kvote overskredet — daglig eller månedlig grense nådd |
503 | Mikrotjeneste ikke tilgjengelig (sjekk at den kjører) |
Python-eksempel
Python
import requests, time
API_KEY = "kv_demo_lett_7ebe909fc78c"
BASE = "/priser/api/v1"
HEADERS = {"X-API-Key": API_KEY}
# 1. Last opp og start konvertering
with open("video.mp4", "rb") as f:
resp = requests.post(
f"{BASE}/convert",
headers=HEADERS,
files={"file": f},
data={"output_format": "mp3", "quality": "high"}
)
job = resp.json()
port = job["service_port"]
jid = job["job_id"]
print(f"Jobb startet: {jid}")
# 2. Poll til ferdig
while True:
s = requests.get(f"{BASE}/status/{port}/{jid}", headers=HEADERS).json()
print(f" {s['progress']}% — {s['message']}")
if s["status"] == "done":
break
if s["status"] == "error":
raise Exception(s["message"])
time.sleep(1.5)
# 3. Last ned
r = requests.get(f"{BASE}/download/{port}/{jid}", headers=HEADERS)
with open("output.mp3", "wb") as f:
f.write(r.content)
print("✅ Lagret som output.mp3")
Rate limits
| Grense | Verdi | Per |
|---|---|---|
| Opplastinger | 5 | minutt per IP |
| Status-polling | 60 | minutt per IP |
| Alle forespørsler | 120 | minutt per IP |
Ved overskridelse returneres HTTP 429 med retry_after i sekunder.
Planer og API-kvoter
| Plan | Pris/mnd | API-kall/mnd | Maks fil | Prioritet |
|---|---|---|---|---|
| Lett | 79 kr | 1000 | 500 MB | Normal |
| Basis | 189 kr | 10000 | 2000 MB | Hoy |
| Ubegrenset | 390 kr | ∞ | ∞ | Hoyest |
| Enterprise | Kontakt kr | ∞ | ∞ | Dedikert |
API-planer for utviklere
Dedikerte planer for deg som bygger pa Konvertio API. Store volum? Kontakt oss.
API Start
299 kr/mnd
1000 API-kall/mnd
- ✓ 1 000 API-kall/mnd
- ✓ Alle formater
- ✓ REST API
- ✓ E-poststotte
- ✓ Filer slettes automatisk
Populaer
API Pro
990 kr/mnd
10000 API-kall/mnd
- ✓ 10 000 API-kall/mnd
- ✓ Prioritert ko
- ✓ Alle formater
- ✓ Prioritert stotte
- ✓ 99,5% oppetid (mal)
Pro
API Scale
2490 kr/mnd
30000 API-kall/mnd
- ✓ 30 000 API-kall/mnd
- ✓ Hoyeste prioritet
- ✓ Alle formater
- ✓ Rask stotte
- ✓ 99,5% oppetid (mal)
API Enterprise
Kontakt oss
Ubegrenset API-kall/mnd
- ✓ Ubegrenset volum
- ✓ Dedikert server
- ✓ SLA-avtale
- ✓ Dedikert kontakt
- ✓ Faktura-betaling