Importuoti YouTube vaizdo įrašą

Reikalingas leidimas

library:write

Autentifikacija

Authorization: Bearer

Ribų politika

writeimportsaccount

Užklausa niekada nelaukia transkribavimo pabaigos. Tikrinkite GET /library/imports/{import_id} (arba prenumeruokite įvykius library.import.*), kol status taps succeeded, failed arba canceled.

* Jei vaizdo įrašas jau yra jūsų bibliotekoje arba Diko jį jau transkribavo, atsakymas yra 201 su reused: true, o kreditai nenaudojami. Tai vis tiek importas: jis įskaitomas į paros ribą. * Jei to paties vaizdo įrašo importas dar vyksta, atsakymas yra 200 su tuo importu. * Kitu atveju atsakymas yra 201 su antrašte Location. Kreditai tikrinami dabar ir dar kartą prieš mokamą darbą. Jei eilėje per daug importų arba pasiekta paros riba, atsakymas yra 429 queue_limit_exceeded (error.details.limit nurodo, kuri riba). * Vaizdo įrašas be subtitrų transkribuojamas kalbos atpažinimu bendroje Diko eilėje. Tie darbai naudoja tas pačias naudotojo transkribavimo vietas kaip jūsų įkėlimai programėlėje, bet niekada nepaima paskutinės laisvos vietos. Ji lieka jūsų įkėlimams ir įrašams. Darbas gali laukti laisvos vietos; tuo metu importas lieka queued arba processing. * Atšaukus, išjungus ar ištrynus API raktą, kuris sukūrė importą, rotavus jį be persidengimo arba atšaukus raktą dėl nutekėjimo, to rakto importai, kurie dar eilėje ar vykdomi, atšaukiami. Sustabdžius API prieigą, taip pat atšaukiami visos paskyros importai. Importas eilėje iškart tampa canceled, vykdomas tampa canceling ir sustojus darbui baigiasi kaip canceled (įvykis library.import.canceled). Rotacija su persidengimu importų nesustabdo. Jau atliktas darbas apmokestinamas kaip įprasta.

Siųskite antraštę Idempotency-Key, kad pakartojimas būtų saugus.

Parametrai

Užklausos turinys

Importuotinas vaizdo įrašas.

Turinio tipas: application/json

• urlstringprivalomas

  YouTube vaizdo įrašo nuoroda (youtube.com, www.youtube.com, m.youtube.com, music.youtube.com arba youtu.be).

  1–2048 simbolių

• languagestring | null

  Užuomina subtitrų kalbai ir kalbos atpažinimui. Praleiskite, kad būtų naudojama jūsų numatytoji Diko kalba.

  Galimos reikšmės: lten

Atsakymas

Pavyzdžiai

Užklausa

curl -X POST "https://api.diko.app/api/v1/library/imports" \
  -H "Authorization: Bearer $DIKO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","language":"lt"}'

import os
import uuid

import requests

response = requests.post(
    "https://api.diko.app/api/v1/library/imports",
    headers={
        "Authorization": f"Bearer {os.environ['DIKO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),  # create once per operation, reuse on retries
    },
    json={
        "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "language": "lt",
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.diko.app/api/v1/library/imports", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.DIKO_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(), // create once per operation, reuse on retries
  },
  body: JSON.stringify({
    url: "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    language: "lt",
  }),
})
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`)
console.log(await response.json())

Atsakymo pavyzdys · 201 · application/json

{
  "id": "imp_6Mfj7Oxm4MfxGGmZRhiUQf",
  "object": "library_import",
  "status": "queued",
  "stage": null,
  "queue_position": 1,
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "youtube_video_id": "dQw4w9WgXcQ",
  "language": "lt",
  "reused": false,
  "transcript_id": null,
  "error": null,
  "created_at": "2026-10-11T09:30:00.000Z",
  "updated_at": "2026-10-11T09:30:00.100Z",
  "completed_at": null
}

Atsakymo pavyzdys · 200 · application/json

{
  "id": "imp_6Mfj7Oxm4MfxGGmZRhiUQf",
  "object": "library_import",
  "status": "queued",
  "stage": null,
  "queue_position": 1,
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "youtube_video_id": "dQw4w9WgXcQ",
  "language": "lt",
  "reused": false,
  "transcript_id": null,
  "error": null,
  "created_at": "2026-10-11T09:30:00.000Z",
  "updated_at": "2026-10-11T09:30:00.100Z",
  "completed_at": null
}

Klaidos

Šis endpointas gali grąžinti šias klaidas. Visų kodų aprašai yra klaidų kataloge.