Skip to main content

Upload a file

Importez des fichiers sur la plateforme Model Studio. Vous pouvez en importer plusieurs simultanément et les réutiliser dans différentes tâches.

Limites d'utilisation

Ce service est soumis aux limites suivantes :
  • La taille maximale d'un fichier unique varie selon l'usage : 150 Mo pour file-extract, 500 Mo pour batch et 300 Mo pour fine-tune.
  • Le quota de stockage total des fichiers actifs (non supprimés) est de 100 Go.
  • Le nombre total de fichiers actifs (non supprimés) est limité à 10 000.
Pour les appels compatibles avec OpenAI, consultez la documentation correspondante.
Les fichiers de fine-tuning importés avec le paramètre purpose fine-tune sont visibles et disponibles à la fois sur la page de fine-tuning de modèle de la console Model Studio et via les appels API.

Importer un fichier

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

Exemple de requête

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

Paramètres de la requête

Paramètre

Type

In

Obligatoire

Description

files

file stream

multipart/form-data

Oui

Fichier à importer. Vous pouvez importer plusieurs fichiers en une seule requête.

purpose

string

multipart/form-data

Non

Valeur

Usage

fine-tune

Utilisez le file_id importé pour le fine-tuning de modèle. Les données d'entraînement pour le fine-tuning des modèles de génération vidéo ou d'image doivent être importées au format .zip (un seul package .zip ne doit pas dépasser 1 Go). Vous pouvez également charger les données via un montage OSS : importez le dossier complet du jeu de données non compressé vers OSS. Les fichiers Zip ne sont pas pris en charge dans ce cas.

file-extract

Utilisez le file_id importé pour l'analyse de contenu.

batch

Utilisez le file_id importé pour créer une tâche batch.

Si vous ne spécifiez pas le paramètre purpose, le fichier sera tout de même importé avec succès. Nous vous recommandons de spécifier explicitement ce paramètre afin de faciliter la gestion ultérieure des fichiers par usage.

descriptions

file stream

multipart/form-data

Non

Description du fichier.

Exemple de réponse

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

Paramètres de la réponse

Paramètre

Type

Description

data.failed_uploads

array

Informations sur les fichiers dont l'importation a échoué.

data.uploaded_files

array

Informations sur les fichiers importés avec succès.

data.uploaded_files.$.file_id

string

ID du fichier, utilisable dans les API de récupération des détails et de suppression de fichier.

data.uploaded_files.$.name

string

Nom du fichier.

request_id

string

ID unique de la requête.

Réponses d'erreur

Exemple de réponse

Un code de statut HTTP différent de 200 indique l'échec de la requête. Voici un exemple de réponse d'erreur.
{
    "request_id": "8f25f57c-5cc0-9881-9c83-62bc173dc9ad",
    "code": "InvalidParameter",
    "message": "File not found."
}

Paramètres de la réponse

Paramètre

Type

Description

code

string

Code d'erreur.

request_id

string

ID unique de la requête.

message

string

Message d'erreur.