Communitygithub.com

evalix098/tiktoklive

Chame a API xAI (Grok) a partir do código do servidor deste aplicativo usando a XAI_API_KEY injetada: funcionalidades de chat/LLM, geração de imagens e vídeos (Imagine) e voz (texto-para-fala). Use quando o aplicativo precisar de qualquer funcionalidade de "IA" / "assistente" / "chatbot" / "Grok", geração de imagem/vídeo em tempo de execução ou fala. Aciona em "AI", "LLM", "chatbot", "assistant", "Grok", "xAI", "generate text", "summarize", "generate image", "AI video", "voice", "text to speech", "TTS", "OpenAI" (use xAI no lugar).

O que é tiktoklive?

Este skill configura e documenta o uso da API xAI (Grok) no servidor de um aplicativo. Ele permite que desenvolvedores integrem recursos de IA como chat/LLM (modelo grok-4.5), geração de imagens e vídeos (Imagine) e voz (texto-para-fala e transcrição) diretamente no código do servidor. A chave de API (XAI_API_KEY) é injetada automaticamente pela plataforma, funcionando de forma idêntica em preview e produção. O skill enfatiza o uso responsável, pois cada chamada gasta os créditos pessoais do proprietário do aplicativo, recomendando práticas como limitar saídas, evitar loops, cache de resultados e restringir chamadas a ações do usuário. Suportado em plataformas como TanStack Start, o skill fornece exemplos de código usando fetch nativo para chamadas de API, cobre endpoints de chat, Imagine e voz, e alerta contra a exposição da chave no lado do cliente.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/evalix098/tiktoklive/tree/HEAD/.grok/skills/xai-api

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

API xAI (Grok)

Quando XAI_API_KEY está presente no ambiente, este aplicativo tem acesso real à API xAI — use-a para funcionalidades de IA em vez de simular respostas ou recorrer a outro provedor. A mesma variável é injetada no aplicativo implantado na publicação, então o código construído com ela funciona de forma idêntica em preview e produção.

A chave é a chave pessoal do proprietário do aplicativo: cada chamada gasta sua cota e créditos. Seja deliberado sobre o uso — consulte Gaste com responsabilidade antes de conectar chamadas de IA a qualquer coisa que execute automaticamente ou seja aberta a visitantes.

A chave desbloqueia a superfície completa da API, não apenas chat:

  • Chat / LLM — modelo mais recente: grok-4.5; use-o como padrão, a menos que o usuário peça o contrário.
  • Imagine (imagens e vídeo) — gere e edite imagens, gere vídeo, em tempo de execução dentro do aplicativo.
  • Voz — texto-para-fala com vozes expressivas (e transcrição).
  • Documentação oficial: docs.x.ai — endpoints, modelos, parâmetros, streaming, uso de ferramentas. Não adivinhe formas de API; consulte a documentação.
  • A API é compatível com OpenAI (https://api.x.ai/v1), então qualquer cliente no estilo OpenAI funciona apenas alterando a URL base e a chave.

Variáveis de ambiente — não crie um arquivo .env

VariávelOndePropósito
XAI_API_KEYservidorInjetada pela plataforma (preview e implantação). Nunca escreva, codifique ou peça ao usuário.

A chave é apenas no servidor: leia-a com process.env.XAI_API_KEY dentro de manipuladores createServerFn / código do servidor, nunca em componentes do cliente, e nunca a exponha por meio de uma variável prefixada com VITE_ ou uma resposta de API.

Ela pode estar ausente (restrito por rollout). Degrade graciosamente — verifique-a e mostre um estado amigável "Funcionalidades de IA não estão disponíveis" em vez de falhar:

const apiKey = process.env.XAI_API_KEY;
if (!apiKey) throw new Error("A IA não está disponível neste ambiente");

Chamando a API (apenas no servidor)

Nenhum SDK necessário — fetch simples a partir de uma função do servidor:

import { createServerFn } from "@tanstack/react-start";

export const askGrok = createServerFn({ method: "POST" })
  .validator((input: { prompt: string }) => input)
  .handler(async ({ data }) => {
    const apiKey = process.env.XAI_API_KEY;
    if (!apiKey) return { ok: false as const, error: "A IA não está disponível" };

    const res = await fetch("https://api.x.ai/v1/chat/completions", {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        Authorization: `Bearer ${apiKey}`,
      },
      body: JSON.stringify({
        model: "grok-4.5",
        messages: [{ role: "user", content: data.prompt }],
      }),
    });
    if (!res.ok) {
      return { ok: false as const, error: `Erro da API xAI ${res.status}` };
    }
    const body = (await res.json()) as {
      choices: { message: { content: string } }[];
    };
    return { ok: true as const, text: body.choices[0]?.message.content ?? "" };
  });

