SJinn
Kling 3.0 Text-to-Video

Kling 3.0 Text-to-Video

Generate high-quality videos from text descriptions using Kling 3.0 model with Standard and Pro modes

Tool Overview

The Kling 3.0 Text-to-Video tool generates high-quality video content from text descriptions using Kuaishou's Kling 3.0 model. It supports flexible video duration (3-15 seconds), multiple aspect ratios, multi-shot mode, and two quality tiers (Standard / Pro).

Tool Identifier

kling3-text-to-video-api

Parameters

Required Parameters

prompt

  • Type: string (required)
  • Description: Text description of the video content to guide AI video generation
  • Validation: Must be a non-empty string
  • Example: "A cinematic aerial shot of a futuristic city at night with neon lights reflecting on wet streets"

Optional Parameters

duration

  • Type: number (optional)
  • Default: 5
  • Range: 3 - 15 (seconds)
  • Note: Values below 3 are clamped to 3, values above 15 are clamped to 15. String values are automatically parsed to numbers

aspect_ratio

  • Type: string (optional)
  • Default: "16:9"
  • Supported Values:
    • "16:9" - Landscape format, suitable for YouTube, TV, and other platforms
    • "9:16" - Portrait format, suitable for TikTok, Instagram Story, and other platforms
    • "1:1" - Square format, suitable for Instagram posts
  • Note: If an invalid value is provided, it will automatically default to "16:9"

multi_shot

  • Type: boolean (optional)
  • Default: true
  • Description: Enable multi-shot mode for more dynamic video composition with automatic scene transitions

model_mode

  • Type: string (optional)
  • Default: "standard"
  • Supported Values:
    • "standard" - Standard quality, 200 credits/second
    • "pro" - Enhanced quality with finer detail, 300 credits/second

Pricing

  • Standard Mode: 200 credits per second (duration × 200)
  • Pro Mode: 300 credits per second (duration × 300)
  • Examples:
    • 5s Standard = 1,000 credits | 5s Pro = 1,500 credits
    • 10s Standard = 2,000 credits | 10s Pro = 3,000 credits
    • 15s Standard = 3,000 credits | 15s Pro = 4,500 credits

Request Examples

Standard Mode (5 seconds)

curl -X POST https://sjinn.ai/api/un-api/create_tool_task \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool_type": "kling3-text-to-video-api",
    "input": {
      "prompt": "A cinematic aerial shot of a futuristic city at night with neon lights reflecting on wet streets",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

Pro Mode (10 seconds, Portrait)

curl -X POST https://sjinn.ai/api/un-api/create_tool_task \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool_type": "kling3-text-to-video-api",
    "input": {
      "prompt": "A fashion model walking confidently through a garden with cherry blossoms falling",
      "duration": 10,
      "aspect_ratio": "9:16",
      "model_mode": "pro"
    }
  }'

Using JavaScript

const response = await fetch('https://sjinn.ai/api/un-api/create_tool_task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool_type: 'kling3-text-to-video-api',
    input: {
      prompt: 'A cinematic aerial shot of a futuristic city at night',
      duration: 5,
      aspect_ratio: '16:9',
      model_mode: 'standard',
    },
  }),
});

const result = await response.json();
console.log('Task ID:', result.data.task_id);

Using Python

import requests

url = 'https://sjinn.ai/api/un-api/create_tool_task'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}
data = {
    'tool_type': 'kling3-text-to-video-api',
    'input': {
        'prompt': 'A cinematic aerial shot of a futuristic city at night',
        'duration': 5,
        'aspect_ratio': '16:9',
        'model_mode': 'standard'
    }
}

response = requests.post(url, json=data, headers=headers)
result = response.json()
print('Task ID:', result['data']['task_id'])

Response Examples

Success Response

{
  "success": true,
  "errorMsg": "",
  "error_code": 0,
  "data": {
    "task_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Error Response

{
  "success": false,
  "errorMsg": "Insufficient balance",
  "error_code": 100
}

Best Practices

  1. Mode Selection: Use standard mode for prototyping and iteration, switch to pro for final output when quality matters
  2. Duration Selection: Start with shorter durations (3-5s) for testing, then increase for final output. Cost scales linearly with duration
  3. Prompt Optimization: Use detailed, specific descriptions including camera movement, lighting, and style details for best results
  4. Multi-Shot: Keep multi_shot enabled (default) for more cinematic compositions. Disable it only if you need a single continuous shot
  5. Aspect Ratio Selection:
    • Use 16:9 for landscape platforms like YouTube and Bilibili
    • Use 9:16 for portrait platforms like TikTok and Instagram Story
    • Use 1:1 for square formats like Instagram posts
  6. Generation Time: Video generation typically takes 2-8 minutes depending on duration and mode

Related Links