Hedra کریکٹر اینیمیشن

بہترین آڈیو سنک کے ساتھ کریکٹر اینیمیشن۔ پورٹریٹ کو قدرتی تاثرات اور حرکات کے ساتھ زندہ کریں۔

تصدیق

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

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

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

فوری آغاز

صرف چند منٹوں میں Hedra Lip Sync API کے ساتھ کام شروع کریں۔ اپنا پہلا avatar تیار کرنے کے لیے ان آسان مراحل پر عمل کریں۔

مرحلہ 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" \
  -d '{
    "query": "mutation Generate($input: GenerateInput!) { generate(input: $input) { id status type provider url metadata creditCost } }",
    "variables": {
      "input": {
        "type": "AVATAR",
        "provider": "hedra",
        "input": {
          "text": "Hello, welcome to our platform!",
          "avatarId": "professional-1"
        },
        "options": {
          "voice": "en-US-neural"
        }
      }
    }
  }'

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 GenerateAvatar($input: AvatarGenerationInput!) {
        generateAvatar(input: $input) {
          id
          status
          videoUrl
        }
      }
    `,
    variables: {
      input: {
        service: 'hedra',
        text: 'Hello, welcome to our platform!',
        avatarId: 'professional-1',
        voice: 'en-US-neural'
      }
    }
  })
});

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

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": "AVATAR",
        "provider": "hedra",
        "input": {
            "text": "Hello, welcome to our platform!",
            "avatarId": "professional-1"
        },
        "options": {
            "voice": "en-US-neural"
        }
    }
}

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": "AVATAR",
    "provider": "hedra",
    "input": {
      "text": "Hello, welcome to our platform!",
      "avatarId": "professional-1"
    },
    "options": {
      "voice": "en-US-neural",
      "language": "en",
      "version": "hedra-1.0"
    }
  }
}

قیمتیں

Hedra Lip Sync API کریڈٹ پر مبنی قیمتوں کا ماڈل استعمال کرتا ہے۔ کریڈٹس کا استعمال تیار کردہ مواد کی پیچیدگی اور دورانیے کی بنیاد پر کیا جاتا ہے۔

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

Hedra Lip Sync API ہمارے متحد GraphQL اینڈ پوائنٹ کے ذریعے دستیاب ہے۔

GraphQL اینڈ پوائنٹ

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

REST اینڈ پوائنٹ

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

پیرامیٹرز

Hedra Lip Sync API کی درخواستوں کے لیے دستیاب پیرامیٹرز:

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

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

کامیاب جواب

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

مکمل شدہ جواب

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

ایرر ہینڈلنگ

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

عام ایرر کوڈز

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

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

ویب ہکس (Webhooks)

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

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

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.mp3",
  "service": "hedra",
  "createdAt": "2024-01-01T00:00:00Z",
  "completedAt": "2024-01-01T00:01:00Z",
  "metadata": {
    "duration": null,
    "width": null,
    "height": null
  }
}

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

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

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

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

بہترین مواد تخلیق کرنے کے لیے Hedra Lip Sync API استعمال کرنے والے ہزاروں ڈویلپرز میں شامل ہوں