Para streaming, saídas estruturadas, visão ou a lista completa de modelos, siga docs.x.ai — as formas são compatíveis com OpenAI.

Imagine — geração de imagem e vídeo (apenas no servidor)

A mesma chave dirige funcionalidades de imagem/vídeo em tempo de execução no aplicativo (avatares de usuário, arte de cena, conteúdo gerado). Distinto das ferramentas imagine_text_to_image / imagine_image_to_image / imagine_image_to_video em tempo de compilação (o skill imagine-grok-build): use a API quando o aplicativo em execução gera mídia, as ferramentas quando você cria ativos estáticos durante a construção.

// POST https://api.x.ai/v1/images/generations — mesmo cabeçalho de autenticação do chat
body: JSON.stringify({
  model: "grok-imagine-image-quality", // ou "grok-imagine-image" (mais barato)
  prompt: data.prompt,
  // n (≤10), resolução ("1k"|"2k"), response_format ("url"|"b64_json")
})
// → body.data[0].url
  • Edição de imagem: POST /v1/images/edits — edições em linguagem natural, até 3 imagens de referência.
  • Vídeo: grok-imagine-video por meio dos endpoints de vídeo assíncronos (inicie, depois consulte o id da requisição retornado; clipes de até ~15s).
  • Parâmetros completos e exemplos: docs.x.ai → API Imagine.

Voz — texto-para-fala (apenas no servidor)

POST https://api.x.ai/v1/tts converte texto em áudio falado — narração, acessibilidade, vozes de personagens:

// Mesmo cabeçalho de Authorization; retorna bytes de áudio (ex.: MP3)
body: JSON.stringify({ text: data.text, voice_id: "eve" }) // eve = voz padrão

Liste vozes em GET /v1/tts/voices (vozes personalizadas suportadas); transcrição (fala-para-texto) também está disponível. Detalhes: docs.x.ai → API de Voz. Sirva o áudio para o cliente a partir da sua função do servidor — nunca chame a API do navegador (isso exporia a chave).

Gaste com responsabilidade

A chave pertence ao proprietário do aplicativo (o usuário para quem você está construindo): cada chamada — incluindo aquelas acionadas por visitantes anônimos do aplicativo implantado — gasta sua cota e créditos pessoais. Queimá-la em chamadas desperdiçadas degrada ou quebra todos os outros usos da chave. Seja cuidadoso com o uso:

  • Limite a saída (max_tokens) e mantenha prompts pequenos para funcionalidades voltadas a visitantes. Geração de imagem, e especialmente de vídeo, custa muito mais por chamada do que chat.
  • Nunca chame a API em um loop, a cada pressionamento de tecla ou ao carregar a página — faça chamadas iniciadas pelo usuário (pressionamento de botão, envio de formulário) e use debounce.
  • Armazene em cache ou persista resultados (veja o skill neon) em vez de regenerar o mesmo conteúdo por visitante ou por renderização.
  • Restrinja fluxos caros — geração de mídia em particular. Em um aplicativo que já tem login, coloque-os atrás de authMiddleware (veja o skill auth). O login está desativado por padrão, e adicionar o middleware sem ele quebra o aplicativo implantado (AGENTS.md §0.5) — então, em um aplicativo sem contas, limite o uso: chamadas iniciadas pelo usuário, limites pequenos, resultados em cache.
  • Não adicione tempestades de repetição: em um erro de API, exiba-o; repita no máximo uma vez.

