Skip to main content
Geração de Imagens

Image Generation - Deploy Model

Publique um modelo de geração de imagens treinado como um service de API online.

Pré-requisitos

  • Regiões suportadas: A API de implantação de modelos está disponível atualmente apenas na região Singapore. Caso utilize outras regiões, implante os modelos por meio do console do Model Studio nessa região.
  • Permissões da conta: Se você utilizar Alibaba Cloud sub-accounts (RAM users), será necessário conceder à subconta as permissions de invocação, treinamento e implantação de modelos.
  • Configure variáveis de ambiente: Você já obtained an API Key e configured it as an environment variable com sucesso.
  • Pré-requisito: O treinamento de ajuste fino do modelo foi concluído. Antes de prosseguir com a implantação, chame primeiro a API Query Fine-tuning Job para confirme se o status da tarefa status é SUCCEEDED.

Implantar modelo

China (Beijing)

POST https://dashscope.aliyuncs.com/api/v1/deployments
  • Singapore
POST https://dashscope-intl.aliyuncs.com/api/v1/deployments
No Windows CMD, substitua $DASHSCOPE_API_KEY por %DASHSCOPE_API_KEY% . No PowerShell, substitua por $env:DASHSCOPE_API_KEY

Parâmetros da requisição

  • Implantar modelo
curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/deployments' \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
    --header 'Content-Type: application/json' \
    --data '{
        "model_name": "<replace with model_name>",
        "capacity": 1,
        "plan": "lora"
    }'
Cabeçalhos
Content-Type string (Obrigatório)Valor fixo: application/json
Authorization string (Obrigatório)Autenticação via API Key, no formato Bearer sk-xxxx.
Corpo da requisição
model_name string (Obrigatório)ID do modelo a ser implantado (não o nome do modelo base, mas o identificador gerado após o ajuste fino ou exportação). Como obter:
  • Modelo ajustado: Utilize o valor de output.finetuned_output da resposta de Create Fine-tuning Job.
  • Modelo exportado: Utilize o valor de output[].model_name da resposta de Query Exported Model Details.
capacity integer (Obrigatório)Número de instâncias do modelo implantadas. Valor recomendado: 1.
plan string (Obrigatório)Método de implantação. Para ajuste fino eficiente LoRA, o valor recomendado é lora.

Parâmetros da resposta

  • Exemplo de resposta de sucesso
  • Exemplo de resposta de erro
Campos principais: output.deployed_model (identificador exclusivo do modelo implantado) e output.status (status da implantação).
{
        "request_id": "96020b2e-9072-4c8a-9981-xxxxxxxxx",
        "output": {
            "deployed_model": "wan2.7-image-pro-ft-202507011122-xxxx",
            "gmt_create": "2025-07-01T10:30:00.000",
            "gmt_modified": "2025-07-01T10:30:00.000",
            "status": "PENDING",
            "model_name": "wan2.7-image-pro-ft-202507011122-xxxx",
            "base_model": "wan2.7-image-pro",
            "workspace_id": "llm-xxxxxxxxx",
            "charge_type": "post_paid",
            "creator": "12xxxxxxx",
            "modifier": "12xxxxxxx",
            "plan": "lora"
        }
    }
request_id stringIdentificador exclusivo da requisição.
output objectDetalhes da tarefa.

Propriedades

deployed_model stringIdentificador exclusivo do modelo implantado. Utilizado para consultar o status da implantação e invocar o modelo.model_name stringNome identificador do modelo.status stringStatus da implantação:
  • PENDING: Em processo de implantação.
  • RUNNING: Em execução.
  • FAILED: Falha na implantação.
base_model stringModelo base utilizado.gmt_create stringHorário de criação da tarefa de implantação.gmt_modified stringHorário da última atualização da tarefa de implantação.workspace_id stringID do workspace associado à API Key do Alibaba Cloud Model Studio. Consulte Get the Workspace ID.charge_type stringModo de faturamento. post_paid indica pagamento conforme o uso.creator stringID da conta Alibaba Cloud do criador.modifier stringID da conta Alibaba Cloud do modificador.plan stringMétodo de implantação.
code stringCódigo de erro. Retornado quando a chamada falha.
message stringDescrição detalhada do erro. Retornado quando a chamada falha.

Próxima etapa

A implantação é uma operação assíncrona. Após chamar esta API, consulte o status da implantação por meio da API Query and Manage Deployments.
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
Image Generation - Deploy Model - Alibaba Cloud Model Studio