Entenda a API de geração de imagens, a escolha do modelo, a configuração dos parâmetros e as formas de chamada.

A geração de imagens com os modelos da Guishu já está disponível. Seja para capas de contas oficiais, imagens de produtos, ícones de aplicativos, fotos de mercadorias ou ilustrações automáticas por Agent, você pode gerar tudo diretamente por uma API unificada. API de geração de imagens: POST https://api.llm-token.cn/v1/images/generations

1. Resumo: prepare estes 3 itens e comece a usar ✨

O que você precisa preparar	Como preencher
Chave da Guishu Token	No cabeçalho da solicitação, informe `Authorization: Bearer 你的new-api-token`
API de geração de imagens	`https://api.llm-token.cn/v1/images/generations`
Modelo de geração de imagens	`image-01` ou `image-01-live`

Os modelos da Guishu já unificam a integração dos modelos, a adaptação da API, a gestão da cota e as regras de cobrança. Você só precisa usar sua própria chave da Guishu Token para acessar a geração de imagens por uma única API.

2. Comece em 1 minuto: exemplo com curl 🚀

Substitua YOUR_NEW_API_TOKEN abaixo pela sua própria chave da Guishu Token para fazer um teste direto.

curl https://api.llm-token.cn/v1/images/generations \
  -H "Authorization: Bearer YOUR_NEW_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image-01",
    "prompt": "一张可爱的蓝色 AI 小机器人图标，白色背景，极简 3D 风格，居中构图，不要文字",
    "response_format": "url",
    "n": 1,
    "aspect_ratio": "1:1",
    "prompt_optimizer": false
  }'

No primeiro teste, recomendamos gerar apenas 1 imagem, ou seja, usar n: 1. Depois de confirmar que a geração funciona normalmente, ajuste a proporção, o estilo e a quantidade conforme necessário.

3. Como preencher os parâmetros da solicitação? 🧩

Parâmetro	Obrigatório	Valor comum	Descrição
`model`	Sim	`image-01`	Nome do modelo de geração de imagens. Se você precisar de uma geração mais imediata, também pode usar `image-01-live`.
`prompt`	Sim	Preencha de acordo com a imagem desejada	Descreva a imagem que você quer gerar. Recomendamos especificar o tema, o estilo, as cores, a composição e a finalidade.
`response_format`	Não	`url`	Recomendamos usar `url`, que retorna diretamente o link da imagem. Você também pode usar `base64`, conforme as necessidades do seu projeto.
`n`	Não	`1`	Quantidade de imagens geradas por vez. Para testes comuns, comece com `1`.
`aspect_ratio`	Não	`1:1`	Proporção da imagem. Valores comuns: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `21:9`.
`prompt_optimizer`	Não	`false`	Define se a otimização do prompt será ativada. Se você quiser que a geração siga o texto original com mais rigor, recomendamos usar `false`.
`seed`	Não	Número inteiro	Ajuda a melhorar a reprodutibilidade. Para gerar resultados semelhantes várias vezes, você pode manter o mesmo seed.
`width` / `height`	Não	Geralmente desnecessário	Na maioria dos casos, basta usar `aspect_ratio`. Envie esses parâmetros apenas quando precisar de largura e altura exatas.

Se a resposta contiver uma URL da imagem, salve o arquivo logo após a geração. O link é adequado para visualização temporária e download, mas não deve ser usado como endereço permanente do material.

4. Por que é mais simples usar os modelos da Guishu? 🍬

Em uma integração comum, você frequentemente precisa alternar entre várias plataformas de modelos, cada uma com chaves, APIs e formas de cobrança diferentes, o que torna o desenvolvimento e a manutenção mais trabalhosos.

Os modelos da Guishu unificam tudo isso. Você só precisa de uma chave da Guishu Token para chamar a geração de imagens por uma API unificada. O consumo, os multiplicadores e o saldo seguem as informações exibidas no painel da Guishu Token, tornando a gestão mais clara e simples.

Recurso	Descrição
API unificada	Toda geração de imagens usa `https://api.llm-token.cn/v1/images/generations`, simplificando a integração.
Chave unificada	Use o `new-api-token` gerado no painel da Guishu Token, sem precisar alternar entre várias plataformas.
Cobrança unificada	Consumo, multiplicadores e saldo seguem as informações exibidas no painel da Guishu Token, facilitando a gestão de custos pela equipe.
Ideal para integração com produtos	Indicado para imagens de contas oficiais, fotos de mercadorias, capas de produtos, ilustrações automáticas por Agent, geração de materiais em lote e outros cenários.

Em resumo: com a Guishu Token e uma única API, você integra a geração de imagens ao seu produto e ao seu fluxo de trabalho.

5. Como usar o image-01-live? ⚡

