Google ٹیکسٹ ٹو اسپیچ

WaveNet آوازوں کے ساتھ گوگل کا نیورل ٹیکسٹ ٹو اسپیچ۔ SSML سپورٹ کے ساتھ 50 سے زائد زبانوں میں 380 سے زیادہ آوازیں۔

تصدیق

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

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

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

فوری آغاز

صرف چند منٹوں میں Google TTS API کے ساتھ کام شروع کریں۔ اپنا پہلا tts تیار کرنے کے لیے ان آسان مراحل پر عمل کریں۔

مرحلہ 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": "AUDIO",
        "provider": "google-tts",
        "input": {
          "text": "Hello world, this is a text to speech example.",
          "voice": "en-US-neural"
        },
        "options": {
          "speed": 1.0
        }
      }
    }
  }'

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 GenerateSpeech($input: TTSInput!) {
        generateSpeech(input: $input) {
          id
          audioUrl
          duration
        }
      }
    `,
    variables: {
      input: {
        service: 'google-tts',
        text: 'Hello world, this is a text to speech example.',
        voice: 'en-US-neural',
        speed: 1.0
      }
    }
  })
});

const data = await response.json();
console.log('Result:', data.data.generate);

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": "AUDIO",
        "provider": "google-tts",
        "input": {
            "text": "Hello world, this is a text to speech example.",
            "voice": "en-US-neural"
        },
        "options": {
            "speed": 1.0
        }
    }
}

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": "AUDIO",
    "provider": "google-tts",
    "input": {
      "text": "Hello world, this is a text to speech example.",
      "voice": "en-US-neural"
    },
    "options": {
      "speed": 1.0,
      "pitch": 1.0,
      "language": "en",
      "version": "neural2"
    }
  }
}

قیمتیں

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

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

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

GraphQL اینڈ پوائنٹ

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

REST اینڈ پوائنٹ

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

پیرامیٹرز

Google TTS API کی درخواستوں کے لیے دستیاب پیرامیٹرز:

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

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

کامیاب جواب

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

مکمل شدہ جواب

{
  "data": {
    "tts": {
      "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)

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

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

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": "google-tts",
  "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

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

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