ElevenLabs 음성 AI

감정 제어가 가능하며 다국어를 지원하는 가장 자연스러운 AI 음성 서비스입니다.

인증

Doitong API를 통해 ElevenLabs에 액세스하려면 Doitong API 키를 사용하세요. GraphQL mutation 또는 REST API 헤더에 해당 키를 포함해야 합니다.

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

웹후크

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

웹후크 보안

모든 웹후크 요청에는 검증을 위한 서명 헤더가 포함됩니다:

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 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을(를) 사용하여 놀라운 콘텐츠를 만들고 있습니다