ElevenLabs קול AI

די מערסט נאַטירלעכע AI קולות מיט עמאָציאָנעלן קאָנטראָל און פֿיל שפּראַכן.

אָטענטיפֿיקאַציע

כדי צוצוטרעטן צו ElevenLabs דורך דעם Doitong API, ניצט אייער Doitong API שליסל. לייגט אים אַרײַן אין די GraphQL mutation אָדער 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 שליסל.

שריט 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
      }
    }
  ]
}

וועבהוקס (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": "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 צו שאַפֿן מוראדיקן אינהאַלט