Completions
- 印刷する
- PDF
Completions
- 印刷する
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
Classic/VPC環境で利用できます。
CLOVA Studio結果値(completion)を作成するための情報を CLOVA Studioに伝達することができます。プロンプトの内容と使用するモデル、その他の設定パラメータ値を指定して伝達すると、CLOVA Studioはこの内容に基づいて結果値を作成します。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
| メソッド | URI |
|---|---|
| POST | /v1/completions/{model} |
ヘッダ
ヘッダの説明は次の通りです。
| ヘッダ | 必須有無 | 説明 |
|---|---|---|
| X-NCP-CLOVASTUDIO-API-KEY | Y | テストアプリやサービスアプリを作成時に発行された API KEY |
| X-NCP-APIGW-API-KEY | Y | テストアプリやサービスアプリを作成時に発行された API Gateway KEY |
| X-NCP-CLOVASTUDIO-REQUEST-ID | N | 各リクエストのリクエスト ID |
| Content-Type | Y | application/json |
パスパラメータ
パラメータについての説明は、次の通りです。
| フィールド | タイプ | 必須有無 | 説明 |
|---|---|---|---|
| model | string | Y | モデル名: LK-D2 |
ボディ
ボディの説明は次の通りです。
構文
構文例は次の通りです。
curl --location --request POST 'https://clovastudio.apigw.ntruss.com/testapp/v1/completions/LK-D2' \
--header 'X-NCP-CLOVASTUDIO-API-KEY: <X-NCP-CLOVASTUDIO-API-KEY>' \
--header 'X-NCP-APIGW-API-KEY: <X-NCP-APIGW-API-KEY>' \
--header 'X-NCP-CLOVASTUDIO-REQUEST-ID: <X-NCP-CLOVASTUDIO-REQUEST-ID>' \
--header 'Content-Type: application/json' \
--data '{
"start": "\n英語: ",
"stopBefore": ["\n韓国語: "],
"text": "韓国語: りんご\n英語: Apple\n韓国語: バナナ",
"includeAiFilters": true
}'
レスポンス
レスポンス形式を説明します。
ヘッダ
ヘッダの説明は次の通りです。
| ヘッダ | 必須有無 | 説明 |
|---|---|---|
| Content-Type | - | application/json |
ボディ
ボディの説明は次の通りです。
| フィールド | タイプ | 必須有無 | 説明 |
|---|---|---|---|
| aiFilters | object array | - | AI Filter点数 |
| aiFilters[].groupName | string | - | AI Filter分類参照 |
| aiFilters[].name | string | - | AI Filter分類参照 |
| aiFilters[].score | string | - | テキストが aiFilters[].nameカテゴリに該当する程度
|
| inputLength | integer | - | 入力されたトークン数 |
| inputTokens | string array | - | 入力されたトークン情報 |
| outputLength | integer | - | 出力されたトークン数 |
| outputTokens | string array | - | 出力されたトークン情報 |
| stopReason | string | - | 結果値の作成を中断した理由
|
| text | string | - | 作成されたトークン。プロンプトと結果値の両方を含む |
| probs | float | - | 作成された各トークンが選択される確率 |
AI Filter分類
aiFilters[].groupNameと aiFilters[].nameに含まれる内容は以下の表でご確認ください。
| groupName | name | 説明 |
|---|---|---|
| curse | discrimination | 卑下または差別または嫌悪 |
| curse | insult | 悪口 |
| unsafeContents | sexualHarassment | セクハラまたはわいせつ |
構文
構文例は次の通りです。
{
"status": {
"code": "20000",
"message": "OK"
},
"result": {
"text": "...",
"stopReason": "stop_before",
"inputLength": 10,
"outputLength": 20,
"inputTokens" : ["who", " ", "are", " ", "you"],
"outputTokens" : ["hello", " ", "world"],
"aiFilters": [
{
"groupName": "curse",
"name": "insult",
"score": "0"
},
{
"groupName": "curse",
"name": "discrimination",
"score": "1"
},
{
"groupName": "unsafeContents",
"name": "sexualHarassment",
"score": "2"
}
]
}
}
この記事は役に立ちましたか?