Skip to main content

Job Create

  • Initiate a new deepfake analysis job for a file that has been previously uploaded. When you create a job, the system queues the file for processing with the specified AI models.
POST /v1/job/create

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 ID of the file to be analyzed and optional parameters for customization.
ParameterTypeDescriptionRequired
file_idstringThe unique identifier of the uploaded file.Yes
modestringProcessing mode: "fast", "normal", "high", "full"No
titlestringA descriptive title for the job (kept for compatibility)No
modelsstring | array | nullAI models to use. Accepts an array (["facia", "diffusion"]), a single string ("facia"), 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 runNo
profile_namestringA scoring profile configured for your organization, e.g. "strict" (latest version) or "strict@2" (pinned version). See Scoring profiles.No
{
  "file_id": "dfc7abfe-c163-48e1-9818-390bc0c55854",
  "title": "Elon Musk Deepfake",
  "models": ["facia", "diffusion", "swintf", "audio"],
  "mode": "fast"
}

Scoring profiles (optional)​

Every job is scored with your organization's configured scoring setup. Passing profile_name scores a single job with a named scoring profile instead (profiles bundle a complete scoring configuration and are managed by the deepfaic team — contact us to define one for your organization).

  • "strict" selects the newest version of that profile; "strict@2" pins version 2.
  • The profile is locked into the job at creation: later changes to the profile never alter this job's results.
  • An unknown profile name or version is rejected with 422 and no job is created.
{
  "file_id": "dfc7abfe-c163-48e1-9818-390bc0c55854",
  "profile_name": "strict@2"
}

Response​

{
  "status": true,
  "code": 200,
  "message": "Job created successfully",
  "data": {
    "job_id": 222
  }
}

Example Request​

curl -X POST https://api.deepfaic.com/v1/job/create \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{"file_id": "dfc7abfe-c163-48e1-9818-390bc0c55854"}'