Image API 料金、使用制限、エラーコードの概要 - Model Studio

このトピックでは、イメージ API に関するよくある質問について説明します。これには、デバッグ、課金、レート制限、一般的な API エラーが含まれます。

このトピックで説明するイメージモデルには、Wan text-to-image V2、人物インスタンスセグメンテーション、イメージ消去補完があります。

API をローカルでデバッグする

イメージ API は HTTP 呼び出しをサポートしています。以下のセクションでは、Wan text-to-image API を例として使用し、HTTP API 呼び出しをローカルでデバッグする方法を示します。

モデルサービスをアクティブ化し、API キーを取得します。次に、API キーを環境変数として設定します。
イメージ API ドキュメントで curl コマンドを見つけます。

例：text-to-image の curl コマンド

curl -X POST https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wanx2.1-t2i-turbo",
    "input": {
        "prompt": "A flower shop with exquisite windows, a beautiful wooden door, and flowers on display"
    },
    "parameters": {
        "size": "1024*1024",
        "n": 1
    }
}'

macOS または Linux を使用している場合は、ターミナルで curl コマンドを実行します。
Windows を使用している場合は、Postman や Apifox などの API プラットフォームを使用して HTTP リクエストを送信します。

注: API プラットフォームを使用してリクエストを送信する場合、curl コマンド Bearer $DASHSCOPE_API_KEY 内の $DASHSCOPE_API_KEY を、実際の API キー (例: Bearer sk-xxxxxx) に置き換える必要があります。

課金とレート制限

課金の例

注: 表中の Image Model 1 と Image Model 2 は例であり、実際のモデル名ではありません。

モデル	無料クォータ（表示）	単価	レート制限 (Alibaba Cloud アカウントと RAM ユーザーで共有)
モデル	無料クォータ（表示）	単価	タスク送信の QPS 制限	同時タスク数
Image Model 1	500 イメージ	期間限定で無料	2	1
Image Model 2	500 イメージ	$0.02/イメージ	2	1

無料クォータ

説明: 無料クォータは、モデルによって正常に生成されたイメージの数に基づいています。入力イメージまたはモデル処理の失敗では、クォータは消費されません。
取得方法: 無料クォータは、Alibaba Cloud Model Studio サービスをアクティブ化すると自動的に付与され、90日間有効です。
使用方法: Alibaba Cloud アカウントとその RAM ユーザーは無料クォータを共有します。
詳細については、「新規ユーザー向けの無料クォータ」をご参照ください。

期間限定で無料

課金方法が「期間限定で無料」の場合、モデルはパブリックプレビュー中です。無料クォータを使い果たすと、モデルを使用できません。

課金説明

$0.02/イメージなどの特定の単価が提供されている場合、モデルは商用化されています。無料クォータを使い果たすか、有効期限が切れると、モデルの使用に対して課金されます。
課金対象項目: 正常に生成された出力イメージに対してのみ課金されます。その他の場合は料金は発生しません。
課金方法：料金はお客様の Alibaba Cloud アカウントに請求されます。RAM ユーザーは個別に計測または課金できません。RAM ユーザーを所有する Alibaba Cloud アカウントに、すべての利用が請求されます。課金情報を表示するには、Alibaba Cloud管理コンソールの[課金の概要]ページにアクセスしてください。
チャージ方法: Alibaba Cloud管理コンソールの経費とコストページで、アカウントに資金を追加できます。
モデル呼び出し統計: モデルの呼び出し量と回数を表示するには、Alibaba Cloud Model Studio プラットフォームのモニタリング (シンガポールまたは中国 (北京)) ページに移動します。
課金の詳細については、「課金対象項目」をご参照ください。

レート制限

説明: Alibaba Cloud アカウントとその RAM ユーザーはレート制限を共有します。

API エラー

イメージダウンロード失敗

