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/convert
3
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

ParameterTypePåkrevdBeskrivelse
fileFileFilen som skal konverteres (multipart/form-data)
output_formatstringUtdataformat, f.eks. mp4, pdf, mp3
qualitystringhigh / 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

KodeBetydning
400Ugyldig forespørsel (manglende felt, ugyldig format)
401Ugyldig eller manglende API-nøkkel
413Filen overskrider planens filstørrelsesgrense
429Kvote overskredet — daglig eller månedlig grense nådd
503Mikrotjeneste 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

GrenseVerdiPer
Opplastinger5minutt per IP
Status-polling60minutt per IP
Alle forespørsler120minutt per IP

Ved overskridelse returneres HTTP 429 med retry_after i sekunder.

Planer og API-kvoter

PlanPris/mndAPI-kall/mndMaks filPrioritet
Lett 79 kr 1000 500 MB Normal
Basis 189 kr 10000 2000 MB Hoy
Ubegrenset 390 kr Hoyest
Enterprise Kontakt kr Dedikert
Se alle planer og oppgrader →

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
Kontakt oss