SpicyGen

npx add-mcp 'https://www.spicygen.ai/api/mcp'

SpicyGen para agentes de IA

Um servidor MCP e uma API REST permitem que Claude Code, Cursor, Codex, Claude Desktop e qualquer agente que fale Streamable HTTP ou HTTP simples trabalhem com uma conta SpicyGen: criar personagens, gerar imagens e vídeos, construir filmes, gerenciar a biblioteca e obter um link de checkout. As mesmas verificações de moderação, crédito, suspensão e controle de idade do site se aplicam a cada chamada.

1. Criar uma chave de API

Entre em https://www.spicygen.ai/login (ou cadastre-se em https://www.spicygen.ai/signup e confirme seu e-mail), abra https://www.spicygen.ai/account#api-keys, e crie uma chave. As chaves têm o formato sg_live_…, são exibidas uma única vez e podem ser revogadas a qualquer momento. Marque Sandbox para obter uma chave sg_sandbox_… que responde a todas as ferramentas com dados de exemplo e não gasta nada.

2. Conectar

Claude Code:

claude mcp add --transport http spicygen https://www.spicygen.ai/api/mcp --header "Authorization: Bearer sg_live_…"

Cursor (~/.cursor/mcp.json ou .cursor/mcp.json):

{ "mcpServers": { "spicygen": { "url": "https://www.spicygen.ai/api/mcp", "headers": { "Authorization": "Bearer sg_live_…" } } } }

Codex (~/.codex/config.toml):

[mcp_servers.spicygen]
url = "https://www.spicygen.ai/api/mcp"
http_headers = { Authorization = "Bearer sg_live_…" }

Claude Desktop e outros clientes somente stdio fazem a ponte via mcp-remote:

{ "mcpServers": { "spicygen": { "command": "npx", "args": ["-y", "mcp-remote", "https://www.spicygen.ai/api/mcp", "--header", "Authorization: Bearer sg_live_…"] } } }

REST em vez de MCP: POST https://www.spicygen.ai/api/v1/tools/{tool_name} com o mesmo cabeçalho e um corpo JSON de argumentos. GET https://www.spicygen.ai/api/v1/tools lista as ferramentas com esquemas. OpenAPI 3.1: https://www.spicygen.ai/openapi.json.

3. Peça algo ao seu agente

"Crie uma personagem chamada Mara, uma mulher na casa dos trinta com cabelo cacheado escuro e sardas, e depois gere quatro imagens fotorrealistas dela em uma praia." O agente chama read_content_rules, create_character, aguarda get_character informar que está pronto e então generate_images e get_job.

Regras que a superfície impõe

