Skip to main content
Manajemen file

Unggah file

Unggah file ke platform Model Studio. Anda dapat mengunggah beberapa file sekaligus dan menggunakannya kembali di berbagai Pekerjaan.

Batas Penggunaan

Batas penggunaan berikut berlaku saat Anda menggunakan layanan ini:
  • Ukuran maksimum satu file bervariasi tergantung tujuan: 150 MB untuk file-extract, 500 MB untuk batch, dan 300 MB untuk fine-tune.
  • Kuota total storage space untuk file aktif (belum dihapus) adalah 100 GB.
  • Jumlah total file aktif (belum dihapus) dibatasi hingga 10.000.
Untuk panggilan yang kompatibel dengan OpenAI, lihat dokumentasi terkait.
File fine-tuning yang diunggah dengan tujuan fine-tune terlihat dan tersedia baik di halaman Penyempurnaan model Konsol Model Studio maupun dalam panggilan API.

Unggah file

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

Contoh permintaan

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"'

Parameter permintaan

Parameter

Tipe

Dalam

Wajib

Deskripsi

files

file stream

multipart/form-data

Ya

File yang akan diunggah. Anda dapat mengunggah beberapa file dalam satu permintaan.

purpose

string

multipart/form-data

Tidak

Nilai

Tujuan

fine-tune

Gunakan file_id yang diunggah untuk fine-tuning model. Data pelatihan untuk fine-tuning model generasi video atau gambar harus diunggah dalam format .zip (satu paket .zip tidak boleh melebihi 1 GB). Anda juga dapat memuat data dengan menggunakan OSS mount: unggah seluruh folder set data yang belum dikompresi ke OSS. File zip tidak didukung dalam kasus ini.

file-extract

Gunakan file_id yang diunggah untuk analisis konten.

batch

Gunakan file_id yang diunggah untuk membuat Pekerjaan batch.

Jika Anda tidak menentukan purpose, file tetap dapat diunggah dengan sukses. Kami menyarankan agar Anda secara eksplisit menentukan purpose untuk mengelola file berdasarkan penggunaannya nanti.

descriptions

file stream

multipart/form-data

Tidak

Deskripsi file.

Contoh respons

{
    "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."
            }
        ]
    }
}

Parameter respons

Parameter

Tipe

Deskripsi

data.failed_uploads

array

Informasi mengenai file yang gagal diunggah.

data.uploaded_files

array

Informasi mengenai file yang berhasil diunggah.

data.uploaded_files.$.file_id

string

ID file, yang dapat digunakan dalam API Retrieve file details dan Delete file.

data.uploaded_files.$.name

string

Nama file.

request_id

string

ID unik permintaan.

Respons kesalahan

Contoh respons

Kode status HTTP non-200 menunjukkan bahwa permintaan gagal. Berikut adalah contoh respons kesalahan.
{
    "request_id": "8f25f57c-5cc0-9881-9c83-62bc173dc9ad",
    "code": "InvalidParameter",
    "message": "File not found."
}

Parameter respons

Parameter

Tipe

Deskripsi

code

string

Kode kesalahan.

request_id

string

ID unik permintaan.

message

string

Pesan kesalahan.

Pembuatan Gambar
  • FAQ
Video Generation
Model Dunia
Audio
  • Pembuatan audio
Realtime API
Penyematan Teks
TokenPlan
Model production