Communitygithub.com

TikTok Live

Rufe die xAI API (Grok) aus dem Server-Code dieser App auf, um Chat/LLM-Funktionen, Bild- und Videogenerierung (Imagine) sowie Sprachausgabe (Text-to-Speech) zu nutzen – nur für den Einsatz in TikTok Live Szenarien.

Was ist TikTok Live?

Dieses Skill ermöglicht es, die xAI API (Grok) nahtlos in die Serverlogik einer TikTok Live App zu integrieren. Es stellt die vollständige API-Oberfläche zur Verfügung: Chat/LLM mit dem neuesten Modell grok-4.5, dynamische Bild- und Videogenerierung über Imagine sowie Text-to-Speech mit expressiven Stimmen. Die Verwendung erfolgt ausschließlich serverseitig über die bereitgestellte `XAI_API_KEY` Umgebungsvariable. Entwickler müssen keine zusätzliche Bibliothek einbinden – ein einfacher `fetch`-Aufruf von einem Server-Handler reicht aus. Das Skill betont den verantwortungsvollen Umgang mit dem API-Key, da jeder Aufruf das persönliche Kontingent und die Credits des App-Besitzers verbraucht. Es enthält klare Richtlinien zur Begrenzung von Ausgaben, zur Vermeidung von Endlosschleifen und zur sinnvollen Caching-Strategie, um Kosten zu kontrollieren und die App stabil zu halten. Unterstützte Plattformen sind alle Umgebungen, die Server-seitigen JavaScript-Code ausführen können (z. B. Node.js mit Express, Next.js API Routes, etc.). Der Skill arbeitet nach dem OpenAI-kompatiblen Schema (`https://api.x.ai/v1`), sodass bestehende OpenAI-Clients durch einfaches Ändern der Basis-URL und des API-Keys verwendet werden können.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

xAI API (Grok)

Wenn XAI_API_KEY in der Umgebung vorhanden ist, hat diese App echten Zugriff auf die xAI API – nutze sie für KI-Funktionen, anstatt Antworten zu simulieren oder zu einem anderen Anbieter zu greifen. Dieselbe Variable wird bei der Veröffentlichung in die bereitgestellte App injiziert, sodass der darauf aufbauende Code in der Vorschau und in der Produktion identisch funktioniert.

Der Schlüssel ist der persönliche Schlüssel des App-Besitzers: Jeder Aufruf verbraucht dessen Kontingent und Credits. Sei bewusst im Umgang – siehe Verantwortungsvoll ausgeben, bevor du KI-Aufrufe in etwas einbaust, das automatisch läuft oder für Besucher offen ist.

Der Schlüssel entsperrt die vollständige API-Oberfläche, nicht nur Chat:

  • Chat / LLM – neuestes Modell: grok-4.5; standardmäßig verwenden, es sei denn, der Benutzer wünscht etwas anderes.
  • Imagine (Bilder & Videos) – Bilder generieren und bearbeiten, Videos generieren, zur Laufzeit innerhalb der App.
  • Sprache – Text-to-Speech mit ausdrucksstarken Stimmen (und Transkription).
  • Offizielle Dokumentation: docs.x.ai – Endpunkte, Modelle, Parameter, Streaming, Tool-Nutzung. Rate keine API-Formen; überprüfe die Dokumentation.
  • Die API ist OpenAI-kompatibel (https://api.x.ai/v1), sodass jeder OpenAI-ähnliche Client durch Wechsel der Basis-URL und des Schlüssels funktioniert.

Umgebungsvariablen – keine .env-Datei erstellen

VariableWoZweck
XAI_API_KEYServerWird von der Plattform injiziert (Vorschau und Bereitstellung). Niemals schreiben, hartcodieren oder den Benutzer danach fragen.

Der Schlüssel ist nur serverseitig: Lies ihn mit process.env.XAI_API_KEY innerhalb von createServerFn-Handlern / Server-Code, niemals in Client-Komponenten und setze ihn niemals über eine VITE_-präfixierte Variable oder eine API-Antwort offen.

Er kann fehlen (ausgerollt-gesteuert). Verhalte dich tolerant – überprüfe ihn und zeige einen freundlichen "KI-Funktionen sind nicht verfügbar"-Zustand an, anstatt abzustürzen:

const apiKey = process.env.XAI_API_KEY;
if (!apiKey) throw new Error("KI ist in dieser Umgebung nicht verfügbar");

API aufrufen (nur serverseitig)

Kein SDK erforderlich – einfaches fetch von einer Server-Funktion:

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: "KI ist nicht verfügbar" };

    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: `xAI API Fehler ${res.status}` };
    }
    const body = (await res.json()) as {
      choices: { message: { content: string } }[];
    };
    return { ok: true as const, text: body.choices[0]?.message.content ?? "" };
  });

