Alibaba Cloud Model Studio:structured output

from openai import OpenAI
import os

client = OpenAI(
    # シンガポールリージョンと北京リージョンの API キーは異なります。環境変数を設定していない場合は、次の行を API キーに置き換えてください：api_key="sk-xxx"
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # シンガポールリージョンの base_url です。北京リージョンについては、https://dashscope.aliyuncs.com/compatible-mode/v1 を使用してください
    base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
)

completion = client.chat.completions.create(
    model="qwen-flash",
    messages=[
        {
            "role": "system",
            "content": "ユーザーの名前と年齢を抽出し、情報を JSON フォーマットで返してください。"
        },
        {
            "role": "user",
            "content": "皆さん、こんにちは。私の名前は田中一郎、34歳です。メールアドレスは tanaka.ichiro@example.com で、趣味はバスケットボールと旅行です。", 
        },
    ],
    response_format={"type": "json_object"}
)

json_string = completion.choices[0].message.content
print(json_string)

実行結果

{
  "name": "Liu Wu",
  "age": 34
}

import OpenAI from "openai";

const openai = new OpenAI({
    // 環境変数を設定していない場合は、次の行を API キーに置き換えてください：apiKey: "sk-xxx"
    apiKey: process.env.DASHSCOPE_API_KEY,
    // 以下の baseURL はシンガポールリージョン用です。北京リージョンのモデルを使用するには、baseURL を https://dashscope.aliyuncs.com/compatible-mode/v1 に置き換えてください
    baseURL: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
});

const completion = await openai.chat.completions.create({
    model: "qwen-flash",
    messages: [
        {
            role: "system",
            content: "ユーザーの名前と年齢の情報を抽出し、JSON フォーマットで返してください。"
        },
        {
            role: "user",
            content: "皆さん、こんにちは。私の名前は田中一郎、34歳です。メールアドレスは tanaka.ichiro@example.com で、趣味はバスケットボールと旅行です。"
        }
    ],
    response_format: {
        type: "json_object"
    }
});

const jsonString = completion.choices[0].message.content;
console.log(jsonString);

実行結果

{
  "Name": "Liu Wu",
  "Age": 34
}

# ======= 重要 =======
# シンガポールリージョンと中国 (北京) リージョンの API キーは異なります。API キーの取得方法の詳細については、https://www.alibabacloud.com/help/model-studio/get-api-key をご参照ください
# 以下はシンガポールリージョンの URL です。中国 (北京) リージョンのモデルを使用する場合は、URL を https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions に置き換えてください
# === 実行前にこのコメントを削除してください ===
curl -X POST https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen-plus",
    "messages": [
        {
            "role": "system",
            "content": "名前 (文字列)、年齢 (文字列)、メールアドレス (文字列) を抽出する必要があります。JSON 文字列を出力してください。他のコンテンツは出力しないでください。\n例：\nQ: 私の名前は佐藤太郎、25歳で、メールアドレスは sato.taro@example.com です\nA:{\"name\":\"佐藤太郎\",\"age\":\"25歳\",\"email\":\"sato.taro@example.com\"}\nQ: 私の名前は鈴木花子、30歳で、メールアドレスは suzuki.hanako@example.com です\nA:{\"name\":\"鈴木花子\",\"age\":\"30歳\",\"email\":\"suzuki.hanako@example.com\"}\nQ: 私の名前は高橋健太、メールアドレスは takahashi.kenta@example.com で、40歳です\nA:{\"name\":\"高橋健太\",\"age\":\"40歳\",\"email\":\"takahashi.kenta@example.com\"}"
        },
        {
            "role": "user", 
            "content": "皆さん、こんにちは。私の名前は田中一郎、34歳です。メールアドレスは tanaka.ichiro@example.com です。"
        }
    ],
    "response_format": {
        "type": "json_object"
    }
}'

実行結果

{
    "choices": [
        {
            "message": {
                "role": "assistant",
                "content": "{\"name\":\"Liu Wu\",\"age\":\"34 years old\""}"
            },
            "finish_reason": "stop",
            "index": 0,
            "logprobs": null
        }
    ],
    "object": "chat.completion",
    "usage": {
        "prompt_tokens": 207,
        "completion_tokens": 20,
        "total_tokens": 227,
        "prompt_tokens_details": {
            "cached_tokens": 0
        }
    },
    "created": 1756455080,
    "system_fingerprint": null,
    "model": "qwen-plus",
    "id": "chatcmpl-624b665b-fb93-99e7-9ebd-bb6d86d314d2"
}

