Kling Image Animation API

Transform static images into smooth videos with natural motion

تصدیق

Doitong API کے ذریعے Kling Image-to-Video API تک رسائی حاصل کرنے کے لیے، اپنی Doitong API کی (key) استعمال کریں۔ اسے GraphQL میوٹیشن یا REST API ہیڈرز میں شامل کریں۔

// GraphQL Header
{
  "Authorization": "Bearer YOUR_API_KEY"
}

// REST Header
"X-API-Key": "YOUR_API_KEY"

فوری آغاز

صرف چند منٹوں میں Kling Image-to-Video API کے ساتھ کام شروع کریں۔ اپنا پہلا image to video تیار کرنے کے لیے ان آسان مراحل پر عمل کریں۔

مرحلہ 1: اپنی API کی حاصل کریں

Doitong اکاؤنٹ کے لیے سائن اپ کریں اور API کی تیار کرنے کے لیے اپنے ڈیش بورڈ پر جائیں۔

مرحلہ 2: اپنی پہلی درخواست بھیجیں

اپنی پہلی API کال کرنے کے لیے نیچے دی گئی کوڈ کی مثالوں میں سے ایک استعمال کریں۔

curl -X POST https://api.doitong.com/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: unique-request-id-123" \
  -d '{
    "query": "mutation Generate($input: GenerateInput!) { generate(input: $input) { id status type provider url metadata creditCost } }",
    "variables": {
      "input": {
        "type": "VIDEO",
        "provider": "kling-i2v",
        "input": {
          "image": "https://example.com/your-image.jpg"
        },
        "options": {
          "duration": 5,
          "motionIntensity": "medium"
        }
      }
    }
  }'

const response = await fetch('https://api.doitong.com/graphql', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    query: `
      mutation AnimateImage($input: ImageAnimationInput!) {
        animateImage(input: $input) {
          id
          status
          url
        }
      }
    `,
    variables: {
      input: {
        service: 'kling-i2v',
        imageUrl: 'https://example.com/your-image.jpg',
        duration: 5,
        motionIntensity: 'medium'
      }
    }
  })
});

const data = await response.json();
console.log('Animated Video:', data.data.animateImage);

import requests
import json

url = "https://api.doitong.com/graphql"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

query = """
mutation Generate($input: GenerateInput!) {
  generate(input: $input) {
    id
    status
    type
    provider
    url
    metadata
    creditCost
  }
}
"""

variables = {
    "input": {
        "type": "VIDEO",
        "provider": "kling-i2v",
        "input": {
            "imageUrl": "https://example.com/your-image.jpg"
        },
        "options": {
            "duration": 5,
            "motionIntensity": "medium"
        }
    }
}

response = requests.post(url, json={
    "query": query,
    "variables": variables
}, headers=headers)

data = response.json()
print("Result:", data["data"]["generate"])

mutation Generate($input: GenerateInput!) {
  generate(input: $input) {
    id
    status
    type
    provider
    url
    metadata
    creditCost
    createdAt
  }
}

# Variables
{
  "input": {
    "type": "VIDEO",
    "provider": "kling-i2v",
    "input": {
      "imageUrl": "https://example.com/your-image.jpg"
    },
    "options": {
      "duration": 5,
      "motionIntensity": "medium",
      "version": "1.6"
    }
  }
}

قیمتیں

Kling Image-to-Video API کریڈٹ پر مبنی قیمتوں کا ماڈل استعمال کرتا ہے۔ کریڈٹس کا استعمال تیار کردہ مواد کی پیچیدگی اور دورانیے کی بنیاد پر کیا جاتا ہے۔

API اینڈ پوائنٹس

Kling Image-to-Video API ہمارے متحد GraphQL اینڈ پوائنٹ کے ذریعے دستیاب ہے۔

GraphQL اینڈ پوائنٹ

POST https://api.doitong.com/graphql

REST اینڈ پوائنٹ

POST https://api.doitong.com/v1/image_to_video

پیرامیٹرز

Kling Image-to-Video API کی درخواستوں کے لیے دستیاب پیرامیٹرز:

