AbsoluteJS

@absolutejs/voice-neets

@absolutejs/voice-neetsv0.0.1-beta.6betaVoice & Media

Neets text-to-speech adapter for @absolutejs/voice

#Installation

BASH
bun add @absolutejs/voice-neets

#Capabilities

Overview

Neets text-to-speech adapter for @absolutejs/voice.

Wraps Neets's /v1/tts HTTP endpoint for low-cost TTS using their ar-diff-50k / style-tts-2 / vits models. Streams audio body straight through to voice's runtime.

Options

Option — Required — Default — Notes

apiKey — yes — — — Neets API key, sent as X-API-Key.

voiceId — yes — — — Neets voice id.

Show 7 more

model — no — ar-diff-50k — ar-diff-50k, style-tts-2, vits, or a future Neets model id.

format — no — pcm — Must be pcm. mp3 / wav are rejected because they aren't streamable frame-by-frame.

sampleRate — no — 22050 — Forwarded as sample_rate.

language — no — — — Forwarded as language (e.g. en-us, es-es).

temperature — no — — — Forwarded inside params.

baseUrl — no — https://api.neets.ai — Override for staging.

fetch — no — globalThis.fetch — Inject for tests; opportunistic HTTP/2 multiplexing on outbound HTTPS.

Notes

Whitespace-only send() is a no-op.

session.close(reason) aborts in-flight requests and refuses further sends.

Outcomes

What you can build

Build on the supported package contract

Use @absolutejs/voice-neets through its supported public entry points.

Hardening checklist

Production guidance

Make every external boundary explicitPin the deployed @absolutejs/voice-neets version, replace example or memory-backed dependencies with durable implementations, bound external calls, protect credentials, and emit enough evidence to retry or recover safely.

Follow in order

Troubleshooting path

1
Trace from the first failed boundary
Reproduce the smallest canonical @absolutejs/voice-neets example, confirm the supported entry point and version in the API explorer, then inspect the first boundary that did not produce its documented result.

#Use

Partial snippet

Working example for Use.

TS
import { voice } from "@absolutejs/voice";
import { neets } from "@absolutejs/voice-neets";

const app = voice({
  tts: neets({
    apiKey: process.env.NEETS_API_KEY!,
    voiceId: "us-male-2",
    // optional:
    model: "ar-diff-50k", // default; or 'style-tts-2' / 'vits'
    format: "pcm", // default; only "pcm" is supported for streaming
    sampleRate: 22_050, // default
    language: "en-us",
    temperature: 0.7,
  }),
});

#Public entry points

Supported entry points declared by this package manifest.

Package entry point declared in package.json.

@absolutejs/voice-neets@absolutejs/voice-neets/manifest@absolutejs/voice-neets/manifest.json

#Package commands

Scripts declared by this package manifest.

bun run buildrm -rf dist && bun build ./src/index.ts ./src/manifest.ts --outdir dist --target bun --external @absolutejs/manifest --external '@absolutejs/manifest/*' --external @absolutejs/voice --external '@absolutejs/voice/*' --external @sinclair/typebox --external '@sinclair/typebox/*' && tsc --emitDeclarationOnly --project tsconfig.json && absolute-manifest emit
bun run check:packagebun run format && bun run typecheck && bun run test && bun run verify-package && bun run build && bun run verify-package --artifacts
bun run formatprettier --write "./**/*.{js,ts,json,md}"
bun run testbun test
bun run typecheckbun run tsc --noEmit