Alibaba Cloud Model Studio:ファイルのアップロード

Model Studio プラットフォームにファイルをアップロードします。複数のファイルを一度にアップロードでき、異なるジョブで再利用できます。

制限事項

このサービスを使用する際には、以下の制限事項が適用されます。

• 単一ファイルの最大サイズは目的によって異なります。file-extract の場合は 150 MB、batch の場合は 500 MB、fine-tune の場合は 300 MB です。
• アクティブな (削除されていない) ファイルの合計ストレージクォータは 100 GB です。
• アクティブな (削除されていない) ファイルの合計数は 10,000 に制限されます。

OpenAI 互換の呼び出しについては、関連ドキュメントをご参照ください。

ファイルのアップロード

POST https://dashscope-intl.aliyuncs.com/api/v1/files
Content-type: multipart/form-data

リクエスト例

curl --request POST "https://dashscope-intl.aliyuncs.com/api/v1/files" \
  --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
  --form 'files=@"/path/to/your/file1.jsonl"' \
  --form 'purpose="fine-tune"'\
  --form 'descriptions="a sample fine-tune data file for qwen"' \
  --form 'files=@"/path/to/your/file2.jsonl"' \
  --form 'purpose="fine-tune"'\
  --form 'descriptions="a sample fine-tune data file for qwen"'

リクエストパラメーター

パラメーター	型	場所	必須	説明
files	ファイルストリーム	multipart/form-data	はい	アップロードするファイルです。1 つのリクエストで複数のファイルをアップロードできます。
purpose	文字列	multipart/form-data	いいえ	値 目的 fine-tune アップロードされた file_id をモデルのファインチューニングに使用します。ビデオまたはイメージ生成モデルのファインチューニング用のトレーニングデータは、.zip フォーマットでアップロードする必要があります (単一の .zip パッケージは 1 GB を超えることはできません)。OSS マウントを使用してデータをロードすることもできます。この場合、圧縮されていないデータセットフォルダ全体を OSS にアップロードします。Zip ファイルはサポートされていません。 file-extract アップロードされた file_id をコンテンツ分析に使用します。 batch アップロードされた file_id を使用してバッチジョブを作成します。 purpose を指定しなくても、ファイルのアップロードは成功します。後で使用状況に応じてファイルを管理するために、purpose を明示的に指定することを推奨します。
descriptions	ファイルストリーム	multipart/form-data	いいえ	ファイルの説明です。

応答例

{
    "request_id": "xxx",
    "data": {
        "uploaded_files": [
            {
                "file_id": "9G2EaQtq7p1fw7oRhYXdHTtDFYAMVQSh95432B38CAB211EDB8F952C2E8001733",
                "name": "test.txt"
            }
        ],
        "failed_uploads": [
            {
                "name": "test1.jpg",
                "code": "BadRequest.TooLarge",
                "message": "Out of space, <839> B of <1024> B storage space has been used."
            },
            {
                "name": "test2.jpg",
                "code": "BadRequest.TooMany",
                "message": "Out of number, <10> of <10> files has been uploaded."
            }
        ]
    }
}

応答パラメーター

パラメーター	型	説明
data.failed_uploads	配列	アップロードに失敗したファイルに関する情報です。
data.uploaded_files	配列	正常にアップロードされたファイルに関する情報です。
data.uploaded_files.$.file_id	文字列	ファイル ID です。ファイル詳細の取得 API およびファイルの削除 API で使用できます。
data.uploaded_files.$.name	文字列	ファイル名です。
request_id	文字列	リクエストの一意の ID です。

エラー応答

応答例

200 以外の HTTP ステータスコードは、リクエストが失敗したことを示します。以下はエラー応答の例です。

{
    "request_id": "8f25f57c-5cc0-9881-9c83-62bc173dc9ad",
    "code": "InvalidParameter",
    "message": "File not found."
}

応答パラメーター

パラメーター	型	説明
code	文字列	エラーコードです。
request_id	文字列	リクエストの一意の ID です。
message	文字列	エラーメッセージです。