Beochan Carachtar Hedra

Beochan carachtar le sioncronú fuaime foirfe. Tabhair beocht do phortráidí le gothaí gnúise agus gluaiseachtaí nádúrtha.

Fíordheimhniú

Chun teacht ar Hedra trí API Doitong, úsáid d'eochair API Doitong. Cuir san áireamh í i mutation GraphQL nó i gceanntásca an API REST.

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

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

Treoir Thapa

Cuir tús le Hedra Lip Sync API laistigh de chúpla nóiméad. Lean na céimeanna simplí seo chun do chéad avatar a ghiniúint.

Céim 1: Faigh d'Eochair API

Cláraigh le haghaidh cuntas Doitong agus téigh chuig do phainéal rialaithe chun eochair API a ghiniúint.

Céim 2: Déan do Chéad Iarratas

Úsáid ceann de na samplaí cóid thíos chun do chéad ghlao API a dhéanamh.

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

Praghsáil

Úsáideann Hedra Lip Sync API múnla praghsála bunaithe ar chreidmheasanna. Ídítear creidmheasanna bunaithe ar chastacht agus ar fhad an ábhair a ghintear.

Críochphointí API

Tá Hedra Lip Sync API ar fáil trínár gcríochphointe aontaithe GraphQL.

Críochphointe GraphQL

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

Críochphointe REST

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

Paraiméadair

Paraiméadair atá ar fáil d'iarratais Hedra Lip Sync API:

Formáid an Fhreagra

Leanann gach freagra API formáid chomhsheasmhach:

Freagra rathúil

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

Freagra críochnaithe

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

Láimhseáil Earráidí

Úsáideann an API cóid stádais HTTP chaighdeánacha agus seolann sé teachtaireachtaí earráide mionsonraithe ar ais.

Cóid Earráide Choitianta

Formáid an Fhreagra Earráide

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

Webhooks

Faigh fógraí fíor-ama nuair a bhíonn do ghiniúint avatar críochnaithe.

Webhooks a Chumrú

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

Lastas Pá Webhook

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

Slándáil Webhook

Cuimsíonn gach iarratas webhook ceanntásc sínithe le haghaidh fíoraithe:

X-Doitong-Signature: sha256=abc123...

Teorainneacha Ráta

Chun úsáid chothrom agus cobhsaíocht an chórais a chinntiú, tá na teorainneacha ráta seo a leanas i bhfeidhm:

Dea-chleachtais

1. Optamaigh do chuid Prasanna

Scríobh prasanna soiléire tuairisciúla chun na torthaí is fearr a fháil:

• Be specific about visual elements, style, and mood
• Include details about lighting, camera angles, and composition
• Avoid contradictory or impossible requests

2. Láimhseáil Próiseáil Asincrónach

Is próiseas asincrónach é an ghiniúint. Cuir vótaíocht chuí nó webhooks i bhfeidhm:

// 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. Téarnamh ó Earráidí

Cuir loighic atriail i bhfeidhm le haischéimniú easpónantúil:

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. Monatóireacht ar Úsáid Creidmheasa

Coinnigh súil ar do chuid creidmheasanna chun briseadh sa tseirbhís a sheachaint:

• Check credit balance before large batch operations
• Set up alerts for low credit thresholds
• Implement credit-aware request queuing

An bhfuil tú réidh le tosú?

Bí i dteannta na mílte forbróirí atá ag úsáid Hedra Lip Sync API chun ábhar iontach a chruthú