Individual skills in this repo

This repo contains 17 individual skills — each has its own dedicated page.

evalix098/tiktoklive

Add user accounts and sign-in to this TanStack Start app. Use when the app needs authentication, sign-in, user accounts, protected routes, or per-user data. Triggers on "auth", "login", "log in", "sign in", "sign up", "account", "users", "authentication", "protected", "who is logged in", "current user", "per-user".

evalix098/tiktoklive

Build browser games and interactive/canvas/3D experiences in this TanStack Start + React app. Use for any game, simulation, or WebGL/Canvas experience — 2D or 3D, single-player. Covers the game loop & timing, 3D orientation/camera conventions, collision, performance, assets, audio, save, game feel, and per-genre playbooks. For WASD / vehicle / flight **input signs and inverted A/D**, open the **`controls`** skill — do not rely on this file or racing-kart alone. Triggers on "game", "minecraft", "fps", "platformer", "racing", "tetris", "snake", "shooter", "3d", "three.js", "canvas", "voxel", "physics".

evalix098/tiktoklive

Player-facing input signs for browser games: WASD, vehicles, flight, FPS mouse-look, and the #1 failure mode (inverted A/D). Mandatory control self-tests and a tiny test interface so you can verify A turns left before shipping. Load for ANY game with movement, steering, flying, driving, tanks, boats, mechs, drones, planes, karts, third-person follow cams — not only racing. Triggers on "controls", "WASD", "inverted", "steer", "flight", "airplane", "kart", "vehicle", "yaw", "roll", "pitch", "mouse look", "A/D".

evalix098/tiktoklive

Design and build polished, non-generic UI for this TanStack Start + React + Tailwind v4 + shadcn/Radix app. Use whenever you create or restyle any interface surface — pages, landing pages, dashboards, forms, modals, nav, and game overlays (start screens, HUD, menus). Covers design tokens, layout, typography, color, spacing, motion, and the anti-"AI-slop" rules that keep output from looking generic. Triggers on "design", "UI", "make it look good", "polish", "landing page", "theme", "style", "redesign", "ugly", "clean up".

evalix098/tiktoklive

Deep guide for game ANIMATION assets: motion cycles, action keyframes, effect sequences, and animation sprite sheets — built around a video-first pipeline. In this app-builder sandbox, execute via the video2dsprite / generate2dsprite skills (magenta + scripts), not ad-hoc ffmpeg. Use whenever generating anything that moves: walk/run cycles, attacks, idles, FX, flags, fire, animation sheets. Complements game-asset-core.

evalix098/tiktoklive

Core discipline for ANY game-asset generation with Imagine tools: the engine-ready defaults users don't state, spec checklists, style anchoring, read-back verification, honest defect flagging. Use whenever generating any game art (sprites, sheets, animations, tiles, UI, FX) — then ALSO load the matching specialist skill: game-animation-frames for anything that moves, game-tilesets for tiles/terrain, game-character-consistency for recurring characters, game-ui-icons for UI and icons.

evalix098/tiktoklive

Deep guide for CHARACTER IDENTITY across images: turnarounds (front/side/ back), state and damage variants, palette swaps, equipment changes, and same-character-in-context sets. Use whenever generating character turnarounds, character sheets, variants of an existing sprite, or any same-subject multi-image set. Complements game-asset-core.

evalix098/tiktoklive

Deep guide for game TILE assets: seamless tileable textures, terrain transition tilesets, autotiles, and ground/platform tiles. Use whenever generating tileable textures, tilesets, terrain transitions, or seamless patterns. Complements game-asset-core.

evalix098/tiktoklive

Deep guide for game UI assets: buttons with interaction states, panels, bars, wordmark logos, and icon sets. Use whenever generating game UI elements, HUD assets, inventory icons, icon sets, buttons, or title logos. Complements game-asset-core.

evalix098/tiktoklive