• Cada prompt passa pela mesma moderação do site (veja https://www.spicygen.ai/ai-policy). Um prompt bloqueado não custa nada, mas conta como uma advertência.
• Ferramentas que gastam créditos (create_character, generate_images, generate_video, create_movie_scene) e delete_item retornam approval_required com o custo em créditos primeiro. O agente mostra, o usuário diz sim, o agente chama novamente com o token (expira em 15 minutos, vinculado aos argumentos exatos). Contas podem pular aprovações no cartão de chaves de API; nada mais muda.
• Verificação de idade: onde a lei exige, URLs de mídia NSFW são retidas até que o usuário conclua a verificação única; get_account informa o estado e a URL de verificação.
• Limite de 60 requisições por minuto por chave. Dez chaves ativas por conta.
• O pagamento é sempre uma URL de checkout hospedada que o humano abre; o agente nunca lida com dados de cartão.

Skills

Arquivos SKILL.md que contêm todo o fluxo de trabalho para uma tarefa (chamadas de ferramentas em ordem, custos, regra de aprovação): https://www.spicygen.ai/skills/index.json. Instale em .claude/skills/<name>/SKILL.md ou aponte seu harness para a URL bruta. Fonte: https://github.com/Wayfinity/spicygen-skills.

Referência de ferramentas

Conta e regras

• get_account: Comece aqui. Saldo de créditos, estado de verificação de idade para a jurisdição do chamador (se mídia NSFW está disponível e a URL de verificação quando não está), custos de créditos por imagem, por segundo de vídeo e por personagem, limites de taxa e se a conta pula aprovações.
• read_content_rules: As regras de uso aceitável contra as quais todo prompt e imagem são verificados (somente adultos, apenas personagens fictícios, sem pessoas reais, sem menores, sem não-consentimento, sem violência). Leia antes de escrever prompts; um prompt bloqueado não custa nada, mas conta para as advertências de moderação da conta.
• get_credit_packs: Pacotes de créditos e preços disponíveis para esta conta (pacotes regionais quando aplicáveis), com o que cada pacote compra em imagens e segundos de vídeo.
• get_checkout_link: Uma URL de checkout hospedada para um pacote de créditos. Entregue a URL ao usuário; ele paga no navegador (cartão, métodos locais ou cripto dependendo da região). Nunca peça ou insira dados de cartão. Os créditos entram na conta quando o provedor confirma; get_account mostra o novo saldo.
• get_referral_stats: O código de indicação e link do usuário, cadastros indicados, cliques e créditos ganhos. Os pagamentos do programa de afiliados (Tapfiliate) são lidos no painel de afiliados, não aqui.

Personagens

• list_characters: Os personagens salvos do usuário (id, nome, aparência, estilo, status, miniatura). Use um id de personagem em generate_images, generate_video e create_movie_scene para uma identidade consistente.
• get_character: Um personagem com suas gerações recentes (imagens e vídeos). URLs de mídia NSFW são retidas quando a jurisdição da conta exige verificação de idade que o usuário não concluiu.
• create_character (protegida): Criar um personagem reutilizável a partir de uma descrição em texto (10 créditos). Gera a imagem de identidade; consulte get_character até o status ficar pronto (cerca de um minuto). A descrição passa pela mesma moderação de prompt do site.

Geração

• generate_images (protegida): Gerar de 1 a 10 imagens a partir de um prompt (5 créditos cada Padrão, 10 HD; uma referência de personagem força HD). Retorna ids de tarefa; consulte get_job. Os prompts são moderados exatamente como no site; chame read_content_rules primeiro.
• generate_video (protegida): Transformar uma imagem da biblioteca (source_item_id) ou um personagem (character_id) em um vídeo com um prompt de movimento. Custa de 10 a 20 créditos por segundo dependendo da qualidade e do modelo (veja get_account.costs). Retorna um id de tarefa; consulte get_job (os vídeos levam alguns minutos).
• create_movie_scene (protegida): Adicionar uma cena a um filme e começar a gerá-la no SpicyMotion v3.0 Fast (HD, áudio). Omita movie_id para iniciar um novo filme; a primeira cena precisa de source_item_id ou character_id, as cenas seguintes continuam do último quadro da cena anterior. Custa 20 créditos por segundo. Consulte get_job com o id de tarefa retornado; quando concluir, chame create_movie_scene novamente para a próxima cena e depois combine_movie.
• combine_movie (protegida): Unir as cenas concluídas de um filme em um único vídeo (sem créditos, mas renderiza no servidor e é protegida para o usuário confirmar o corte). Retorna a URL do filme.
• get_job: Status de uma tarefa de geração (na fila, gerando, concluída, falhou), progresso e, ao concluir, as URLs de imagem ou vídeo (retidas com nsfw_withheld:true quando o controle de idade se aplica). Consulte a cada 10 a 20 segundos.

Biblioteca

• list_library: As imagens e vídeos gerados do usuário, mais recentes primeiro, com prompt, status, sinalizador de favorito e URLs (NSFW retida quando o controle de idade se aplica). Pagine com cursor.
• favorite_item: Marcar ou desmarcar um item da biblioteca como favorito.
• delete_item (protegida): Excluir uma imagem ou vídeo da biblioteca. Irreversível; protegida para o usuário confirmar.

Custos

• Personagem: 10 créditos (uma imagem de identidade, reutilizável em toda geração posterior).
• Imagem: 5 créditos Padrão, 10 créditos HD (uma referência de personagem é sempre HD).
• Vídeo, SpicyMotion v3.0: 10 créditos por segundo Padrão, 15 HD, de 3 a 15 segundos.
• Vídeo, SpicyMotion v3.0 Fast (áudio nativo, até 30 segundos): 15 créditos por segundo Padrão, 20 HD. Cenas de filme usam este modelo em HD.