Skip to main content

Cargar un archivo

Cargue archivos en la plataforma Model Studio. Puede cargar varios archivos a la vez y reutilizarlos en diferentes trabajos.

Esta interfaz está diseñada principalmente para la compatibilidad con escenarios históricos. Se recomienda priorizar la Interfaz de archivos compatible con OpenAI.

Límites de uso

Los siguientes límites de uso se aplican cuando utiliza este servicio:
  • El tamaño máximo de un solo archivo varía según el propósito: 150 MB para file-extract, 500 MB para batch y 300 MB para fine-tune.
  • La cuota total de almacenamiento para archivos activos (no eliminados) es de 100 GB.
  • El número total de archivos activos (no eliminados) está limitado a 10,000.
Para llamadas compatibles con OpenAI, consulte la documentación correspondiente.
Los archivos de ajuste fino cargados mediante el propósito fine-tune son visibles y están disponibles tanto en la página de ajuste fino de modelos de la consola de Model Studio como en las llamadas a la API.

Cargar un archivo 

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

Ejemplo de solicitud 

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

Parámetros de solicitud

Parámetro

Tipo

En

Obligatorio

Descripción

files

flujo de archivos

multipart/form-data

Sí

El archivo a cargar. Puede cargar varios archivos en una sola solicitud.

purpose

string

multipart/form-data

No

Valor

Propósito

fine-tune

Utilice el file_id cargado para el ajuste fino del modelo. Los datos de entrenamiento para ajustar modelos de generación de video o imágenes deben cargarse en formato .zip (un solo paquete .zip no debe exceder 1 GB). También puede cargar datos mediante montaje OSS: cargue toda la carpeta del conjunto de datos sin comprimir en OSS. En este caso no se admiten archivos zip.

file-extract

Utilice el file_id cargado para el análisis de contenido.

batch

Utilice el file_id cargado para crear un trabajo por lotes.

Si no especifica purpose, el archivo aún se puede cargar correctamente. Le recomendamos que especifique explícitamente purpose para gestionar los archivos por uso posteriormente.

descriptions

flujo de archivos

multipart/form-data

No

Una descripción del archivo.

Ejemplo de respuesta 

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

Parámetros de respuesta

Parámetro

Tipo

Descripción

data.failed_uploads

array

Información sobre archivos que no se pudieron cargar.

data.uploaded_files

array

Información sobre archivos cargados correctamente.

data.uploaded_files.$.file_id

string

El ID del archivo, que se puede utilizar en las API Obtener detalles del archivo y Eliminar archivo.

data.uploaded_files.$.name

string

El nombre del archivo.

request_id

string

El ID único de la solicitud.

Respuestas de error

Ejemplo de respuesta

Un código de estado HTTP distinto de 200 indica que la solicitud falló. A continuación se muestra un ejemplo de respuesta de error. 
{
    "request_id": "8f25f57c-5cc0-9881-9c83-62bc173dc9ad",
    "code": "InvalidParameter",
    "message": "File not found."
}

Parámetros de respuesta

Parámetro

Tipo

Descripción

code

string

El código de error.

request_id

string

El ID único de la solicitud.

message

string

El mensaje de error.