Job Create URL

• Create a deepfake analysis job directly from a video URL. Supports YouTube, Twitter/X, Dailymotion, Vimeo, and Instagram URLs.

POST /v1/job/create_via_url

Auth and Rate Limits

• Authentication is required for this endpoint. You must include a valid API key in the Authorization header.
• This API call is rate limited to 100 requests per minute.

---

Request Body

• The body of the request must be a JSON object containing the video URL and optional parameters for time window and analysis customization.

Parameter	Type	Description	Required
url	string	The video URL from a supported platform (see below)	Yes
start_time	integer	Start time in seconds for video analysis window	No
end_time	integer	End time in seconds for video analysis window	No
title	string	A descriptive title for the job (kept for compatibility)	No
models	string | array | null	AI models to use. Accepts an array, a single string, or null/omitted to use every model compatible with the file type (for video: ["facia", "diffusion", "swintf", "audio", "dfaudio"]); your organization's enabled-model configuration decides which of them actually run	No
mode	string	Processing mode: "fast", "normal", "high", "full"	No
profile_name	string	A scoring profile configured for your organization, e.g. "strict" (latest version) or "strict@2" (pinned version) — same behavior as on Job Create.	No

{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "start_time": 10,
  "end_time": 60,
  "title": "YouTube Video Analysis",
  "models": ["facia", "diffusion", "swintf", "audio"],
  "mode": "fast"
}

---

Supported Platforms

Platform	Accepted URL domains
YouTube	youtube.com, youtu.be
Twitter/X	twitter.com, x.com
Dailymotion	dailymotion.com, dai.ly
Vimeo	vimeo.com
Instagram	instagram.com/reel, instagram.com/reels

---

Time Window

• If both start_time and end_time are 0 or omitted, the system processes the first 10 minutes (600 seconds) of the video, or the entire video if shorter.
• If a custom range is provided:
  • end_time must be greater than start_time.
  • Maximum allowed duration is 10 minutes (600 seconds).
  • Exceeding this returns: "Maximum allowed duration is 10 minutes (600 seconds)".

---

Response

{
  "status": true,
  "code": 200,
  "message": "Job created successfully from YouTube URL",
  "data": {
    "job_id": 223
  }
}

Example Request

curl -X POST https://api.deepfaic.com/v1/job/create_via_url \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://vimeo.com/123456789",
    "models": ["facia", "audio"],
    "start_time": 0,
    "end_time": 120
  }'