import os
import dashscope
# 以下はシンガポールリージョンの URL です。北京リージョンのモデルを使用するには、URL を https://dashscope.aliyuncs.com/api/v1 に置き換えてください
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'

messages=[
    {
        "role": "system",
        "content": "ユーザーの名前と年齢を抽出し、情報を JSON フォーマットで返してください。"
    },
    {
        "role": "user",
        "content": "皆さん、こんにちは。私の名前は田中一郎、34歳です。メールアドレスは tanaka.ichiro@example.com で、趣味はバスケットボールと旅行です。", 
    },
]
response = dashscope.Generation.call(
    # 中国 (北京) リージョンのモデルを使用するには、そのリージョン固有の API キーを使用する必要があります。API キーは https://bailian.console.alibabacloud.com/?tab=model#/api-key から取得できます
    # 環境変数を設定していない場合は、次の行を Model Studio の API キーに置き換えてください：api_key="sk-xxx",
    api_key=os.getenv('DASHSCOPE_API_KEY'),
    model="qwen-flash", 
    messages=messages,
    result_format='message',
    response_format={'type': 'json_object'}
    )
json_string = response.output.choices[0].message.content
print(json_string)

実行結果

{
  "name": "Liu Wu",
  "age": 34
}

実行結果

{
  "name": "Alex Brown",
  "age": 34
}

# ======= 重要 =======
# シンガポールリージョンと中国 (北京) リージョンの API キーは異なります。API キーの取得方法の詳細については、https://www.alibabacloud.com/help/model-studio/get-api-key をご参照ください
# 以下はシンガポールリージョンの URL です。中国 (北京) リージョンのモデルを使用する場合は、URL を https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation に置き換えてください
# === 実行前にこのコメントを削除してください ===

curl -X POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/text-generation/generation \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen-flash",
    "input": {
        "messages": [
            {
                "role": "system",
                "content": "名前と年齢を抽出し、情報を JSON フォーマットで返してください。"
            },
            {
                "role": "user", 
                "content": "皆さん、こんにちは。私の名前は田中一郎、34歳です。メールアドレスは tanaka.ichiro@example.com で、趣味はバスケットボールと旅行です。"
            }
        ]
    },
    "parameters": {
        "result_format": "message",
        "response_format": {
            "type": "json_object"
        }
    }
}'

実行結果

{
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": "{\n  \"Name\": \"Liu Wu\",\n  \"Age\": 34\n}"
                }
            }
        ]
    },
    "usage": {
        "total_tokens": 72,
        "output_tokens": 18,
        "input_tokens": 54,
        "cached_tokens": 0
    },
    "request_id": "xxx-xxx-xxx-xxx-xxx"
}

import OpenAI from "openai";

const openai = new OpenAI({
  // シンガポールリージョンと中国 (北京) リージョンの API キーは異なります。API キーを取得するには、https://www.alibabacloud.com/help/model-studio/get-api-key をご参照ください
  // 環境変数を設定していない場合は、次の行を Model Studio の API キーに置き換えてください：apiKey: "sk-xxx"
  apiKey: process.env.DASHSCOPE_API_KEY,
  // 以下はシンガポールリージョンの base_url です。中国 (北京) リージョンのモデルを使用する場合は、base_url を https://dashscope.aliyuncs.com/compatible-mode/v1 に置き換えてください
  baseURL: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
});

async function main() {
  const response = await openai.chat.completions.create({
    model: "qwen3-vl-plus",
    messages: [{
        role: "system",
        content: [{
          type: "text",
          text: "あなたは役に立つアシスタントです。"
        }]
      },
      {
        role: "user",
        content: [{
            type: "image_url",
            image_url: {
              "url": "http://duguang-labelling.oss-cn-shanghai.aliyuncs.com/demo_ocr/receipt_zh_demo.jpg"
            }
          },
          {
            type: "text",
            text: "画像からチケット情報 (travel_date、trains、seat_num、arrival_site、price を含む) と請求書情報 (配列として、invoice_code と invoice_number を含む) を抽出します。チケットと請求書の配列を含む JSON オブジェクトを出力してください。"
          }
        ]
      }
    ],
    response_format: {type: "json_object"}
  });
  console.log(response.choices[0].message.content);
}

main()

実行結果

{
  "ticket": [
    {
      "travel_date": "2013-06-29",
      "trains": "シリアル番号",
      "seat_num": "371",
      "arrival_site": "開発区",
      "price": "8.00"
    }
  ],
  "invoice": [
    {
      "invoice_code": "221021325353",
      "invoice_number": "10283819"
    }
  ]
}

