IA dentro do seu jogo: texto, imagens, música e 3D para os jogadores

O que o jogador vê

• O estúdio de IA com todos os recursos que você liberou, agrupados por tipo: texto, imagem, voz, música, vídeo, 3D.
• Um pedido e um preço: o jogador descreve o que quer e paga em recursos do jogo, ou nada.
• O resultado da tarefa no servidor: texto, uma imagem, um player para som e vídeo, um link de download para 3D.
• "Minhas criações": o histórico de gerações do jogador.

Como funciona

• Um recurso é configurado por você: o que ele gera, o prompt oculto e os limites; o jogador nunca vê prompts nem modelos.
• As gerações são pagas com os créditos de IA do plano e, além deles, com os Aspis da sua conta iDos Games; o preço para o jogador em recursos do jogo ou em Aspis é você quem define. Os Aspis só são cobrados quando a geração fica pronta: uma geração falhada não custa nada ao jogador.
• Um recurso marcado como oculto serve ao próprio código do jogo (falas de NPC e afins) e não aparece no estúdio; o sandbox voxel constrói mundos assim.

Para desenvolvedores

A IA no app funciona por meio de client.ai no @idosgames/core.

// Uma imagem a partir do pedido do jogador pelo recurso 'skin-gen' do título
const res = await client.ai.generateImage('skin-gen', { Prompt: text })
if (!res.ok) return showError(res.error) // recusado: nada gerado, nada cobrado
// O servidor executa a tarefa; aguarde o resultado
const done = await client.ai.waitForGeneration(res.data)

• Uma recusa do pedido (limite atingido, indisponível) não cobra nada: mostre o motivo e sugira tentar mais tarde.
• Não espere em um loop por conta própria: waitForGeneration acompanha a tarefa do servidor.
• Uma etapa 3D sobre um modelo pronto recebe SourceGenerationId: o id da própria geração 3D concluída do jogador neste jogo. A geração de outra pessoa é recusada.

Todos os campos estão descritos na habilidade ai-generation-system, servida pelo servidor MCP do SDK.