GPT Image

Os modelos de imagem GPT do Tianshu (a série gpt-image) servem para texto-para-imagem e edição de imagem, sob o grupo 生图专用.

Preparação

1. Crie um token no grupo 生图专用 no Console.
2. Confirme um nome de modelo de imagem disponível no grupo 生图专用 no Mercado de Modelos (os exemplos abaixo usam gpt-image-2).

Use a rota direta

A geração de imagem é uma requisição de longa duração, então use a rota direta https://api.tian-shu.org no endpoint para evitar timeouts do gateway.

Opção 1: Chamada de API (recomendado)

Para gerar imagens, use a Images API, que tem dois endpoints: texto-para-imagem e edição de imagem.

Texto-para-imagem /v1/images/generations

curl 'https://api.tian-shu.org/v1/images/generations' \
  -H 'Authorization: Bearer your-image-group-token' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-image-2",
    "prompt": "an orange cat wearing an orange scarf hugging an otter, warm illustration style",
    "size": "1024x1024",
    "quality": "high",
    "output_format": "png",
    "response_format": "url",
    "n": 1
  }'

Edição de imagem / imagem-para-imagem /v1/images/edits

Envie uma imagem usando multipart/form-data e descreva a alteração claramente no prompt:

curl 'https://api.tian-shu.org/v1/images/edits' \
  -H 'Authorization: Bearer your-image-group-token' \
  -F 'model=gpt-image-2' \
  -F 'prompt=Keep the subject, add a red stamp in the top-right corner reading DEMO' \
  -F 'image=@/path/to/your-image.jpg' \
  -F 'size=1024x1024' \
  -F 'quality=high' \
  -F 'output_format=png' \
  -F 'response_format=url'

Parâmetros comuns

Parâmetro	Observações
model	Sempre o nome do modelo de imagem, ex. gpt-image-2.
prompt	Descrição da imagem; detalhe o sujeito, a cena, o estilo, a proporção e qualquer texto.
n	Apenas 1 é suportado — uma imagem por chamada.
size	Suporta auto e tamanhos comuns como 1024x1024, 1536x1024, 1024x1536.
quality	low / medium / high / auto; use low para rascunhos e high para a saída final.
response_format	url ou b64_json; url é recomendado por padrão.
output_format	png ou jpeg recomendados; webp não é recomendado.
stream	Não suportado — não habilite.

Opção 2: Gerar imagens no Cherry Studio

1. Crie e copie um token no grupo 生图专用.
2. Cherry Studio → Configurações → Serviços de Modelo → adicione um provedor do tipo OpenAI:
   • Endereço da API: https://api.tian-shu.org
   • Chave da API: seu token do grupo de imagens
3. Em "Gerenciar", adicione um modelo de imagem (como gpt-image-2).
4. Certifique-se de desativar a "saída em streaming" (o endpoint de imagem não faz streaming), caso contrário a geração pode falhar.
5. Selecione o modelo de imagem e você poderá começar a gerar.

Observação sobre o método de chamada

Para a geração com gpt-image, use a Images API (/v1/images/generations, /v1/images/edits). Os endpoints Chat Completions / Responses não são o ponto de entrada para geração de imagem.