from openai import OpenAI
import os
import json
import textwrap  # 複数行文字列のインデントを処理し、コードの可読性を向上させるために使用

# モデルに期待される出力フォーマットを示すために、応答例を事前に定義
# 例 1：趣味を含む完全な応答
example1_response = json.dumps(
    {
        "info": {"name": "佐藤太郎", "age": "25歳", "email": "sato.taro@example.com"},
        "hobby": ["歌唱"]
    },
    ensure_ascii=False
)
# 例 2：複数の趣味を含む応答
example2_response = json.dumps(
    {
        "info": {"name": "鈴木花子", "age": "30歳", "email": "suzuki.hanako@example.com"},
        "hobby": ["ダンス", "水泳"]
    },
    ensure_ascii=False
)
# 例 3：hobby フィールドを含まない応答 (hobby はオプション)
example3_response = json.dumps(
    {
        "info": {"name": "高橋健太", "age": "28歳", "email": "takahashi.kenta@example.com"}
    },
    ensure_ascii=False
)
# 例 4：hobby フィールドを含まない応答
example4_response = json.dumps(
    {
        "info": {"name": "伊藤さくら", "age": "35歳", "email": "ito.sakura@example.com"}
    },
    ensure_ascii=False
)

# OpenAI クライアントを初期化し、API キーとベース URL を設定
client = OpenAI(
    # シンガポールリージョンと北京リージョンの API キーは異なります。API キーを取得するには、https://www.alibabacloud.com/help/model-studio/get-api-key をご覧ください
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # 以下はシンガポールリージョンの URL です。北京リージョンのモデルを使用する場合は、URL を https://dashscope.aliyuncs.com/compatible-mode/v1 に置き換えてください
    base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
)

# dedent 関数は、文字列の各行から共通の先頭の空白を削除します。
# これにより、実行時に余分なスペースを含めずに、コード内で文字列をきれいにインデントできます。
system_prompt = textwrap.dedent(f"""\
    ユーザー入力から個人情報を抽出し、指定された JSON スキーマフォーマットで出力してください：

    [出力フォーマット要件]
    出力は、以下の JSON 構造に厳密に従う必要があります：
    {{
      "info": {{
        "name": "文字列。必須。名前。",
        "age": "文字列。必須。フォーマットは「数字+歳」、例：「25歳」。",
        "email": "文字列。必須。標準的なメールフォーマット、例：「user@example.com」。"
      }},
      "hobby": ["文字列の配列。オプション。すべての趣味を含む。趣味が言及されていない場合は、このフィールドを出力から省略する必要があります。"]
    }}

    [フィールド抽出ルール]
    1. name：テキストから名前を特定します。このフィールドは必須です。
    2. age：年齢情報を特定し、「数字+歳」のフォーマットに変換します。このフィールドは必須です。
    3. email：メールアドレスを特定し、元のフォーマットを維持します。このフィールドは必須です。
    4. hobby：趣味を特定し、文字列の配列として出力します。趣味が言及されていない場合は、hobby フィールドを完全に省略してください。

    [参照例]
    例 1 (趣味を含む)：
    Q: 私の名前は佐藤太郎、25歳、メールアドレスは sato.taro@example.com、歌うのが好きです。
    A: {example1_response}

    例 2 (複数の趣味を含む)：
    Q: 私の名前は鈴木花子、30歳、メールアドレスは suzuki.hanako@example.com、ダンスと水泳を楽しんでいます。
    A: {example2_response}

    例 3 (趣味を含まない)：
    Q: 私の名前は高橋健太、28歳、メールアドレスは takahashi.kenta@example.com です。
    A: {example3_response}

    例 4 (趣味を含まない)：
    Q: 私は伊藤さくら、35歳です。メールアドレスは ito.sakura@example.com です。
    A: {example4_response}

    上記のフォーマットとルールに厳密に従って情報を抽出し、JSON を出力してください。ユーザーが趣味について言及していない場合は、hobby フィールドを出力に含めないでください。\
""")

# LLM API を呼び出して情報を抽出
completion = client.chat.completions.create(
    model="qwen-plus",  # 使用するモデルを指定、qwen-plus
    messages=[
        {
            "role": "system",
            "content": system_prompt  # 上で定義したシステムプロンプトを使用
        },
        {
            "role": "user",
            "content": "皆さん、こんにちは。私の名前は田中一郎、34歳です。メールアドレスは tanaka.ichiro@example.com で、バスケットボールと旅行が好きです。", 
        },
    ],
    response_format={"type": "json_object"},  # 構造化出力を保証するために応答フォーマットを JSON に指定
)