Für Streaming, strukturierte Ausgaben, Vision oder die vollständige Modellliste folge docs.x.ai – die Formate sind OpenAI-kompatibel.

Imagine – Bild- & Videogenerierung (nur serverseitig)

Derselbe Schlüssel treibt Laufzeit-Bild-/Videofunktionen in der App an (Benutzer-Avatare, Szenenkunst, generierte Inhalte). Unterscheide dich von den Build-Zeit-Tools imagine_text_to_image / imagine_image_to_image / imagine_image_to_video (das imagine-grok-build-Skill): Verwende die API, wenn die laufende App Medien generiert, und die Tools, wenn du statische Assets während des Builds erstellst.

// POST https://api.x.ai/v1/images/generations – gleicher Auth-Header wie Chat
body: JSON.stringify({
  model: "grok-imagine-image-quality", // oder "grok-imagine-image" (günstiger)
  prompt: data.prompt,
  // n (≤10), Auflösung ("1k"|"2k"), response_format ("url"|"b64_json")
})
// → body.data[0].url
  • Bildbearbeitung: POST /v1/images/edits – natürlichsprachliche Bearbeitungen, bis zu 3 Referenzbilder.
  • Video: grok-imagine-video über die asynchronen Video-Endpunkte (starten, dann die zurückgegebene Anfrage-ID abfragen; Clips bis zu ~15s).
  • Vollständige Parameter und Beispiele: docs.x.ai → Imagine API.

Sprache – Text-to-Speech (nur serverseitig)

POST https://api.x.ai/v1/tts wandelt Text in gesprochenes Audio um – Erzählungen, Barrierefreiheit, Charakterstimmen:

// Gleicher Authorization-Header; gibt Audio-Bytes zurück (z. B. MP3)
body: JSON.stringify({ text: data.text, voice_id: "eve" }) // eve = Standardstimme

Liste der Stimmen unter GET /v1/tts/voices (benutzerdefinierte Stimmen unterstützt); Transkription (Sprache-zu-Text) ist ebenfalls verfügbar. Details: docs.x.ai → Voice API. Gib das Audio von deiner Server-Funktion an den Client weiter – rufe die API niemals vom Browser aus auf (das würde den Schlüssel offenlegen).

Verantwortungsvoll ausgeben

Der Schlüssel gehört dem App-Besitzer (dem Benutzer, für den du entwickelst): Jeder Aufruf – einschließlich derer, die von anonymen Besuchern der bereitgestellten App ausgelöst werden – verbraucht dessen persönliches Kontingent und Credits. Es durch verschwenderische Aufrufe zu verbrennen, verschlechtert oder unterbricht jede andere Nutzung seines Schlüssels. Gehe sparsam mit der Nutzung um:

  • Begrenze die Ausgabe (max_tokens) und halte Prompts für besucherorientierte Funktionen klein. Bild- und insbesondere Videogenerierung kosten pro Aufruf viel mehr als Chat.
  • Rufe die API niemals in einer Schleife, bei jedem Tastendruck oder beim Seitenladen auf – mache Aufrufe benutzerinitiiert (Tastendruck, Formularabsenden) und entprelle sie.
  • Cache oder persistiere Ergebnisse (siehe das neon-Skill), anstatt denselben Inhalt pro Besucher oder pro Rendering neu zu generieren.
  • Schütze teure Abläufe – insbesondere Mediengenerierung. In einer App, die bereits eine Anmeldung hat, platziere sie hinter authMiddleware (siehe das auth-Skill). Die Anmeldung ist standardmäßig deaktiviert, und das Hinzufügen der Middleware ohne sie zerbricht die bereitgestellte App (AGENTS.md §0.5) – also bei einer App ohne Konten die Nutzung begrenzen: benutzerinitiierte Aufrufe, kleine Limits, gecachte Ergebnisse.
  • Füge keine Wiederholungsstürme hinzu: Bei einem API-Fehler zeige ihn an; wiederhole höchstens einmal.

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".

Verwandte Skills