---
title: "処理状態の確認"
slug: "ai-application-service-clovaspeech-longsentence-getjobstatus"
updated: 2026-09-17T09:57:17Z
published: 2026-09-17T09:57:17Z
canonical: "api.ncloud-docs.com/ai-application-service-clovaspeech-longsentence-getjobstatus"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 処理状態の確認

Classic/VPC環境で利用できます。

長文認識において`async`(非同期)方式リクエストの処理状態を確認します。

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| メソッド | URI |
| --- | --- |
| GET | /recognizer/{token} |

### リクエストヘッダ

CLOVA Speech APIで共通して使用されるヘッダの詳細は、[CLOVA Speechのリクエストヘッダ](/docs/ja/ai-application-service-clovaspeech#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

### リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `token` | String | Required | 結果トークン |

### リクエスト例

リクエストのサンプルコードは次の通りです。

```
curl --location --request GET 'https://clovaspeech-gw.ncloud.com/external/v1/88**/{InvokeKey}/recognizer/{token}' \
--header 'X-CLOVASPEECH-API-KEY: {アプリの登録時に発行された Secret Key}'
```

## レスポンス

レスポンス形式を説明します。

### レスポンスボディ

レスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `result` | String | - | 状態確認の結果コード - `WAITING` \| `PROCESSING` \| `FAILED` \| `COMPLETED` \| `TIMEOUT` - `WAITING`: リクエスト処理待ち - `PROCESSING`: リクエスト処理中 - `FAILED`: リクエスト処理失敗 - `COMPLETED`: リクエスト処理成功 - `TIMEOUT`: リクエスト処理タイムオーバー |
| `message` | String | - | 状態確認の結果メッセージ |
| `token` | String | - | 結果トークン |
| `segments` | Array | - | [Object Storageファイルの認識](/docs/ja/ai-application-service-clovaspeech-longsentence#segments)、[外部ファイルの認識](/docs/ja/ai-application-service-clovaspeech-longsentence-externalurl#segments)、[ローカルファイルの認識](/docs/ja/ai-application-service-clovaspeech-longsentence-local#segments)の`segments`の詳細情報を参照 |
| `speakers` | Array | - | [Object Storageファイルの認識](/docs/ja/ai-application-service-clovaspeech-longsentence#segments)、[外部ファイルの認識](/docs/ja/ai-application-service-clovaspeech-longsentence-externalurl#segments)、[ローカルファイルの認識](/docs/ja/ai-application-service-clovaspeech-longsentence-local#segments)の`speakers`の詳細情報を参照 |
| `events` | Array | - | [Object Storageファイルの認識](/docs/ja/ai-application-service-clovaspeech-longsentence#segments)、[外部ファイルの認識](/docs/ja/ai-application-service-clovaspeech-longsentence-externalurl#segments)、[ローカルファイルの認識](/docs/ja/ai-application-service-clovaspeech-longsentence-local#segments)の`events`の詳細情報を参照 |
| `eventTypes` | Array | - | [Object Storageファイルの認識](/docs/ja/ai-application-service-clovaspeech-longsentence#segments)、[外部ファイルの認識](/docs/ja/ai-application-service-clovaspeech-longsentence-externalurl#segments)、[ローカルファイルの認識](/docs/ja/ai-application-service-clovaspeech-longsentence-local#segments)の`eventTypes`の詳細情報を参照 |

### レスポンスステータスコード

CLOVA Speech APIで共通して使用されるレスポンスステータスコードの詳細は、[CLOVA Speechのレスポンスステータスコード](/docs/ja/ai-application-service-clovaspeech#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

レスポンスのサンプルコードは次の通りです。

#### 成功

`async`でリクエストして呼び出しに成功した場合のレスポンスのサンプルコードは次の通りです。

```
{
    "result": "COMPLETED",
    "token": "{token}",
    "segments": [],
    "speakers": [],
    "events": [],
    "eventTypes": []
}
```

#### 失敗

`sync`でリクエストして呼び出しに成功した場合のレスポンスのサンプルコードは次の通りです。

```
{
    "result": "ERROR_TOKEN_INVALID",
    "message": "Token does not exist",
    "token": "{token}",
    "segments": [],
    "speakers": [],
    "events": [],
    "eventTypes": []
}
```