AddFile - Alibaba Cloud Model Studio - Alibaba Cloud Documentation Center

Deskripsi operasi

Pengguna Resource Access Management (RAM) harus terlebih dahulu memperoleh izin API untuk Alibaba Studio Model Studio (memerlukan AliyunBailianDataFullAccess, yang mencakup izin sfm:AddFile), dan bergabung dengan ruang kerja sebelum memanggil operasi ini. Akun Alibaba Cloud dapat memanggil operasi ini secara langsung tanpa otorisasi. Panggil operasi ini dengan menggunakan Alibaba Studio Model Studio SDK terbaru.
Operasi ini tidak idempoten.

Pembatasan kecepatan: Operasi ini tunduk pada pembatasan kecepatan. Jangan melebihi 10 panggilan per detik. Jika Anda dibatasi kecepatannya, coba lagi nanti.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

sfm:AddFile

create

*All Resource

*

None

Sintaks permintaan

PUT /{WorkspaceId}/datacenter/file HTTP/1.1

Path Parameters

Parameter	Type	Required	Description	Example
WorkspaceId	string	Yes	ID ruang kerja. File diunggah ke ruang kerja ini. Untuk informasi tentang cara mendapatkan ID ruang kerja, lihat Cara menggunakan ruang kerja.	llm-3shx2gu255oqxxxx

Parameter permintaan

Parameter	Type	Required	Description	Example
LeaseId	string	Yes	ID lease unggahan, yang sesuai dengan `FileUploadLeaseId` yang dikembalikan oleh operasi ApplyFileUploadLease.	68abd1dea7b6404d8f7d7b9f7fbd332d.17166xxxxxxxx
Parser	string	Yes	Tipe parser. Nilai valid: DOCMIND: penguraian dokumen cerdas DOCMIND_DIGITAL: penguraian dokumen elektronik DOCMIND_LLM_VERSION: penguraian dokumen model bahasa tingkat tinggi DASH_QWEN_VL_PARSER: penguraian Qwen VL DOCMIND_LLM_VERSION_MEDIA: penguraian audio dan video AUTO_SELECT: pemilihan parser otomatis Catatan File yang diunggah diurai menggunakan parser yang saat ini ditentukan. Jika Anda menetapkan parameter ini ke AUTO_SELECT, parser yang dikonfigurasi untuk kategori akan digunakan.	AUTO_SELECT
CategoryId	string	Yes	Tetapkan parameter ini ke ID kategori file yang diunggah, yaitu `CategoryId` yang dikembalikan oleh operasi AddCategory. Anda juga dapat masuk ke Data Aplikasi, klik tab File, lalu klik ikon ID di sebelah nama kategori untuk mendapatkan ID kategori. Anda dapat menetapkan parameter ini ke default untuk menggunakan kategori default yang dibuat sistem.	cate_cdd11b1b79a74e8bbd675c356a91ee35xxxxxxxx
Tags	array	No	Daftar tag yang terkait dengan file. Anda dapat menentukan hingga 100 tag, dan total panjang karakter dari semua tag tidak boleh melebihi 700. Nilai default: kosong, yang berarti tidak ada tag yang ditetapkan.
	string	No	Tag file. Setiap tag dapat berisi hingga 32 karakter. Tag mendukung karakter dalam kategori huruf Unicode (termasuk huruf Inggris, karakter Tionghoa, dan angka), garis bawah (_), dan tanda hubung (-).	产品介绍
CategoryType	string	No	Tipe kategori. Parameter ini opsional. Nilai default: UNSTRUCTURED. Nilai valid: UNSTRUCTURED: kategori yang digunakan untuk membangun skenario Basis pengetahuan.	UNSTRUCTURED
OriginalFileUrl	string	No	Menentukan URL untuk file. Sistem mencatat URL ini saat membangun basis pengetahuan pencarian dokumen. Saat Anda menggunakan konsol Alibaba Studio Model Studio untuk berinteraksi dengan aplikasi agen, URL ini dikembalikan bersama hasil pengambilan file melalui bidang `docUrl`. Catatan Aplikasi agen harus memiliki Basis pengetahuan diaktifkan dan fitur Tampilkan sumber jawaban dinyalakan. Jika tidak, parameter ini tidak berlaku.	www.test.com/111.docx
ParserConfig	object	No	Konfigurasi parser. Parameter ini diperlukan hanya ketika tipe parser diatur ke penguraian Qwen VL.
ModelName	string	No	Nama model.	qwen-vl-max
ModelPrompt	string	No	Prompt yang digunakan saat memanggil penguraian Qwen VL.	#角色你是一个专业的图片内容标注人员，擅长识别并描述出图片中的内容。 # 任务目标请结合输入图片，详细描述图片中的内容。

Elemen respons

Element	Type	Description	Example
	object	Skema respons.
Code	string	Kode kesalahan.	DataCenter.FileTooLarge
Data	object	Bidang data yang dikembalikan oleh operasi.
FileId	string	ID file. Simpan nilai ini dengan aman karena digunakan dalam semua operasi API berikutnya yang terkait dengan file ini.	file_9a65732555b54d5ea10796ca5742ba22_xxxxxxxx
Parser	string	Tipe parser yang digunakan untuk mengurai file. Nilai valid: DASHSCOPE_DOCMIND: Penguraian dokumen cerdas Alibaba Cloud.	DASHSCOPE_DOCMIND
Message	string	Paket kesalahan.	User not authorized to operate on the specified resource.
RequestId	string	ID permintaan.	778C0B3B-xxxx-5FC1-A947-36EDD13606AB
Status	string	Kode status yang dikembalikan oleh operasi.	200
Success	string	Apakah panggilan berhasil. Nilai valid: true: Panggilan berhasil. false: Panggilan gagal.	true

Contoh

Respons sukses

JSONformat

{
  "Code": "DataCenter.FileTooLarge",
  "Data": {
    "FileId": "file_9a65732555b54d5ea10796ca5742ba22_xxxxxxxx",
    "Parser": "DASHSCOPE_DOCMIND"
  },
  "Message": "User not authorized to operate on the specified resource.",
  "RequestId": "778C0B3B-xxxx-5FC1-A947-36EDD13606AB",
  "Status": "200",
  "Success": "true"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.