Skip to main content
Geração de Imagens

FAQ

Dúvidas comuns sobre as APIs de imagens no Alibaba Cloud Model Studio, abordando depuração, faturamento, limites de taxa e erros de API.

Depuração

Como depurar chamadas à API de imagens localmente?

As APIs de imagens usam o protocolo HTTP padrão. Este exemplo usa a API de texto para imagem Wan com curl.
  1. Ative o service do modelo e obtenha uma chave de API e, em seguida, defina-a como uma 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 requisiçã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 .

Faturamento e limites de taxa

Como funciona o faturamento dos modelos de imagem?

Cada modelo de imagem tem uma cota gratuita e pode ter um preço por imagem gerada:
ModeloCota gratuitaPreço unitárioLimite de QPS para envio de tarefasNúmero de tarefas simultâneas
Image Model 1500 imagensGratuito por tempo limitado21
Image Model 2500 imagens$0,02/imagem21
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 preview público. Após o esgotamento da cota gratuita, o modelo fica indisponível.

O que é considerado uma imagem faturável?

Somente as imagens geradas com sucesso são faturadas. Imagens de entrada e requisiçõ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 Free quota for new users.

Quando começam as cobranças pagas?

Modelos com preço unitário definido (por exemplo, $0,02/imagem) são comercializados. As cobranças iniciam após o esgotamento ou expiração da cota gratuita. Os valores são faturados na conta Alibaba Cloud — todo o uso é consolidado na conta principal. Para informações completas sobre faturamento, consulte Billable items.

Erros de API

Erros comuns da API de imagens e soluções:

Código de erro

Mensagem

Causa típica

BadRequest.InputDownloadFailed

Reference image download failed

URL da imagem incorreta, inacessível ou com restrição de acesso

InvalidParameter

url error, please check url

O parâmetro model está definido com o nome de um modelo de geração de texto em vez de um modelo de geração de imagem

InvalidParameter

Required body invalid

O corpo da requisição contém caracteres chineses que o cliente não consegue analisar

(Timeout)

Download the media resource timed out

Instabilidade de rede entre regiões fora da China continental e o endpoint do service

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 service 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 para um service de armazenamento público, como o OSS, e use a nova URL.

InvalidParameter: "url error" 

{
    "code": "InvalidParameter",
    "message": "url error, please check url！"
}
Causa: O parâmetro model não corresponde ao endpoint chamado. O endpoint de síntese de imagens (/api/v1/services/aigc/text2image/image-synthesis) aceita apenas nomes de modelos de geração de imagem. Um nome de modelo de geração de texto, como qwen-turbo, é rejeitado com url error, mesmo que a URL da requisição esteja correta. No modo compatível com OpenAI, um nome de modelo de geração de texto retorna uma resposta vazia. Solução: Defina model com o nome de um modelo de geração de imagem, como wanx2.1-t2i-turbo, e chame o endpoint de forma assíncrona. 
curl -X POST https://{WorkspaceId}.cn-beijing.maas.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 cute cat"
    },
    "parameters": {
        "size": "1024*1024",
        "n": 1
    }
}'
A geração de imagens é assíncrona. A chamada de criação de tarefa retorna um task_id. Consulte periodicamente GET /api/v1/tasks/{task_id} até que task_status se torne SUCCEEDED para obter a URL da imagem gerada.

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 requisiçã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 nativamente com UTF-8). 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"
    }
}'

Timeout 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 service DashScope provoca timeouts de download. Solução: Armazene os recursos de imagem dentro da China continental e configure a aceleração. O período de timeout não é configurável.
Uso da API
Referência da API de Geração de Texto
Geração de Imagens
  • FAQ
Geração de Vídeo
Áudio
Multimodal em Tempo Real
API em tempo real
Incorporação de Texto
Mais Modelos
Toolkit/Framework
Produção de Modelos
File Management
Gerenciamento de modelos
Mais