API 文档

Authorization: Bearer ailrc_sk_YOUR_KEY

curl -X POST https://ailrcgenerator.com/api/v2/open/audio_analysis \
  -H "Authorization: Bearer ailrc_sk_YOUR_KEY" \
  -F "[email protected]" \
  -F "fileName=My Song" \
  -F 'metadata={"enableMetadata":true,"reference":"参考歌词第一行\\n参考歌词第二行","language":"auto","enableChorus":true,"timingGranularity":"word","enableTranslation":true,"sourceLanguage":"auto","targetLanguage":"en","enablePronunciationGuide":true,"pronunciationScheme":"auto"}'

{
  "code": 0,
  "message": "ok",
  "items": {
    "taskId": "cm4abc123",
    "traceId": "cm4abc123",
    "status": "QUEUED",
    "queuePosition": 2,
    "remainingCredits": 46,
    "fileName": "song.mp3"
  }
}

curl https://ailrcgenerator.com/api/v2/open/audio_tasks/cm4abc123 \
  -H "Authorization: Bearer ailrc_sk_YOUR_KEY"

{
  "code": 0,
  "items": {
    "taskId": "cm4abc123",
    "status": "QUEUED",
    "queuePosition": 2,
    "fileName": "song.mp3"
  }
}

{
  "code": 0,
  "items": {
    "taskId": "cm4abc123",
    "status": "PROCESSING",
    "progress": 35,
    "fileName": "song.mp3"
  }
}

{
  "code": 0,
  "items": {
    "taskId": "cm4abc123",
    "status": "COMPLETED",
    "result": {
      "lrc": "[00:00.00]<00:00.00>第一行\n[00:05.23]<00:05.23>第二行",
      "chorusLabelsDetected": false
    },
    "creditsUsed": 6,
    "completedAt": "2026-04-19T10:02:30Z",
    "fileName": "song.mp3"
  }
}

{
  "code": 0,
  "items": {
    "taskId": "cm4abc123",
    "status": "FAILED",
    "error": "PROCESSING_FAILED",
    "fileName": "song.mp3"
  }
}

{
  "result": {
    "lrc": "[00:12.30]오늘도 너를 생가해",
    "chorusLabelsDetected": false,
    "rawLrc": "[00:12.30]오늘도 너를 생가해",
    "referenceComparison": {
      "summary": {
        "totalRecognized": 1,
        "totalReference": 1,
        "exact": 0,
        "formatOnly": 0,
        "different": 1,
        "recognizedOnly": 0,
        "referenceOnly": 0
      },
      "changes": [
        {
          "id": "recognized-0-reference-0",
          "status": "different",
          "recognizedLineIndex": 0,
          "lrcLineIndex": 0,
          "referenceLineIndex": 0,
          "timestamp": "[00:12.30]",
          "recognizedText": "오늘도 너를 생가해",
          "referenceText": "오늘도 너를 생각해",
          "alignmentConfidence": 0.91,
          "recommendation": "high-confidence-replace",
          "similarity": 0.9,
          "canApply": true
        }
      ]
    }
  }
}

GET /api/v2/open/audio_tasks/:id?exportFormat=srt&exportIncludeTranslation=true&exportIncludePronunciation=false&exportIncludeChorusLabels=false

curl "https://ailrcgenerator.com/api/v2/open/audio_tasks/cm4abc123?exportFormat=srt&exportIncludeTranslation=true&exportIncludePronunciation=false&exportIncludeChorusLabels=false" \
  -H "Authorization: Bearer ailrc_sk_YOUR_KEY"

{
  "code": 0,
  "items": {
    "taskId": "cm4abc123",
    "status": "COMPLETED",
    "result": {
      "lrc": "[00:00.00]第一行\n[00:05.23]第二行",
      "chorusLabelsDetected": false,
      "export": {
        "format": "srt",
        "fileName": "song.srt",
        "mimeType": "application/x-subrip;charset=utf-8",
        "content": "1\n00:00:00,000 --> 00:00:05,230\n第一行\n\n2\n00:00:05,230 --> 00:00:08,230\n第二行"
      }
    },
    "creditsUsed": 6,
    "completedAt": "2026-04-19T10:02:30Z",
    "fileName": "song.mp3"
  }
}

curl "https://ailrcgenerator.com/api/v2/open/audio_tasks?page=1&limit=20&status=COMPLETED" \
  -H "Authorization: Bearer ailrc_sk_YOUR_KEY"

curl -X DELETE https://ailrcgenerator.com/api/v2/open/audio_tasks/cm4abc123 \
  -H "Authorization: Bearer ailrc_sk_YOUR_KEY"

{
  "code": 403,
  "message": "Not enough credits",
  "businessCode": "not_enough_credits"
}

async function pollTask(taskId, apiKey) {
  let delay = 3000;
  for (let i = 0; i < 60; i++) {
    await new Promise((r) => setTimeout(r, delay));
    const res = await fetch(
      `https://ailrcgenerator.com/api/v2/open/audio_tasks/${taskId}`,
      { headers: { Authorization: `Bearer ${apiKey}` } },
    );
    const { items } = await res.json();
    if (items.status === "COMPLETED") return items.result.lrc;
    if (items.status === "FAILED") throw new Error(items.error ?? "分析失败");
    delay = Math.min(delay * 1.5, 10000);
  }
  throw new Error("等待超时");
}