Skip to main content

Generación de imágenes - Implementar modelo

Publique un modelo de generación de imágenes entrenado como un servicio de API en línea.

Requisitos previos

  • Regiones admitidas: La API de implementación de modelos actualmente está disponible solo en la región de Singapore. Si utiliza otras regiones, implemente los modelos a través de la consola de Model Studio en esa región.
  • Permisos de la cuenta: Si utiliza subcuentas de Alibaba Cloud (usuarios RAM), debe otorgar a la subcuenta los permisos de invocación, entrenamiento e implementación de modelos.
  • Configurar variables de entorno: Ha obtenido correctamente una API Key y la ha configurado como variable de entorno.
  • Requisito previo: El entrenamiento de ajuste fino del modelo se ha completado. Primero llame a la API Consultar trabajo de ajuste fino para confirmar que el estado del trabajo status es SUCCEEDED antes de proceder con la implementación.

Implementar modelo

  • Singapore
POST https://dashscope-intl.aliyuncs.com/api/v1/deployments
Para Windows CMD, reemplace $DASHSCOPE_API_KEY con %DASHSCOPE_API_KEY%. Para PowerShell, reemplace con $env:DASHSCOPE_API_KEY

Parámetros de solicitud

Encabezados
Content-Type string (Requerido)Valor fijo: application/jsonAuthorization string (Requerido)Autenticación mediante API Key, con el formato Bearer sk-xxxx.
Cuerpo de la solicitud
model_name string (Obligatorio)El ID del modelo a implementar (no el nombre del modelo base, sino el identificador del modelo generado después del ajuste fino o la exportación). Cómo obtenerlo:capacity integer (Obligatorio)El número de instancias de modelo implementadas. Valor recomendado: 1.plan string (Obligatorio)Método de implementación. Valor recomendado para el ajuste fino eficiente LoRA: lora.
  • Implementar 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"
}'

Parámetros de respuesta

request_id stringIdentificador único de la solicitud.output objectDetalles de la tarea.

Propiedades

deployed_model stringIdentificador único del modelo implementado. Se utiliza para consultar el estado de implementación del modelo e invocar el modelo.model_name stringNombre del identificador del modelo.status stringEstado de la implementación:
  • PENDING: Implementando.
  • RUNNING: En ejecución.
  • FAILED: Error en la implementación.
base_model stringEl modelo base utilizado.gmt_create stringHora de creación de la tarea de implementación.gmt_modified stringHora de actualización de la tarea de implementación.workspace_id stringEl ID del espacio de trabajo asociado con la API Key de Alibaba Cloud Model Studio. Consulte Obtener el ID del espacio de trabajo.charge_type stringModo de facturación. post_paid indica pago por uso.creator stringID de cuenta de Alibaba Cloud del creador.modifier stringID de cuenta de Alibaba Cloud del modificador.plan stringMétodo de implementación.
code stringCódigo de error. Se devuelve cuando la llamada falla.message stringDescripción detallada del error. Se devuelve cuando la llamada falla.
  • Ejemplo de respuesta exitosa
  • Ejemplo de respuesta de error
Campos clave: output.deployed_model (identificador único del modelo implementado), output.status (estado de la implementación).
{
    "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"
    }
}

Siguiente paso

La implementación es una operación asíncrona. Después de llamar a esta API, puede consultar el estado de la implementación a través de la API Consultar y gestionar implementaciones.