Alibaba Cloud Model Studio:FAQ

Como depurar chamadas à API de imagens localmente?

As APIs de imagens usam HTTP padrão. Este exemplo utiliza a API de texto para imagem Wan com curl.

1. Ative o serviço de modelo e obtenha uma chave de API e, em seguida, defina-a como variável de ambiente.

2. Localize o comando curl na documentação da API. Exemplo:

curl -X POST https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wanx2.1-t2i-turbo",
    "input": {
        "prompt": "A flower shop with exquisite windows, a beautiful wooden door, and flowers on display"
    },
    "parameters": {
        "size": "1024*1024",
        "n": 1
    }
}'

1. No macOS ou Linux, execute o comando diretamente no terminal.

2. No Windows, use uma plataforma de API como Postman ou Apifox para enviar a solicitação HTTP.

Nota: Ao usar uma plataforma de API, substitua $DASHSCOPE_API_KEY no cabeçalho Authorization pela sua chave de API real, por exemplo, Bearer sk-xxxxxx .

Como funciona o faturamento dos modelos de imagem?

Cada modelo de imagem tem uma cota gratuita e pode ter um preço por imagem:

A cota gratuita e os limites de taxa são compartilhados entre a conta Alibaba Cloud e todos os usuários RAM.

O que significa "gratuito por tempo limitado"?

O modelo está em visualização pública. Após o esgotamento da cota gratuita, o modelo fica indisponível.

O que conta como imagem faturável?

Somente imagens geradas com sucesso são faturadas. Imagens de entrada e solicitações com falha não consomem cota nem geram cobranças.

Como obtenho a cota gratuita?

A cota gratuita é concedida automaticamente ao ativar o Model Studio. Ela tem validade de 90 dias e é compartilhada entre a conta e todos os usuários RAM.

Para mais detalhes, consulte Cota gratuita para novos usuários.

Quando começam as cobranças pagas?

Modelos com preço unitário específico (por exemplo, $0,02/imagem) são comercializados. As cobranças iniciam após o esgotamento ou expiração da cota gratuita.

As taxas são faturadas na conta Alibaba Cloud — todo o uso é consolidado na conta principal.

• Visualizar faturas: Acesse a página Billing Overview no Alibaba Cloud Management Console.

• Adicionar fundos: Acesse a página Expenses and Costs.

• Monitorar uso: Verifique a página Monitoring na plataforma Model Studio (Singapore | Beijing).

Para detalhes completos sobre faturamento, consulte Itens faturáveis.

BadRequest.InputDownloadFailed: "Reference image download failed"

{
    "request_id": "657f0d1b-76d0-9e3e-b6d6-xxxxxx",
    "output": {
        "task_id": "5e6fa974-9a25-4271-8659-xxxxxx",
        "task_status": "FAILED",
        "code": "BadRequest.InputDownloadFailed",
        "message": "Reference image download failed, please check image url."
    }
}

Causa: A URL da imagem está incorreta, inacessível ou possui restrição de acesso. O serviço baixa a imagem da URL durante o processamento.

Solução: Verifique se a URL está completa e acessível publicamente. Se a imagem exigir autenticação, faça upload dela em um serviço de armazenamento público, como o OSS, e utilize a nova URL.

InvalidParameter: "Required body invalid"

{
    "request_id": "d306ae65-3f6d-9d6c-acfb-xxxxxx",
    "code": "InvalidParameter",
    "message": "Required body invalid, please check the request body format."
}

Causa: O corpo da solicitação curl contém caracteres chineses que o cliente não consegue analisar.

Solução: No macOS ou Linux, execute curl diretamente no terminal (que lida com UTF-8 nativamente). No Windows, use uma plataforma de API como Postman ou Apifox.

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/background-generation/generation/' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "wanx-background-generation-v2",
    "input": {
        "base_image_url": "https://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/main_images/new_main_img/a.png",
        "ref_image_url": "http://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/ref_images/c5e50d27be534709817b2ab080b0162f_0.jpg",
        "ref_prompt": "mountains and sunset clouds",
        "reference_edge": {
            "foreground_edge": [
                "https://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/huaban_soft_edge/6cdd13941cef1b11d885aea1717b983ae566b8efc9094-vcsvxa_fw658webp.png",
                "http://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/ref_edge/2c36cc4b7da027279e87311dac48fc2d5d784b1e72c0e-x4f1wC_fw658webp.png"
            ],
            "background_edge": [
                "http://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/ref_edge/0718a9741e07c52ca5506e75c4f2b99e22fff68a4c7d3-P9WGLr_fw658webp.png"
            ],
            "foreground_edge_prompt": [
                "pink peach blossoms",
                "cute puppy"
            ],
            "background_edge_prompt": [
                "leaves"
            ]
        }
    },
    "parameters": {
        "n": 4,
        "ref_prompt_weight": 0.5,
        "model_version": "v3"
    }
}'

Tempo limite de download de recursos fora da China continental

Download the media resource timed out during the data inspection process

Causa: A instabilidade de rede entre regiões fora da China continental e o endpoint do serviço DashScope provoca tempos limite de download.

Solução: Armazene os recursos de imagem dentro da China continental e configure a aceleração. O período de tempo limite não é configurável.