Skip to main content

Integrar o modelo de geração de imagens

Chame um modelo de geração de imagens do Token Plan a partir de uma ferramenta do Agent, gere uma imagem a partir de uma descrição de texto e faça o download localmente.

Modelos compatíveis

ModeloDescrição
qwen-image-3.0-proQwen Image Generation and Editing 3.0 Pro, suporta texto para imagem e imagem para imagem
qwen-image-2.0-proQwen Image Generation 2.0 Pro (somente Team Edition)
qwen-image-2.0Qwen Image Generation 2.0 (somente Team Edition)
wan2.7-imageGeração de imagens Wan
wan2.7-image-proGeração de imagens Wan Pro
Para mais modelos, consulte modelos compatíveis com o Token Plan Personal Edition e modelos compatíveis com o Token Plan Team Edition.

Pré-requisitos

  • Uma assinatura do Token Plan e uma chave de API que comece com sk-sp-. Para detalhes, consulte Visão geral da integração.
  • Sua ferramenta de codificação de IA é compatível com Slash Commands. Para caminhos de configuração de outras ferramentas, consulte Outras ferramentas.

Interface

POST https://token-plan.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation Use Authorization: Bearer $ANTHROPIC_AUTH_TOKEN no cabeçalho da requisição. Para os campos do corpo da requisição e da resposta, consulte as seções abaixo.

Etapa 1: Criar um Slash Command

Configure a chave de API do Token Plan como a variável de ambiente $ANTHROPIC_AUTH_TOKEN. Crie .claude/commands/text-to-image.md na raiz do projeto e adicione o seguinte conteúdo:
Chame a API de geração de imagens do Token Plan para gerar uma imagem a partir de uma descrição e baixá-la localmente.

Descrição da imagem: $ARGUMENTS

## Etapas

1. Extraia o prompt (descrição da imagem), o modelo (padrão: qwen-image-3.0-pro) e o tamanho (padrão: 1024*1024) da descrição. Se a descrição especificar um modelo, use esse modelo.
2. Use a ferramenta Bash para executar o seguinte comando:
```bash
curl -s -X POST "https://token-plan.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<model>",
    "input": {"messages": [{"role": "user", "content": [{"text": "<prompt>"}]}]},
    "parameters": {"size": "<size>"}
  }'
```
3. Extraia a URL da imagem de `output.choices[0].message.content[0].image` no JSON da resposta.
4. Baixe a imagem com `curl -s -o "generated_$(date +%Y%m%d_%H%M%S).png" "<URL>"`.
5. Exiba o caminho do arquivo de imagem gerado.

Etapa 2: Gerar uma imagem

No Claude Code, insira /text-to-image draw a cat. Para usar outro modelo, especifique o modelo no comando, por exemplo /text-to-image use wan2.7-image to draw a cat.

Parâmetros da requisição

ParâmetroObrigatórioDescrição
modelSimID do modelo de geração de imagem.
input.messages[0].content[0].textSimDescrição da imagem.
parameters.sizeNãoTamanho da imagem, por exemplo 1024*1024. Se omitido, o modelo seleciona um tamanho automaticamente.
Para mais parâmetros, consulte API de geração e edição de imagens Qwen.

Resposta

  • URL da imagem: output.choices[0].message.content[0].image.
  • Uso: usage.image_count, usage.width, usage.height.
  • As URLs das imagens expiram. Baixe a imagem imediatamente.

Limites

  • Os tamanhos de imagem e os modelos suportados dependem da documentação de cada modelo.
  • A cobrança é baseada no número de imagens de saída. O consumo real de Credits é exibido em Usage no console.

Outras ferramentas

Para os mecanismos de extensão e caminhos de configuração de outras ferramentas, consulte Visão geral da integração. Salve o Slash Command acima no caminho correspondente.