Error Codes

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message",
    "details": {
      "field": "additional context"
    },
    "documentation_url": "https://docs.logtalk.io/errors/ERROR_CODE"
  },
  "request_id": "req_1kn5f2a_a3b4c5d6e7f8",
  "timestamp": "2026-01-18T12:00:00.000Z"
}

async function createConversion(content) {
  const response = await fetch('https://api.logtalk.io/v1/episodes', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.LOGTALK_API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ content, output_format: 'audio' })
  });

  const data = await response.json();

  if (!data.success) {
    const { error } = data;

    switch (error.code) {
      case 'AUDIO_QUOTA_EXCEEDED':
        console.error('Quota exceeded, need to upgrade or purchase credits');
        break;
      case 'DAILY_LIMIT_EXCEEDED':
        const retryAfter = response.headers.get('Retry-After');
        console.error(`Rate limited, retry after ${retryAfter} seconds`);
        break;
      case 'VALIDATION_ERROR':
        console.error('Invalid request:', error.details);
        break;
      case 'INVALID_RETRY_STATE':
        console.error('Cannot retry episode in current state');
        break;
      default:
        console.error(`Error ${error.code}: ${error.message}`);
        console.error(`Documentation: ${error.documentation_url}`);
    }

    throw new Error(error.message);
  }

  return data.data;
}