# モデルによって生成された JSON 結果を抽出して出力
json_string = completion.choices[0].message.content
print(json_string)

実行結果

{
  "info": {
    "name": "Liu Wu",
    "age": "34",
    "email": "liuwu@example.com"
  },
  "hobby": ["バスケットボール", "旅行"]  
}

import OpenAI from "openai";

// モデルに期待される出力フォーマットを示すために、応答例を事前に定義
// 例 1：すべてのフィールドを含む完全な応答
const example1Response = JSON.stringify({
    info: { name: "佐藤太郎", age: "25歳", email: "sato.taro@example.com" },
    hobby: ["歌唱"]
}, null, 2);

// 例 2：複数の趣味を含む応答
const example2Response = JSON.stringify({
    info: { name: "鈴木花子", age: "30歳", email: "suzuki.hanako@example.com" },
    hobby: ["ダンス", "水泳"]
}, null, 2);

// 例 3：hobby フィールドのない応答。hobby フィールドはオプションです。
const example3Response = JSON.stringify({
    info: { name: "高橋健太", age: "28歳", email: "takahashi.kenta@example.com" }
}, null, 2);

// 例 4：hobby フィールドのない別の応答
const example4Response = JSON.stringify({
    info: { name: "伊藤さくら", age: "35歳", email: "ito.sakura@example.com" }
}, null, 2);

// OpenAI クライアント設定を初期化
const openai = new OpenAI({
    // シンガポールリージョンと北京リージョンの API キーは異なります。
    // 環境変数が設定されていない場合は、次の行を Alibaba Cloud Model Studio の API キーに置き換えてください：apiKey: "sk-xxx",
    apiKey: process.env.DASHSCOPE_API_KEY,
    // 以下はシンガポールリージョンの URL です。北京リージョンのモデルを使用する場合は、URL を https://dashscope.aliyuncs.com/compatible-mode/v1 に置き換えてください
    baseURL: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
});

// チャット補完リクエストを作成。構造化プロンプトを使用して出力の精度を向上させます。
const completion = await openai.chat.completions.create({
    model: "qwen-plus",
    messages: [
        {
            role: "system",
            content: `ユーザー入力から個人情報を抽出し、指定された JSON スキーマフォーマットで出力してください。

[出力フォーマット要件]
出力は、以下の JSON 構造に厳密に従う必要があります：
{
  "info": {
    "name": "文字列型、必須フィールド、名前",
    "age": "文字列型、必須フィールド、フォーマット：「[数字]歳」、例：「25歳」",
    "email": "文字列型、必須フィールド、標準的なメールフォーマット、例：「user@example.com」"
  },
  "hobby": ["文字列配列型、オプション。すべてのユーザーの趣味を含む。趣味が言及されていない場合は、このフィールドを省略してください。"]
}

[フィールド抽出ルール]
1. name：テキストから名前を特定し、抽出します。このフィールドは必須です。
2. age：年齢情報を特定し、「[数字]歳」のフォーマットに変換して抽出します。このフィールドは必須です。
3. email：メールアドレスを特定し、元のフォーマットを維持して抽出します。このフィールドは必須です。
4. hobby：趣味を特定し、文字列配列として出力します。趣味情報が言及されていない場合は、hobby フィールドを出力から完全に省略してください。

[参照例]
例 1 (趣味あり)：
Q: 私の名前は佐藤太郎、25歳、メールアドレスは sato.taro@example.com、趣味は歌唱です。
A: ${example1Response}

例 2 (複数の趣味あり)：
Q: 私の名前は鈴木花子、30歳、メールアドレスは suzuki.hanako@example.com、普段はダンスと水泳が好きです。
A: ${example2Response}

例 3 (趣味なし)：
Q: 私の名前は高橋健太、28歳、メールアドレスは takahashi.kenta@example.com です。
A: ${example3Response}

例 4 (趣味なし)：
Q: 私は伊藤さくら、35歳、メールアドレスは ito.sakura@example.com です。
A: ${example4Response}

前述のフォーマットとルールに厳密に従って情報を抽出し、JSON を出力してください。ユーザーが趣味について言及していない場合は、hobby フィールドを出力に含めないでください。`
        },
        {
            role: "user",
            content: "皆さん、こんにちは。私の名前は田中一郎、34歳です。メールアドレスは tanaka.ichiro@example.com で、普段はバスケットボールと旅行が好きです。"
        }
    ],
    response_format: {
        type: "json_object"
    }
});

