Authentication

Reference for Authentication.

API Key Authentication

The recommended way to authenticate. Go to Settings → API Key to generate your key. Include it in every request via the X-Api-Key header:

cURL
curl -X POST https://sangtao.ai/api/v2/render/video \
  -H "X-Api-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{ ... }'
Important: Your API key is a secret. Do not expose it in client-side code (browsers, mobile apps). Only use it in server-side applications.

Credits System

Every job consumes credits. Check your balance before submitting:

JSON
GET /api/v2/account/balance

// Response
{
  "freeCredit": 100,      // Monthly plan credits
  "purchasedCredit": 50,  // Purchased credits
  "lockedCredit": 10,     // Held for running jobs
  "availableCredit": 140  // free + purchased - locked
}
PhaseDescription
LockCredits are estimated and locked when you submit a job
ProcessJob runs. Actual cost may be lower than estimate
SettleWhen complete, excess credits are automatically refunded
Note: Deduction order: free credits are used first, then purchased credits.

Job Polling

All creation endpoints return a jobId. Poll the job status endpoint to track progress:

pending→processing→complete|error
JavaScript
// 1. Submit job
const res = await fetch('https://sangtao.ai/api/v2/voiceover-videos/create', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'your-api-key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ story: 'Hello world', voiceId: 'hoai-my' }),
})
const { data } = await res.json()

// 2. Poll until complete
const poll = setInterval(async () => {
  const job = await fetch(`https://sangtao.ai/api/v2/jobs/${data.jobId}`, {
    headers: { 'X-Api-Key': 'your-api-key' },
  }).then(r => r.json())

  if (job.data.status === 'complete') {
    clearInterval(poll)
    console.log('Video URL:', job.data.result)
  } else if (job.data.status === 'error') {
    clearInterval(poll)
    console.error('Job failed:', job.data.errorMessage)
  }
}, 4000) // Poll every 4 seconds
Tip: During processing, the step field shows current progress (e.g. "generating_images_2_of_5"). Use it to display a detailed progress indicator.
PreviousIntroductionNextJob Polling