O image-01-live usa a mesma API de geração de imagens. Os demais parâmetros permanecem inalterados; basta mudar model para image-01-live.

{
  "model": "image-01-live",
  "prompt": "一张赛博风格的蓝色产品宣传图，干净背景，科技感，适合公众号封面",
  "response_format": "url",
  "n": 1,
  "aspect_ratio": "16:9",
  "prompt_optimizer": false
}

Se esse modelo estiver habilitado na sua conta, você poderá chamá-lo diretamente dessa forma.

6. Exemplo em Python: use no seu projeto 🐍

import requests

url = "https://api.llm-token.cn/v1/images/generations"
headers = {
    "Authorization": "Bearer YOUR_NEW_API_TOKEN",
    "Content-Type": "application/json",
}
payload = {
    "model": "image-01",
    "prompt": "一张科技感很强的蓝色应用图标，白色背景，极简 3D 风格，居中构图，不要文字",
    "response_format": "url",
    "n": 1,
    "aspect_ratio": "1:1",
    "prompt_optimizer": False,
}

resp = requests.post(url, headers=headers, json=payload, timeout=120)
resp.raise_for_status()
print(resp.json())

A geração de imagens leva mais tempo do que uma conversa de texto comum. Recomendamos configurar o timeout do cliente para cerca de 120 segundos, evitando que a solicitação seja interrompida antes de a imagem ficar pronta.

7. Como descrever uma imagem para obter resultados melhores? 🪄

Ao descrever uma imagem, você pode seguir esta ordem para obter resultados mais consistentes:

Tema: o que você quer representar, como “robô de AI azul” ou “pôster de análise da Copa do Mundo”.
Cenário: onde o tema aparece, como “fundo branco”, “sob as luzes de um estádio” ou “mesa de escritório”.
Estilo: minimalista, realista, 3D, ilustração, pôster comercial, aparência fotográfica e assim por diante.
Composição: centralizada, vista de cima, meio corpo, espaço negativo, capa horizontal e assim por diante.
Cores: cores principais e complementares, como azul e branco, preto e dourado ou contraste entre vermelho e azul.
Restrições: por exemplo, “sem texto”, “sem marca-d'água” ou “fundo limpo”.

Você pode usar diretamente este pequeno modelo:

一张【比例】的【用途】图片，主体是【主体】，场景是【场景】，整体风格为【风格】，主色为【颜色】，构图【构图要求】，细节要求【限制或补充】。

Exemplo:

一张 1:1 的应用图标，主体是蓝色发光的 AI 芯片，白色背景，极简 3D 风格，居中构图，边缘清晰，不要文字。

8. Em caso de problemas, consulte esta seção primeiro 🛟

Sintoma	Solução
Falha de autenticação	Verifique se o cabeçalho da solicitação está escrito como `Authorization: Bearer YOUR_NEW_API_TOKEN` e confirme que não há espaços extras no token copiado.
O modelo não existe	Verifique se o nome do modelo foi informado exatamente como `image-01` ou `image-01-live`, sem alterar letras maiúsculas ou minúsculas.
A proporção da imagem não corresponde ao esperado	Ajuste primeiro `aspect_ratio`. Para capas comuns de contas oficiais, use `16:9`; para avatares ou ícones, use `1:1`.
O link da imagem não abre	A URL da imagem pode ter expirado. Faça o download logo após a geração ou transfira o arquivo para sua própria biblioteca de materiais.
A solicitação demora muito	A geração de imagens leva algum tempo; recomendamos configurar um timeout superior a 120 segundos.
O resultado não é consistente o suficiente	Descreva os requisitos com mais detalhes e reduza instruções contraditórias. Para obter resultados semelhantes, você pode manter um `seed` fixo.

9. Versão pronta para enviar à equipe de desenvolvimento 📮

Usamos os modelos da Guishu para gerar imagens por meio da API POST https://api.llm-token.cn/v1/images/generations. No cabeçalho da solicitação, usamos Authorization: Bearer YOUR_NEW_API_TOKEN. No corpo, informamos model: image-01 ou model: image-01-live, além de parâmetros como prompt, response_format: url, n e aspect_ratio.

10. Para quais cenários é indicado? 📚

Cenário	Como usar
Imagens para contas oficiais / Xiaohongshu	Gere rapidamente capas, imagens de destaque, pôsteres de campanhas e ilustrações para artigos.
Páginas de produtos e SaaS	Gere ícones de aplicativos, imagens de recursos, banners e ilustrações de estado vazio.
E-commerce e materiais de produtos	Gere fundos de produtos, imagens promocionais e imagens de ambientação para páginas de detalhes.
Fluxos de automação com Agent	Permita que o agente gere automaticamente imagens relacionadas ao conteúdo, aumentando a eficiência da produção.

Your privacy choices

Tutorial de geração de imagens com os modelos da Guishu