dark-stars-api-sdk
v1.0.0
Published
SDK leve, rápido e totalmente intuitivo para integração com a Dark Stars API — incluindo downloads, IA, canvas, stickers, música, voz, vídeo e muito mais.
Downloads
119
Maintainers
Readme
🌑 DarkStarsAPI – SDK Oficial para Node.js
Biblioteca leve, rápida e tipada para acessar todas as funcionalidades da Dark Stars API de forma simples e elegante.
Funcionalidades principais:
- 📥 Downloads — YouTube, TikTok, Instagram, etc.
- 🔍 Buscas — Google, YouTube, Pinterest, Xvideos...
- 🤖 IA de Texto — ChatGPT, Gemini, DeepSeek, Claude...
- 🎨 Geração de Imagens — DALL·E, Stable Diffusion, Flux, NSFW...
- 📸 Stickers & Figurinhas — ATTP, meme, figurinhas animadas...
- 🖼 Canvas — Bem-vindo, perfil, level card, ship, efeitos...
- 🔊 Texto para Fala (TTS) — gTTS, Gemini TTS...
- 🎙 Vozes de IA — Laura, Isabela, Lula, Bolsonaro, entre outras
- 🎬 Geração de Vídeo — Grok Video, Veo...
- 🎵 Geração de Música — MusicGen, MusicLab...
📦 Instalação
Via npm (recomendado):
npm install dark-stars-api-sdkOu via yarn / pnpm:
yarn add dark-stars-api-sdk
# ou
pnpm add dark-stars-api-sdk🚀 Importando e iniciando
const DarkApi = require("dark-stars-api-sdk");
const dark = new DarkApi({
apikey: "SUA_KEY_AQUI"
});Pegue sua apikey aqui https://darkstarsapi.online
⚡ Uso básico
Todas as chamadas seguem o padrão:
const result = await dark({
name: "rota.do.recurso",
input: { /* parâmetros */ }
});
console.log(result);📚 Exemplos por Categoria
Abaixo um exemplo real de cada categoria existente da API.
🎵 1. DOWNLOADS
const audio = await dark({
name: "download.youtube.audio",
input: { url: "https://youtu.be/ehZFyxRbyd0" }
});
console.log("Arquivo salvo em:", audio);🔍 2. SEARCH
const yt = await dark({
name: "search.youtube",
input: { query: "Pedrozz Mods" }
});
console.log(yt);🤖 3. IA TEXTO
const gpt = await dark({
name: "ai.gpt",
input: { texto: "Olá, tudo bem?" }
});
console.log(gpt);🎨 4. IA IMAGEM
const img = await dark({
name: "img.generate",
input: { prompt: "A cute futuristic robot cat" }
});
console.log("Imagem salva em:", img);📝 5. STICKERS
const stc = await dark({
name: "sticker.v3.attp7",
input: { texto: "Dark API" }
});
console.log("Sticker salvo em:", stc);🖼 6. CANVAS
const card = await dark({
name: "canvas.welcome",
input: {
titulo: "Bem-vindo",
perfil: "https://files.catbox.moe/9rtdyx.png",
fundo: "https://telegra.ph/file/394705b02d10509c435cf.jpg",
desc: "Estamos felizes em te ver aqui!"
}
});
console.log("Card gerado em:", card);🔊 7. ÁUDIO (TTS)
const audioTTS = await dark({
name: "audio.gtts",
input: { ling: "pt", text: "Dark API é braba!" }
});
console.log("Áudio salvo em:", audioTTS);🎤 8. VOZ (IA Voice)
const voz = await dark({
name: "voice.laura",
input: { prompt: "Seja bem-vindo ao Dark Stars API!" }
});
console.log("Voz gerada em:", voz);🎬 9. VÍDEO (IA Video)
const video = await dark({
name: "video.veo",
input: { prompt: "A cat flying in space" }
});
console.log(video);🎵 10. MÚSICA (IA Music)
const music = await dark({
name: "music.musicgen",
input: { prompt: "trap beat futuristic" }
});
console.log(music);📑 Estrutura Geral das Rotas
Cada recurso possui um nome seguindo o padrão:
categoria.subcategoria.rotaExemplo:
| Categoria | Nome | Chamada |
|----------|------|---------|
| Sticker | v3 attp7 | sticker.v3.attp7 |
| Canvas | Welcome v2 | canvas.welcome.v2 |
| IA Texto | GPT | ai.gpt |
| Image IA | Dalle | img.dalle |
❗ Tratamento de Erros
Caso o usuário informe input errado, todas as rotas retornam:
throw new Error("rota precisa de { parâmetro }.");Exemplo:
await dark({
name: "search.youtube",
input: {}
});
// ❌ search.youtube precisa de { query }.📄 Lista Completa de Rotas
Consulte a documentação oficial da Dark Stars API para ver todas as rotas disponíveis e parâmetros obrigatórios/opcionais.
Padrão de nomenclatura: categoria.subcategoria.recurso
Exemplos comuns:
ai.gpt/ai.gemini/ai.deepseekimg.dalle/img.flux/img.stablecanvas.level/canvas.shipsticker.v3.attp*/sticker.meme
❤️ Créditos & Suporte
- API → Dark Stars API
- SDK → Desenvolvido por Pedrozz Mods (@pedrozz_13755)
- Sugestões, bugs e pull requests são super bem-vindos!