جواب کا فارمیٹ

تمام API جوابات ایک مستقل فارمیٹ پر عمل کرتے ہیں:

کامیاب جواب

{
  "data": {
    "imagevideo": {
      "id": "abc123xyz",
      "status": "processing",
      "url": null,
      "webhookUrl": "https://your-webhook.com/callback",
      "createdAt": "2024-01-01T00:00:00Z"
    }
  }
}

مکمل شدہ جواب

{
  "data": {
    "imagevideo": {
      "id": "abc123xyz",
      "status": "completed",
      "url": "https://cdn.doitong.com/outputs/abc123xyz.mp4",
      "duration": 5,
      "createdAt": "2024-01-01T00:00:00Z"
    }
  }
}

ایرر ہینڈلنگ

API معیاری HTTP اسٹیٹس کوڈز استعمال کرتا ہے اور تفصیلی غلطی کے پیغامات فراہم کرتا ہے۔

عام ایرر کوڈز

ایرر رسپانس فارمیٹ

{
  "errors": [
    {
      "message": "Insufficient credits for this operation",
      "extensions": {
        "code": "INSUFFICIENT_CREDITS",
        "creditsRequired": 100,
        "creditsAvailable": 50
      }
    }
  ]
}

ویب ہکس (Webhooks)

جب آپ کا image to video تیار ہو جائے تو ریئل ٹائم اطلاعات حاصل کریں۔

ویب ہکس کی سیٹنگ

Include a <code>webhookUrl</code> parameter in your request to receive a POST notification when processing is complete.

ویب ہک پے لوڈ

{
  "id": "abc123xyz",
  "status": "completed",
  "url": "https://cdn.doitong.com/outputs/abc123xyz.mp4",
  "service": "kling-i2v",
  "createdAt": "2024-01-01T00:00:00Z",
  "completedAt": "2024-01-01T00:01:00Z",
  "metadata": {
    "duration": 5,
    "width": 1920,
    "height": 1080
  }
}

ویب ہک سیکیورٹی

تمام ویب ہک درخواستوں میں تصدیق کے لیے ایک دستخطی ہیڈر شامل ہوتا ہے:

X-Doitong-Signature: sha256=abc123...

ریٹ لمٹس

منصفانہ استعمال اور سسٹم کے استحکام کو یقینی بنانے کے لیے، درج ذیل ریٹ لمٹس لاگو ہوتی ہیں:

بہترین طریقے

1. اپنے پرامپٹس کو بہتر بنائیں

بہترین نتائج کے لیے واضح اور وضاحتی پرامپٹس لکھیں:

• Be specific about visual elements, style, and mood
• Include details about lighting, camera angles, and composition
• Avoid contradictory or impossible requests

2. غیر مطابقت پذیر (Async) پروسیسنگ سنبھالیں

مواد کی تیاری غیر مطابقت پذیر ہوتی ہے۔ مناسب پولنگ یا ویب ہکس نافذ کریں:

// Polling example
async function pollStatus(jobId) {
  let status = 'processing';
  while (status === 'processing') {
    await sleep(2000); // Wait 2 seconds
    const result = await checkJobStatus(jobId);
    status = result.status;
  }
  return result;
}

3. ایرر ریکوری

ایکسپونینشل بیک آف کے ساتھ دوبارہ کوشش (retry) کی لاجک نافذ کریں:

async function retryWithBackoff(fn, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error) {
      if (i === maxRetries - 1) throw error;
      await sleep(Math.pow(2, i) * 1000);
    }
  }
}

4. کریڈٹ کے استعمال کی نگرانی کریں

تعطل سے بچنے کے لیے اپنے کریڈٹ کے استعمال پر نظر رکھیں:

• Check credit balance before large batch operations
• Set up alerts for low credit thresholds
• Implement credit-aware request queuing

شروع کرنے کے لیے تیار ہیں؟

بہترین مواد تخلیق کرنے کے لیے Kling Image-to-Video API استعمال کرنے والے ہزاروں ڈویلپرز میں شامل ہوں