REST-API

ClipToks-API für Entwickler

Automatisieren Sie die Videoerstellung aus Ihren eigenen Apps, Skripten oder N8N-Streams mit einer einfachen REST-API.

Basis-URL: https://cliptoks.com/api/v1

lock Authentifizierung

Fügen Sie Ihr Passwort in den Autorisierungsheader jeder Anfrage ein:

Authorization: Bearer tk_TU_CLAVE

Sie können auch den Header verwenden X-API-Key: tk_TU_CLAVE

api Endpunkte

Verfahren	Endpoint	Beschreibung
GET	`/me`	Ihre Kontodaten und verbleibenden Minuten.
GET	`/voices`	Liste der verfügbaren Stimmen (einschließlich geklonter Stimmen).
POST	`/generate`	Erstellen Sie ein Video oder Audio. Es kostet Minuten.
GET	`/jobs/{id}`	Status eines Jobs und dessen Ergebnis.
GET	`/assets`	Listen Sie Ihre Bibliothek generierter Dateien auf.
GET	`/assets/{id}/download`	Laden Sie eine Ressourcendatei herunter.
DELETE	`/assets/{id}`	Löschen Sie eine Ressource aus Ihrer Bibliothek.

terminal Erstelle ein Video

Stellen Sie einen Job in die Warteschlange. Die Antwort gibt eine job_id zurück, die Sie abfragen können, bis sie fertig ist.

curl -X POST https://cliptoks.com/api/v1/generate \
  -H "Authorization: Bearer tk_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{"tool":"idea2video","params":{"idea":"5 curiosidades sobre el espacio","lang":"es"}}'

import requests

r = requests.post(
    "https://cliptoks.com/api/v1/generate",
    headers={"Authorization": "Bearer tk_TU_CLAVE"},
    json={"tool": "idea2video",
          "params": {"idea": "5 curiosidades sobre el espacio", "lang": "es"}},
)
print(r.json())  # {'job_id': 123, 'status': 'queued'}

const res = await fetch("https://cliptoks.com/api/v1/generate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer tk_TU_CLAVE",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    tool: "idea2video",
    params: { idea: "5 curiosidades sobre el espacio", lang: "es" },
  }),
});
console.log(await res.json());

<?php
$ch = curl_init("https://cliptoks.com/api/v1/generate");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer tk_TU_CLAVE",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "tool"   => "idea2video",
        "params" => ["idea" => "5 curiosidades sobre el espacio", "lang" => "es"],
    ]),
]);
echo curl_exec($ch);

var client = java.net.http.HttpClient.newHttpClient();
var req = java.net.http.HttpRequest.newBuilder()
    .uri(java.net.URI.create("https://cliptoks.com/api/v1/generate"))
    .header("Authorization", "Bearer tk_TU_CLAVE")
    .header("Content-Type", "application/json")
    .POST(java.net.http.HttpRequest.BodyPublishers.ofString(
        "{\"tool\":\"idea2video\",\"params\":{\"idea\":\"...\"}}"))
    .build();
var res = client.send(req, java.net.http.HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

Verwenden Sie einen „HTTP Request“-Knoten mit dieser Konfiguration:

Método:   POST
URL:      https://cliptoks.com/api/v1/generate
Headers:
  Authorization = Bearer tk_TU_CLAVE
  Content-Type  = application/json
Body (JSON):
  {"tool":"idea2video","params":{"idea":"5 curiosidades sobre el espacio","lang":"es"}}

downloading Konsultieren Sie das Werk und laden Sie es herunter

Fragt die job_id ab, bis der Status „erledigt“ ist. Dann haben Sie die Download-URL.

curl https://cliptoks.com/api/v1/jobs/123 -H "Authorization: Bearer tk_TU_CLAVE"

# Antwort nach Abschluss:
{
  "job_id": 123,
  "tool": "idea2video",
  "status": "done",
  "progress": 100,
  "asset": {
    "id": 987,
    "type": "video",
    "duration": 42.5,
    "download_url": "https://cliptoks.com/api/v1/assets/987/download"
  }
}

error_outline Fehlercodes

Code	Bedeutung
`401`	Fehlender oder ungültiger API-Schlüssel.
`402`	Keine Minuten verfügbar. Verbessern Sie Ihren Plan.
`403`	Ihr Plan beinhaltet keinen Zugriff auf die API.
`422`	Parameter fehlen oder sind falsch.
`429`	Sie haben das Limit für Anfragen pro Minute überschritten.

Sind Sie bereit, Ihre Videos zu automatisieren?

Erstellen Sie ein kostenloses Konto