Create Task

Upload video and audio to create lip-sync video tasks

Create Lip Sync Task API

Endpoint

POST /api/open/lip-sync/create

Request Headers

Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN  // API key

Request Parameters

{
  "video_url": string,          // Required, publicly accessible video URL
  "audio_url": string           // Required, publicly accessible audio URL
}

Response Data

// Success response - 200
{
  "success": true,
  "message": "Task created successfully",
  "data": {
    "id": string,               // Task ID
    "status": string,           // Task status: "pending" | "processing"
    "created_at": string,       // Created time
    "credits_used": number,     // Credits consumed
    "remaining_credits": number // Remaining credits
  }
}

// Error response
{
  "error": string               // Error message
}

CURL Example

curl -X POST https://kittaai.com/api/open/lip-sync/create \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "video_url": "https://example.com/video.mp4",
    "audio_url": "https://example.com/audio.mp3"
  }'

Online Debug

Status Code Description

Status Code Description:
200 OK                  - Request successful
400 Bad Request         - Invalid request parameters
401 Unauthorized        - Invalid API Token
403 Forbidden          - Access forbidden
404 Not Found          - Resource not found
413 Payload Too Large  - Upload file too large
429 Too Many Requests  - Rate limit exceeded/Insufficient credits
500 Server Error       - Internal server error

Error Response Format:
{
  "error": string,      // Error message
  "details": string,    // Detailed error message (optional)
  "code": string       // Error code (optional)
}