curl --request POST \
--url https://backend.identifai.net/api/classification_video \
--header 'Content-Type: multipart/form-data' \
--header 'X-Api-Key: <api-key>' \
--form 'video=@example-file;type=video/*' \
--form 'ref_id=<string>' \
--form key_frames=true \
--form with_tampering=true \
--form with_morphing=true \
--form with_audio=true \
--form with_smart_analysis=true \
--form 'webhook_url=<string>' \
--form with_xai=true \
--form with_llm_xai=true \
--form 'deferred_webhook_url=<string>' \
--form no_cache=true \
--form prevent_c2pa_forces=true \
--form with_nsfw=true \
--form ensure_face_per_frame=true \
--form 'frames_timestamps=00:00:05.000,00:01:12.500' \
--form 'audio_timestamps=00:00:05.000,00:01:12.500'import requests
url = "https://backend.identifai.net/api/classification_video"
files = { "video": ("example-file", open("example-file", "rb"), "video/*") }
payload = {
"ref_id": "<string>",
"key_frames": "true",
"with_tampering": "true",
"with_morphing": "true",
"with_audio": "true",
"with_smart_analysis": "true",
"webhook_url": "<string>",
"with_xai": "true",
"with_llm_xai": "true",
"deferred_webhook_url": "<string>",
"no_cache": "true",
"prevent_c2pa_forces": "true",
"with_nsfw": "true",
"ensure_face_per_frame": "true",
"frames_timestamps": "00:00:05.000,00:01:12.500",
"audio_timestamps": "00:00:05.000,00:01:12.500"
}
headers = {"X-Api-Key": "<api-key>"}
response = requests.post(url, data=payload, files=files, headers=headers)
print(response.text)const form = new FormData();
form.append('video', '<string>');
form.append('ref_id', '<string>');
form.append('key_frames', 'true');
form.append('with_tampering', 'true');
form.append('with_morphing', 'true');
form.append('with_audio', 'true');
form.append('with_smart_analysis', 'true');
form.append('webhook_url', '<string>');
form.append('with_xai', 'true');
form.append('with_llm_xai', 'true');
form.append('deferred_webhook_url', '<string>');
form.append('no_cache', 'true');
form.append('prevent_c2pa_forces', 'true');
form.append('with_nsfw', 'true');
form.append('ensure_face_per_frame', 'true');
form.append('frames_timestamps', '00:00:05.000,00:01:12.500');
form.append('audio_timestamps', '00:00:05.000,00:01:12.500');
const options = {method: 'POST', headers: {'X-Api-Key': '<api-key>'}};
options.body = form;
fetch('https://backend.identifai.net/api/classification_video', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://backend.identifai.net/api/classification_video",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"video\"; filename=\"example-file\"\r\nContent-Type: video/*\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ref_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"key_frames\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_tampering\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_morphing\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_audio\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_smart_analysis\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_xai\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_llm_xai\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"deferred_webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"no_cache\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prevent_c2pa_forces\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_nsfw\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ensure_face_per_frame\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"frames_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001--",
CURLOPT_HTTPHEADER => [
"Content-Type: multipart/form-data",
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://backend.identifai.net/api/classification_video"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"video\"; filename=\"example-file\"\r\nContent-Type: video/*\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ref_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"key_frames\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_tampering\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_morphing\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_audio\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_smart_analysis\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_xai\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_llm_xai\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"deferred_webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"no_cache\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prevent_c2pa_forces\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_nsfw\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ensure_face_per_frame\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"frames_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001--")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://backend.identifai.net/api/classification_video")
.header("X-Api-Key", "<api-key>")
.body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"video\"; filename=\"example-file\"\r\nContent-Type: video/*\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ref_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"key_frames\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_tampering\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_morphing\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_audio\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_smart_analysis\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_xai\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_llm_xai\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"deferred_webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"no_cache\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prevent_c2pa_forces\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_nsfw\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ensure_face_per_frame\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"frames_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001--")
.asString();require 'uri'
require 'net/http'
url = URI("https://backend.identifai.net/api/classification_video")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<api-key>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"video\"; filename=\"example-file\"\r\nContent-Type: video/*\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ref_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"key_frames\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_tampering\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_morphing\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_audio\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_smart_analysis\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_xai\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_llm_xai\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"deferred_webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"no_cache\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prevent_c2pa_forces\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_nsfw\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ensure_face_per_frame\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"frames_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001--"
response = http.request(request)
puts response.read_body{
"identifier": "8d64370a87b820cc1cf620338f5c898bab37439c9a405f32d9eaffc50c4f27b0"
}Clasifica un vídeo
Envía un vídeo para su clasificación
🔁 El formato de la respuesta depende del header Accept:
Accept: application/json → { "identifier": "..." }
Otros valores (p. ej., text/plain) → texto plano con solo la cadena del identificador.
curl --request POST \
--url https://backend.identifai.net/api/classification_video \
--header 'Content-Type: multipart/form-data' \
--header 'X-Api-Key: <api-key>' \
--form 'video=@example-file;type=video/*' \
--form 'ref_id=<string>' \
--form key_frames=true \
--form with_tampering=true \
--form with_morphing=true \
--form with_audio=true \
--form with_smart_analysis=true \
--form 'webhook_url=<string>' \
--form with_xai=true \
--form with_llm_xai=true \
--form 'deferred_webhook_url=<string>' \
--form no_cache=true \
--form prevent_c2pa_forces=true \
--form with_nsfw=true \
--form ensure_face_per_frame=true \
--form 'frames_timestamps=00:00:05.000,00:01:12.500' \
--form 'audio_timestamps=00:00:05.000,00:01:12.500'import requests
url = "https://backend.identifai.net/api/classification_video"
files = { "video": ("example-file", open("example-file", "rb"), "video/*") }
payload = {
"ref_id": "<string>",
"key_frames": "true",
"with_tampering": "true",
"with_morphing": "true",
"with_audio": "true",
"with_smart_analysis": "true",
"webhook_url": "<string>",
"with_xai": "true",
"with_llm_xai": "true",
"deferred_webhook_url": "<string>",
"no_cache": "true",
"prevent_c2pa_forces": "true",
"with_nsfw": "true",
"ensure_face_per_frame": "true",
"frames_timestamps": "00:00:05.000,00:01:12.500",
"audio_timestamps": "00:00:05.000,00:01:12.500"
}
headers = {"X-Api-Key": "<api-key>"}
response = requests.post(url, data=payload, files=files, headers=headers)
print(response.text)const form = new FormData();
form.append('video', '<string>');
form.append('ref_id', '<string>');
form.append('key_frames', 'true');
form.append('with_tampering', 'true');
form.append('with_morphing', 'true');
form.append('with_audio', 'true');
form.append('with_smart_analysis', 'true');
form.append('webhook_url', '<string>');
form.append('with_xai', 'true');
form.append('with_llm_xai', 'true');
form.append('deferred_webhook_url', '<string>');
form.append('no_cache', 'true');
form.append('prevent_c2pa_forces', 'true');
form.append('with_nsfw', 'true');
form.append('ensure_face_per_frame', 'true');
form.append('frames_timestamps', '00:00:05.000,00:01:12.500');
form.append('audio_timestamps', '00:00:05.000,00:01:12.500');
const options = {method: 'POST', headers: {'X-Api-Key': '<api-key>'}};
options.body = form;
fetch('https://backend.identifai.net/api/classification_video', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://backend.identifai.net/api/classification_video",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"video\"; filename=\"example-file\"\r\nContent-Type: video/*\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ref_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"key_frames\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_tampering\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_morphing\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_audio\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_smart_analysis\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_xai\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_llm_xai\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"deferred_webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"no_cache\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prevent_c2pa_forces\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_nsfw\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ensure_face_per_frame\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"frames_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001--",
CURLOPT_HTTPHEADER => [
"Content-Type: multipart/form-data",
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://backend.identifai.net/api/classification_video"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"video\"; filename=\"example-file\"\r\nContent-Type: video/*\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ref_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"key_frames\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_tampering\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_morphing\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_audio\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_smart_analysis\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_xai\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_llm_xai\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"deferred_webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"no_cache\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prevent_c2pa_forces\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_nsfw\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ensure_face_per_frame\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"frames_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001--")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://backend.identifai.net/api/classification_video")
.header("X-Api-Key", "<api-key>")
.body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"video\"; filename=\"example-file\"\r\nContent-Type: video/*\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ref_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"key_frames\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_tampering\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_morphing\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_audio\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_smart_analysis\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_xai\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_llm_xai\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"deferred_webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"no_cache\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prevent_c2pa_forces\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_nsfw\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ensure_face_per_frame\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"frames_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001--")
.asString();require 'uri'
require 'net/http'
url = URI("https://backend.identifai.net/api/classification_video")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<api-key>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"video\"; filename=\"example-file\"\r\nContent-Type: video/*\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ref_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"key_frames\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_tampering\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_morphing\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_audio\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_smart_analysis\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_xai\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_llm_xai\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"deferred_webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"no_cache\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prevent_c2pa_forces\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"with_nsfw\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ensure_face_per_frame\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"frames_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001--"
response = http.request(request)
puts response.read_body{
"identifier": "8d64370a87b820cc1cf620338f5c898bab37439c9a405f32d9eaffc50c4f27b0"
}Encabezados
Cuerpo
Algoritmo de identificación de keyframes. Los valores posibles son iframes (predeterminado), flow y color.
iframes: extrae los iframes del vídeo;color: devuelve el frame medio, según el color, de cada secuencia de plano. Las secuencias de plano son grupos de frames que empiezan con un iframe;flow: devuelve el frame más estático respecto al frame anterior de cada secuencia de plano.
iframes, flow, color Establécelo en true para activar la Smart Full Analysis en cada frame analizado: un algoritmo de scoring propietario selecciona las áreas más informativas del frame, que se clasifican como recortes separados con el modelo más avanzado de la familia Revelio y luego se combinan en un veredicto global. Al ser una versión avanzada e inteligente de ambos, sustituye al análisis completo estándar y al análisis con heatmap de los frames. Para usarla debe estar habilitada en tu plan de precios; si no, el parámetro se ignora. Consulta Smart Full Analysis para más detalles.
Si se indica, el resultado de la clasificación también se envía automáticamente a la URL introducida. Si no, el resultado se obtiene mediante polling del endpoint correspondiente. Ten en cuenta que para usar una URL de callback del webhook debes solicitar una habilitación específica; si no, el parámetro se ignora. Además, el sistema puede guardar en caché los resultados de los análisis de envíos repetidos, es decir, envíos del mismo archivo con las mismas opciones: en este caso no se llama al webhook y los resultados solo están accesibles mediante polling del endpoint correspondiente.
Establécelo en true para activar el scope XAI – eXplainable AI: además del veredicto, los modelos Revelio devuelven información sobre las áreas de cada frame analizado en las que se centraron durante la clasificación (attention map y attention graph). XAI se aplica a cada frame analizado. Para usarlo debe estar habilitado en tu plan de precios; si no, el parámetro se ignora. Consulta XAI – eXplainable AI para más detalles. Aviso sobre la transferencia de datos: al activar esta funcionalidad, los datos de tus imágenes se transfieren a nuestra infraestructura cloud en la UE para la inferencia de los modelos.
Establécelo en true, junto con with_xai, para obtener también las explicaciones impulsadas por IA: una descripción en lenguaje natural de las regiones que recibieron más atención, devuelta en el campo description de las explanations de los resultados por modelo cuando los resultados diferidos están listos. Las explicaciones se generan para cada frame analizado. Se ignora si with_xai no está activado. Si XAI está incluido en tu plan de precios pero las explicaciones impulsadas por IA no, una solicitud con with_llm_xai=true se rechaza con un error 403. Los créditos de las explicaciones que no se pueden generar se reembolsan. Las explicaciones impulsadas por IA se generan con modelos no desarrollados por identifAI.
Idioma de las explicaciones impulsadas por IA (sin distinguir entre mayúsculas y minúsculas). Si se omite, se usa el idioma predeterminado de tu plan de precios. Solo se aplica junto con with_llm_xai; un valor no admitido se rechaza con un error 400.
english, italian, spanish, german Si se indica, la URL se notifica una sola vez cuando los resultados diferidos del envío están completos (p. ej., las explicaciones textuales de los mapas XAI y de la heatmap), después de los resultados principales enviados a webhook_url. La notificación lleva el evento submission.deferred.completed: consulta Resultados diferidos para ver el payload. Se aplican la misma habilitación, las mismas restricciones de dominio y la misma autenticación que en webhook_url. La entrega es at least once: deduplica por identifier, y ten en cuenta que una notificación expired puede ir seguida de una segunda con el resultado real, que la sustituye. Si se omite o está vacía, no se envía ninguna notificación de resultados diferidos.
[Funcionalidad del plan] Establécelo en true para elegir la estrategia de extracción de frames con caras: a partir del muestreo a intervalos regulares, el sistema busca en el vídeo frames que contengan al menos una cara, hasta el número de frames que hay que analizar (frames). Úsalo junto con la opción with_morphing para detectar posibles face swaps o morphing en el vídeo. Es una alternativa a las demás estrategias: cuando está activado, key_frames y key_frames_method se ignoran, mientras que él mismo se ignora cuando se indica frames_timestamps. La búsqueda tiene un límite de tiempo, así que en los vídeos en los que las caras son escasas o no aparecen es posible que se analicen menos frames: los frames no analizados se reembolsan al terminar el análisis. Esta opción puede aumentar el tiempo de procesamiento y, según tu plan de precios, el coste de cada frame. Para usar esta opción debe estar habilitada en tu plan de precios; si no, el parámetro se ignora.
[Funcionalidad del plan] Momentos específicos del vídeo que se van a analizar. Lista de timecodes separados por comas en formato HH:MM:SS.mmm, medidos desde el inicio del archivo (p. ej., 00:00:05.000,00:01:12.500). Cuando se indica, se extrae exactamente un frame en cada momento indicado y las demás estrategias de extracción de frames se desactivan: frames, key_frames, key_frames_method y ensure_face_per_frame se ignoran. Los momentos duplicados se cuentan una sola vez. Puedes indicar hasta 30 momentos si tu plan de precios te permite elegir el número de frames; si no, hasta el número de frames predeterminado (10). Se cobra un frame por cada momento distinto. Los momentos posteriores al final del vídeo se omiten: si ninguno cae dentro del vídeo, la clasificación termina con un error. Para usar esta opción debe estar habilitada en tu plan de precios; si no, el parámetro se ignora.
"00:00:05.000,00:01:12.500"
[Funcionalidad del plan] Momentos específicos de la pista de audio del vídeo que se van a analizar. Lista de timecodes separados por comas en formato HH:MM:SS.mmm, medidos desde el inicio del archivo (p. ej., 00:00:05.000,00:01:12.500). Solo se usa junto con with_audio. Cuando se indica, en lugar de dividir el audio en segmentos a lo largo de toda su duración, el sistema analiza un breve segmento de audio centrado en cada momento indicado; los momentos lo bastante cercanos como para caer en el mismo segmento se analizan juntos en un único segmento. Los momentos duplicados se cuentan una sola vez. Puedes indicar hasta 30 momentos si tu plan de precios te permite elegir el número de segmentos de audio; si no, hasta 5. Se cobra un segmento de audio por cada momento distinto: los segmentos que no se generan (momentos agrupados, momentos posteriores al final del audio) se reembolsan al terminar el análisis. Si ningún momento cae dentro del audio, la clasificación termina con un error. Para usar esta opción debe estar habilitada en tu plan de precios; si no, el parámetro se ignora.
"00:00:05.000,00:01:12.500"