シナリオ: ご自身のイメージ URL (ドキュメントのサンプル URL ではない) を使用して API をリクエストすると、「Reference image download failed, please check image url.」というエラーメッセージが返されます。

{
    "request_id": "657f0d1b-76d0-9e3e-b6d6-xxxxxx",
    "output": {
        "task_id": "5e6fa974-9a25-4271-8659-xxxxxx",
        "task_status": "FAILED",
        "code": "BadRequest.InputDownloadFailed",
        "message": "Reference image download failed, please check image url."
    }
}

考えられる原因: 入力イメージ URL が不正確であるか、アクセスできないか、またはダウンロード権限が制限されています。これにより、モデルサービスがイメージを正常にダウンロードできません。

ソリューション: イメージ URL が完全であり、パブリックネットワークアクセスを許可していることを確認してください。イメージを公開アクセス可能な自己管理型ストレージサービス、または OSS などのクラウドストレージサービスにアップロードできます。イメージ URL がパブリックネットワークアクセスを許可していることを確認してください。

タスク作成 API の curl コマンドが失敗する

シナリオ: ドキュメントからタスク作成 API の curl コマンドをコピーして実行すると、エラーが発生します。以下のイメージ背景生成モデルの curl コマンドを例として使用します。

例: イメージ背景生成のタスク作成 API の curl コマンド

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/background-generation/generation/' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "wanx-background-generation-v2",
    "input": {
        "base_image_url": "https://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/main_images/new_main_img/a.png",
        "ref_image_url": "http://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/ref_images/c5e50d27be534709817b2ab080b0162f_0.jpg",
        "ref_prompt": "mountains and sunset clouds",
        "reference_edge": {
            "foreground_edge": [
                "https://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/huaban_soft_edge/6cdd13941cef1b11d885aea1717b983ae566b8efc9094-vcsvxa_fw658webp.png",
                "http://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/ref_edge/2c36cc4b7da027279e87311dac48fc2d5d784b1e72c0e-x4f1wC_fw658webp.png"
            ],
            "background_edge": [
                "http://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/ref_edge/0718a9741e07c52ca5506e75c4f2b99e22fff68a4c7d3-P9WGLr_fw658webp.png"
            ],
            "foreground_edge_prompt": [
                "pink peach blossoms",
                "cute puppy"
            ],
            "background_edge_prompt": [
                "leaves"
            ]
        }
    },
    "parameters": {
        "n": 4,
        "ref_prompt_weight": 0.5,
        "model_version": "v3"
    }
}'

「Required body invalid, please check the request body format.」というエラーメッセージが返されます。

{
    "request_id": "d306ae65-3f6d-9d6c-acfb-xxxxxx",
    "code": "InvalidParameter",
    "message": "Required body invalid, please check the request body format."
}

考えられる原因: タスク作成 API のリクエストボディに中国語の文字が含まれています。curl コマンドを実行するクライアントが中国語の文字の解析をサポートしていない場合、リクエストボディが正しく解析されず、エラーが発生する可能性があります。

ソリューション: macOS または Linux を使用している場合は、ターミナルで curl コマンドを直接実行します。Windows を使用している場合は、Postman や Apifox などの HTTP API プラットフォームを使用してリクエストを送信します。

中国以外から API を呼び出す際のリソースダウンロードタイムアウト

シナリオ: 中国以外から API を呼び出し、イメージリソースが中国本土以外のリージョンに保存されている場合、リソースダウンロードタイムアウトエラーが発生する可能性があります。エラーメッセージは次のとおりです。

Download the media resource timed out during the data inspection process

主な原因: 中国本土以外のリージョンとサービスエンドポイント間のネットワークの不安定性により、サービスがイメージをダウンロードしようとしたときにタイムアウトが発生する可能性があります。

ソリューション: イメージリソースを中国本土内のリージョンに保存し、アクセラレーションを設定してください。Alibaba Cloud アカウントのイメージダウンロードタイムアウト期間は設定できないことに注意してください。