ElevenLabs дауыстық AI

Эмоцияны басқару мүмкіндігі бар және бірнеше тілдегі ең табиғи AI дауыстары.

Аутентификация

ElevenLabs қызметіне Doitong API арқылы қол жеткізу үшін Doitong API кілтін пайдаланыңыз. Оны GraphQL мутациясына немесе REST API тақырыптарына (headers) қосыңыз.

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

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

Жылдам бастау

ElevenLabs TTS API қызметімен бірнеше минутта жұмысты бастаңыз. Алғашқы tts жасау үшін осы қарапайым қадамдарды орындаңыз.

1-қадам: API кілтін алу

Doitong тіркелгісіне тіркеліп, API кілтін жасау үшін бақылау тақтасына (dashboard) өтіңіз.

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": "elevenlabs",
        "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: 'elevenlabs',
        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": "elevenlabs",
        "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": "elevenlabs",
    "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": "eleven-turbo-v2"
    }
  }
}

Бағалар

ElevenLabs TTS API кредиттік баға үлгісін пайдаланады. Кредиттер жасалған мазмұнның күрделілігі мен ұзақтығына байланысты жұмсалады.

API соңғы нүктелері

ElevenLabs TTS API біздің бірыңғай GraphQL соңғы нүктесі арқылы қолжетімді.

GraphQL соңғы нүктесі

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

REST соңғы нүктесі

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

Параметрлер

ElevenLabs 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
      }
    }
  ]
}

Вебхуктар

tts жасау аяқталған кезде нақты уақыт режимінде хабарландырулар алыңыз.

Вебхуктарды баптау

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

Вебхук деректері (payload)

{
  "id": "abc123xyz",
  "status": "completed",
  "url": "https://cdn.doitong.com/outputs/abc123xyz.mp3",
  "service": "elevenlabs",
  "createdAt": "2024-01-01T00:00:00Z",
  "completedAt": "2024-01-01T00:01:00Z",
  "metadata": {
    "duration": null,
    "width": null,
    "height": null
  }
}

Вебхук қауіпсіздігі

Барлық вебхук сұраулары тексеру үшін қолтаңба тақырыбын (signature header) қамтиды:

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. Асинхронды өңдеуді басқару

Жасау процесі асинхронды. Тиісті сұрау (polling) немесе вебхуктарды енгізіңіз:

// 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. Қателерден кейін қалпына келтіру

Экспоненциалды күту (exponential backoff) арқылы қайталау логикасын енгізіңіз:

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

Бастауға дайынсыз ба?

Керемет мазмұн жасау үшін ElevenLabs TTS API қызметін пайдаланатын мыңдаған әзірлеушілерге қосылыңыз