Skip to main content
File Management

Upload a file

Faça upload de arquivos para a plataforma Model Studio. É possível enviar vários arquivos simultaneamente e reutilizá-los em diferentes jobs.

Limites de uso

Os seguintes limites de uso se aplicam ao utilizar este service:
  • O tamanho máximo de um único arquivo varia conforme a finalidade: 150 MB para file-extract, 500 MB para batch e 300 MB para fine-tune.
  • A cota total de armazenamento para arquivos ativos (não excluídos) é de 100 GB.
  • O número total de arquivos ativos (não excluídos) está limitado a 10.000.
Para chamadas compatíveis com OpenAI, consulte a documentação relevante.
Arquivos de fine-tuning enviados com a finalidade fine-tune ficam visíveis e disponíveis tanto na página de ajuste fino de modelos do console do Model Studio quanto nas chamadas de API.

Fazer upload de um arquivo

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

Exemplo de solicitação

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 da solicitação

Parâmetro

Tipo

Em

Obrigatório

Descrição

files

file stream

multipart/form-data

Sim

Arquivo a ser enviado. É possível fazer upload de múltiplos arquivos em uma única solicitação.

purpose

string

multipart/form-data

Não

Valor

Finalidade

fine-tune

Utilize o file_id enviado para ajuste fino de modelos. Os dados de treinamento para modelos de geração de vídeo ou imagem devem ser enviados no formato .zip (um único pacote .zip não pode exceder 1 GB). Também é possível carregar dados via montagem OSS: faça upload de toda a pasta do conjunto de dados descompactada para o OSS. Arquivos zip não são suportados neste caso.

file-extract

Use o file_id enviado para análise de conteúdo.

batch

Empregue o file_id enviado para create a batch job.

Caso você não especifique purpose, o arquivo ainda será enviado com sucesso. Recomendamos especificar purpose explicitamente para facilitar o gerenciamento posterior dos arquivos por uso.

descriptions

file stream

multipart/form-data

Não

Descrição do arquivo.

Exemplo de resposta

{
    "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 da resposta

Parâmetro

Tipo

Descrição

data.failed_uploads

array

Informações sobre arquivos que falharam no upload.

data.uploaded_files

array

Detalhes dos arquivos enviados com sucesso.

data.uploaded_files.$.file_id

string

ID do arquivo, utilizável nas APIs de recuperação de detalhes e exclusão de arquivos.

data.uploaded_files.$.name

string

Nome do arquivo.

request_id

string

ID exclusivo da solicitação.

Respostas de erro

Exemplo de resposta

Um código de status HTTP diferente de 200 indica falha na solicitação. Veja abaixo um exemplo de resposta de erro.
{
    "request_id": "8f25f57c-5cc0-9881-9c83-62bc173dc9ad",
    "code": "InvalidParameter",
    "message": "File not found."
}

Parâmetros da resposta

Parâmetro

Tipo

Descrição

code

string

Código do erro.

request_id

string

ID exclusivo da solicitação.

message

string

Mensagem de erro.

Referência da API de Geração de Texto
Geração de Imagens
  • FAQ
Geração de Vídeo
Áudio
API em tempo real
Incorporação de Texto
Produção de Modelos
Upload a file - Alibaba Cloud Model Studio