Generate production-oriented 2D game maps with `imagine_text_to_image`: RPG/top-down maps, side-scroller parallax stages, tilemaps, layered raster maps, prop packs, collision zones, and walkable areas. Use when building browser games that need real map art (not pure code-drawn tiles), layered props, or map collision metadata. Triggers on "map", "level", "stage", "tilemap", "overworld", "dungeon", "side scroller background", "prop pack", "2D map".

evalix098/tiktoklive

Generate and postprocess 2D game sprites and animation sheets: pixel-art characters, NPCs, creatures, spells, projectiles, impacts, props, summons, and transparent PNG/GIF exports. Use when building browser games that need real sprite sheets (not code-drawn placeholders), matching a map art style, or producing magenta-background sheets for chroma-key cleanup. Triggers on "sprite", "sprite sheet", "animation sheet", "pixel art character", "walk cycle", "attack animation", "projectile sprite", "2D game asset".

evalix098/tiktoklive

How to use the Imagine tools in Grok Build: imagine_text_to_image, imagine_image_to_image, imagine_reference_to_image, imagine_text_to_video, imagine_image_to_video, imagine_reference_to_video, and render_file for chat previews. When to build a visual with code instead of generating it, prompt-craft, reference-first handling of real people, factual grounding, and asset-consistency. Load this whenever generating or editing an image or video is on the table. Tool-usage-driven, not triggered by a user merely mentioning images.

evalix098/tiktoklive

Peer-to-peer realtime multiplayer over WebRTC data channels: every user of the deployed app connects directly to every other user (full mesh), the server only brokers the handshake at /api/rtc. Lowest possible latency, zero per-message server cost. Use for 2-8 player co-op/casual realtime: shared cursors, drawing, party games, casual action. Triggers: p2p, peer to peer, webrtc, low latency multiplayer, direct connection.

evalix098/tiktoklive

Use Neon Postgres (the database) in this TanStack Start app. Use when the app needs to store or query data, persist state, or keep per-user data. Triggers on "database", "Postgres", "Neon", "save data", "store data", "persist", "tables", "SQL", "query", "migrations".

evalix098/tiktoklive

Share-link previews and app identity for apps on *.grok.me: the injector-owned og:image card, the SVG favicon, and PWA icons for installable apps. Use when scaffolding, renaming, or restyling the app — and for share / unfurl / OG / Twitter card questions. A custom 1200×630 card from the app's own art is the default — games of every kind (DOM board/word games included), whimsical apps, creative tools, and brand-forward pages; only plain utilities keep the placeholder. Always run the brand-asset pass as a `task` subagent and never wait for it. Triggers on "share", "rename", "app name", "OG", "Open Graph", "twitter card", "unfurl", "og:image", "og:type", "x:game:image", "x-banner", "link preview", "social card", "thumbnail", "preview image", "favicon", "app icon", "PWA", "manifest", "installable", "home screen", "SEO", "meta description".

evalix098/tiktoklive

Official Three.js API and TSL (Three.js Shading Language) reference for LLM code generation. Load when writing or debugging three.js / WebGL / WebGPU / custom materials / shaders / GLTF / advanced three APIs beyond basic game loop/controls. Prefer building-games for game correctness (loop, WASD, camera, orientation); use this skill for full API/TSL depth. Triggers on "three.js", "threejs", "WebGPU", "TSL", "NodeMaterial", "shader", "GLTF", "MeshStandard", "OrbitControls", "WebGLRenderer".

evalix098/tiktoklive

Grok Build only. Turn a 2D character still into denser animation sprites via imagine_text_to_image base → imagine_image_to_video (6s/10s run-in-place) → ffmpeg frames → magenta chroma-key → dense sampled strips/grids/GIFs. Use when the user wants video-to-sprite, smoother run/walk cycles, or denser intermediate poses. Prefer generate2dsprite for crisp production pixel sheets. Triggers on "video to sprite", "imagine_image_to_video sprite", "dense walk cycle", "smooth run animation from video".

Habilidades Relacionadas