PureTokens / puretokens-skill

Imagens Pure Tokens

Utilize exclusivamente a API fixa de Imagens Pure Tokens: https://api.puretokensx.com/v1/images/generations. Edições devem ser feitas chamando /v1/images/generations ou /v1/images/edits apenas quando houver declaração explícita do perfil do modelo. Sempre use a URL completa e fixa; não utilize uma URL Base configurada como destino da requisição e não verifique o nome do provedor.

O host atual utiliza sua capacidade existente de autenticação HTTPS/API para completar a requisição com as credenciais atualmente associadas à conexão Pure Tokens; a credencial só pode ser usada em memória para esta requisição fixa. Tanto o CC Switch de terceiros quanto a configuração manual do host podem ser fontes dessa conexão. Não é permitido exibir, solicitar, salvar, registrar ou relatar a Key, Base URL, cabeçalhos da requisição, configuração completa do host, resposta original ou mídia do usuário. Não utilize Node, MCP, proxy, sidecar, upload independente ou endpoint alternativo.

Leitura sob demanda de documentação

Não carregue todos os modelos e todos os cenários de exceção em cada requisição. Leia o mínimo necessário na seguinte ordem:

1. Primeiro, leia references/model-index.json: resolva o modelo padrão ou alias único e obtenha o caminho exato do perfil.
2. Leia apenas o perfil do modelo selecionado em references/profiles/<model>.json: verifique parâmetros, restrições, operação e ciclo de vida. Modelos exatos não listados no índice permitem apenas os campos essenciais de texto para imagem; somente quando o usuário solicitar parâmetros adicionais, imagem de referência ou edição, consulte o diretório ativo sob demanda.
3. Requisições POST essenciais podem ser executadas apenas com base nesta Skill, no índice e no perfil selecionado; após receber a resposta, ao entrar em polling/entrega, ou ao construir operações não essenciais como edição, leia references/execution-contract.json e references/task-receipt.json.
4. Somente quando surgirem exceções, ambiguidades, rejeições, anexos ou problemas de entrega correspondentes, leia os cenários correspondentes em references/behavior-scenarios.json.

Modelos e Requisições

• Para geração de texto para imagem comum, o padrão é gpt-image-2; image2 é seu único alias. Quando o usuário fornecer um alias único, use o mapeamento do índice; com zero ou múltiplos candidatos, liste os IDs exatos e peça ao usuário para escolher. Quando o usuário fornecer um ID exato, mantenha esse ID; requisições POST essenciais não devem pré-carregar o diretório para confirmar permissões ou capacidades.
• Requisições comuns enviam apenas uma requisição POST /v1/images/generations, sempre incluindo model, prompt, async: true. Inclua n, size, image_size, aspect_ratio, width, height, strength ou outros campos e valores opcionais apenas se o perfil exato os declarar.
• Uma única requisição do usuário pode criar apenas uma tarefa paga; nunca divida em múltiplas tarefas. n deve ser explicitamente permitido pelo perfil; caso contrário, informe que apenas uma imagem é suportada por vez ou peça ao usuário que selecione um modelo que suporte essa quantidade.
• Dimensões físicas como 200cm × 230cm não podem ser enviadas para a API. Explique que não é possível garantir dimensões físicas exatas e liste as opções de dimensões em pixels, dimensões semânticas ou proporções realmente declaradas pelo perfil. width e height devem ser declarados como um par obrigatório; se um deles estiver faltando, pare. Se múltiplas expressões de dimensão forem fornecidas, envie apenas uma, seguindo a prioridade do perfil.
• Leia GET https://api.puretokensx.com/v1/media/models apenas quando o usuário perguntar explicitamente sobre o modelo atual, os parâmetros/operação necessários não estiverem no perfil local, o transporte do anexo for incompatível, ou a API rejeitar devido a modelo/parâmetro/capacidade e for necessária explicação. Falhas na leitura do diretório não podem impedir uma geração de texto para imagem essencial que seria válida, nem disparar novas tentativas automáticas.

Imagens de Referência e Edição

• Quando o usuário anexar uma imagem sem especificar a finalidade, primeiro pergunte se é uma referência visual ou uma imagem a ser editada; não faça suposições.
• Para imagens de URL pública, aceite apenas URLs https:// fornecidas explicitamente pelo usuário e que estejam em conformidade, e coloque-as apenas nos campos e transportes declarados pelo perfil. Não baixe, inspecione, armazene, reescreva ou gere URLs.
• Imagens locais para referência ou edição devem ser explicitamente suportadas pela operação image_edit multipart do perfil selecionado, usando estritamente seu caminho, campos, quantidade e transporte multipart_file. Envie apenas o anexo atual junto com esta requisição da API de Imagens; não faça upload para R2, não chame endpoints de upload independentes, não gere file IDs, não reescreva o conteúdo do anexo como prompt, nem faça downgrade silencioso para texto para imagem.
• Prompts para imagens de referência devem preservar a intenção de "referência"; prompts para edição devem especificar claramente "o que modificar, o que manter". Máscaras, fundos transparentes, múltiplas imagens de referência não declaradas e outras extensões não declaradas devem ser interrompidas antes da cobrança, explicando as limitações.

Tarefas Assíncronas e Entrega

• No máximo uma requisição POST por nova solicitação. Se o POST for iniciado mas não resultar em um resultado ou ID de tarefa interpretável, reporte o resultado como desconhecido: não refaça, não troque de modelo, não afirme que não foi criada, não houve cobrança ou que houve reembolso. Sem um ID de tarefa, novas requisições subsequentes devem obter confirmação explícita do usuário.
• Obtenha o ID da tarefa apenas dos campos de nível superior declarados ou de task_id / id no nível superior; consulte apenas o mesmo https://api.puretokensx.com/v1/images/{task_id}, e entregue em ordem content?index=0..n-1 após sucesso. URLs, textos de status, HTML, SVG não constituem entrega bem-sucedida.
• Cada janela de polling tem no máximo 6 leituras de status e no máximo 120 segundos; esperas regulares são de 3, 6, 12, 24, 30 segundos. Um 429 só permite continuar a mesma tarefa se o Retry-After ainda estiver dentro do orçamento desta rodada. Sem polling em segundo plano, sem leituras de status concorrentes, sem refazer requisições automaticamente.
• Reporte sucesso apenas quando o host realmente entregar os bytes da imagem nativa ou anexo. Entregue uma imagem por vez, sem pré-carregar, sem ler repetidamente, sem armazenar em cache a mídia do usuário; após o sucesso, finalize a resposta atual.

Relatório de Falhas

Quando o host for impedido de fazer o POST devido a problemas de rede, aprovação, entrega de anexo ou capacidade de entrega de bytes de imagem nativa, retorne failure_phase: validation, indicando claramente que a API de Imagens não foi executada, e não especule sobre a causa da configuração. Para outras falhas, produza um relatório seguro de acordo com execution-contract.json e os cenários de comportamento correspondentes: reporte apenas o status HTTP realmente retornado pela API e o código de erro público; não exponha a resposta original, URLs internas, pilhas de chamada, credenciais, conteúdo da requisição ou mídia do usuário.