Skip to main content

ファイルのアップロード

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

制限事項

このサービスを使用する際には、以下の制限事項が適用されます。
  • 単一ファイルの最大サイズは目的によって異なります。file-extract の場合は 150 MB、batch の場合は 500 MB、fine-tune の場合は 300 MB です。
  • アクティブな (削除されていない) ファイルの合計ストレージクォータは 100 GB です。
  • アクティブな (削除されていない) ファイルの合計数は 10,000 に制限されます。
OpenAI 互換の呼び出しについては、関連ドキュメントをご参照ください。
fine-tune の目的でアップロードされたファインチューニングファイルは、Model Studio コンソールのモデルファインチューニングページと API 呼び出しの両方で表示および利用可能です。

ファイルのアップロード 

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

文字列

エラーメッセージです。