タスクの取得

パスパラメータ

フィールド型必須説明

task_idstring必須

非同期リクエストで返されたタスクID。

戻り値

このエンドポイントはタスクの現在の状態を返します。タスクが成功すると、結果フィールドはレスポンスの最上位に直接含まれます。

フィールド型説明

id: string

タスクID。パス内のtask_idに対応します。

object: string

タスクのオブジェクト種別。例：audio.speech / audio.voice_generation / audio.transcription。

status: string

タスクの状態。例：PENDING / PROCESSING / SUCCESS / FAILED。

created_at: integer

作成時刻。Unixタイムスタンプ（秒）。

updated_at: integer

最終更新時刻。Unixタイムスタンプ（秒）。

error: object

タスク実行失敗の情報。

音声タスクの結果

status=SUCCESSで、かつobjectがaudio.speechまたはaudio.voice_generationの場合、音声結果のURLを返します。実際の形式は、返されるresponse_formatとcontent_typeに準じます。

フィールド型条件説明

urlstring成功時

音声結果のURL。

response_formatstring成功時

実際の出力音声形式。例：wav。

content_typestring成功時

音声のMIMEタイプ。例：audio/wav。

文字起こしタスクの結果

status=SUCCESSで、かつobject=audio.transcriptionの場合、textに完全な文字起こしテキストが返されます。話者分離タスクではsegmentsも返されます。

フィールド型条件説明

textstring通常の文字起こし成功時

完全な文字起こしテキスト。

segmentsarray話者分離成功時

話者分離のセグメント。有効なセグメントがない場合は空配列になることがあります。

segments[].speakerstringセグメントがある場合

話者の識別子。

segments[].textstringセグメントがある場合

そのセグメントのテキスト。

segments[].startnumberセグメントがある場合

セグメントの開始時刻（秒）。

segments[].endnumberセグメントがある場合

セグメントの終了時刻（秒）。

タスクの失敗

status=FAILEDは、タスクは作成されたものの実行に失敗したことを示します。タスクが存在しない、またはアクセス権限がない場合の照会エラーとは異なります。失敗の原因はerrorに含まれます。

エラーコード

HTTP	error.code	発生条件	対処方法
404	`task_not_found`	指定した`task_id`が存在しない、または参照できない	タスク作成エンドポイントが返した`task_id`を使用していること、およびAPIキーにそのタスクへのアクセス権限があることを確認してください。

次のステップ

単一話者の音声生成

テキストを音声に変換するエンドポイント。

音声文字起こし

音声文字起こしのエンドポイント。

リクエスト例

curl -X GET "https://api.mosi.cn/v1/audio/tasks/<task_id>" \
  -H "Authorization: Bearer $MOSS_API_KEY"

import os
import requests

response = requests.get(
        "https://api.mosi.cn/v1/audio/tasks/<task_id>",
        headers={
        "Authorization": f"Bearer {os.environ['MOSS_API_KEY']}",
        },
)

response.raise_for_status()
print(response.json())

const response = await fetch("https://api.mosi.cn/v1/audio/tasks/<task_id>", {
  method: "GET",
  headers: {
    "Authorization": "Bearer " + process.env.MOSS_API_KEY,
  },
})

if (!response.ok) throw new Error(`HTTP ${response.status}`)
console.log(await response.json())

レスポンス例

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "object": "audio.speech",
  "status": "SUCCESS",
  "created_at": 1710000000,
  "updated_at": 1710000003,
  "url": "https://example.com/result.wav",
  "response_format": "wav",
  "content_type": "audio/wav"
}

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "object": "audio.transcription",
  "status": "SUCCESS",
  "created_at": 1710000000,
  "updated_at": 1710000002,
  "text": "This is a short transcription test audio."
}

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "object": "audio.voice_generation",
  "status": "PROCESSING",
  "created_at": 1710000000,
  "updated_at": 1710000001
}

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "object": "audio.speech",
  "status": "FAILED",
  "error": {},
  "created_at": 1710000000,
  "updated_at": 1710000001
}