// モデルによって生成された JSON 結果を抽出して出力
const jsonString = completion.choices[0].message.content;
console.log(jsonString);

実行結果

{
  "info": {
    "name": "Liu Wu",
    "age": "34歳",
    "email": "liuwu@example.com"
  },
  "hobby": [
    "バスケットボール",
    "旅行"
  ]
}

import os
import json
import dashscope
# 以下はシンガポールリージョンの URL です。中国 (北京) リージョンのモデルを使用する場合は、URL を https://dashscope.aliyuncs.com/api/v1 に置き換えてください。
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'

# モデルに期待される出力フォーマットを示すために、応答例を事前定義します。
example1_response = json.dumps(
    {
        "info": {"name": "John Doe", "age": "25 years old", "email": "johndoe@example.com"},
        "hobby": ["singing"]
    },
    ensure_ascii=False
)
example2_response = json.dumps(
    {
        "info": {"name": "Jane Smith", "age": "30 years old", "email": "janesmith@example.com"},
        "hobby": ["dancing", "swimming"]
    },
    ensure_ascii=False
)
example3_response = json.dumps(
    {
        "info": {"name": "Peter Jones", "age": "40 years old", "email": "peterjones@example.com"},
        "hobby": ["Rap", "basketball"]
    },
    ensure_ascii=False
)

messages=[
        {
            "role": "system",
            "content": f"""ユーザー入力から個人情報を抽出し、指定された JSON スキーマフォーマットで出力してください:

[出力フォーマット要件]
出力は、以下の JSON 構造に厳密に従う必要があります:
{{
  "info": {{
    "name": "文字列、必須、ユーザー名",
    "age": "文字列、必須、「数字 years old」のフォーマット (例: 「25 years old」)",
    "email": "文字列、必須、標準的な E メールフォーマット (例: 「user@example.com」)"
  }},
  "hobby": ["文字列配列、オプション、ユーザーのすべての趣味が含まれます。趣味について言及がない場合は、このフィールドを完全に省略してください。"]
}}

[フィールド抽出ルール]
1. name: テキストからユーザー名を特定します。このフィールドは必須です。
2. age: 年齢情報を特定し、「数字 years old」フォーマットに変換します。このフィールドは必須です。
3. email: E メールアドレスを特定し、元のフォーマットを維持します。このフィールドは必須です。
4. hobby: ユーザーの趣味を特定し、文字列配列として出力します。趣味に関する情報が言及されていない場合は、hobby フィールドを完全に省略してください。

[参照例]
例 1 (趣味が 1 つ含まれる場合):
Q: My name is John Doe, I am 25 years old, my email is johndoe@example.com, and my hobby is singing.
A: {example1_response}

例 2 (趣味が複数含まれる場合):
Q: My name is Jane Smith, I am 30 years old, my email is janesmith@example.com, and I like dancing and swimming.
A: {example2_response}

例 3 (趣味が複数含まれる場合):
Q: My email is peterjones@example.com, I am 40 years old, my name is Peter Jones, and I can rap and play basketball.
A: {example3_response}

上記のフォーマットとルールに厳密に従って情報を抽出し、JSON を出力してください。ユーザーが趣味について言及しなかった場合は、出力に hobby フィールドを含めないでください。"""
        },
        {
            "role": "user",
            "content": "Hello everyone, my name is Alex Brown, I am 34 years old, my email is alexbrown@example.com, and I like to play basketball and travel.", 
        },
    ]
response = dashscope.Generation.call(
    # 中国 (北京) リージョンのモデルを使用する場合は、中国 (北京) リージョン用の API キーを使用する必要があります。入手先: https://bailian.console.alibabacloud.com/?tab=model#/api-key
    # 環境変数が設定されていない場合は、次の行を Alibaba Cloud Model Studio API キーに置き換えてください: api_key="sk-xxx",
    api_key=os.getenv('DASHSCOPE_API_KEY'),
    model="qwen-plus", 
    messages=messages,
    result_format='message',
    response_format={'type': 'json_object'}
    )
json_string = response.output.choices[0].message.content
print(json_string)

実行結果

{
  "info": {
    "name": "Liu Wu",
    "age": "34歳",
    "email": "liuwu@example.com"
  },
  "hobby": [
    "バスケットボール",
    "旅行"
  ]
}

実行結果

{
  "info": {
    "name": "Liu Wu",
    "age": "34",
    "email": "liuwu@example.com"
  },
  "hobby": [
    "バスケットボール",
    "旅行"
  ]
}