Changelog

​

Poll a video task with the id you already have

curl "https://api.meshapi.ai/v1/video/generations/req_01ARZ3NDEKTSV4RRFFQ69G5FAV" \
  -H "Authorization: Bearer rsk_..." \
  -H "X-Mesh-Version: 2026-09"

• Tasks created before 20 August 2026 predate the recorded request id and stay reachable by task id only.
• 2026-08 is still the baseline, so an unpinned request is unaffected. Send the header (or pin it on your key) to use this.

​

A video input a model cannot take is now a 422

{
  "error": {
    "code": "unprocessable_entity",
    "message": "Model 'bytedance/seedance-1.0-lite' on provider 'together' cannot use content[1] (image_url → last_frame). It would be dropped and the generation billed anyway — remove it, or choose a model that takes it."
  },
  "request_id": "req_..."
}

​

Pin the API contract to a date

curl https://api.meshapi.ai/v1/models \
  -H "Authorization: Bearer rsk_..." \
  -H "X-Mesh-Version: 2026-08"

• GET /v1/api-versions lists every version served, with its status, release date, and which one is the baseline and which is latest.
• An API key can carry a pin, so code you do not control still gets a fixed contract — set it on the key’s API Version field under API Keys. A header on the request wins over the key’s pin.
• Every response echoes X-Mesh-Version with the version that served it.
• A version Mesh does not serve is rejected with 400 invalid_api_version rather than silently downgraded, so a typo’d pin fails immediately instead of quietly serving you something else. The error body lists supported_versions.

​

Node.js SDK 2.0.0 — the request id rides on what each call returns

const completion = await client.chat.completions.create(params);
console.log(completion.requestId);

const stream = client.chat.completions.create({ ...params, stream: true });
console.log(await stream.requestId); // resolves when headers arrive, before the first chunk
for await (const chunk of stream) { /* ... */ }

• Every streaming method returns an SSEStream<T>, an AsyncIterable that also carries requestId as a promise. It stays readable after a mid-stream failure or an abort, which is when you most want it.
• SSEStream.cancel() releases the connection for a stream you read the id from but never iterated. It is also wired to Symbol.asyncDispose for await using.
• Breaking out of a for await over a stream now closes the connection; previously it leaked the socket.
• Iterating one stream object twice no longer issues, and bills, a second request.
• Errors raised from a mid-stream error frame no longer report an empty requestId.

​

SDK releases

• Node.js 2.0.0 — request id on every returned value; onResponse removed (above).
• Node.js 1.0.4 — repaired Responses API streaming and the realtime ESM entry point; clearer error messages; models.free() / models.paid() now filter server-side via ?free=; the SDK version header matches the package version again.
• Node.js 1.0.2 — exposed x-request-id on successful responses via onResponse (superseded by 2.0.0 four days later).

​

Translate audio to English

client.audio.audio_translate(audio_bytes, AudioTranslationsParams(model="..."), filename="...")

client.audio.translations(audioBytes, { model: "..." }, { filename: "..." });

client.Audio.Translations(ctx, audioBytes, "filename.mp3", meshapi.AudioTranslationParams{Model: "..."})

​

Structured outputs in the SDKs

country = client.chat.completions.parse(params, response_format=Country)

const country = await client.chat.completions.parse(params, Country);

​

Realtime audio — GA protocol

​

SDK releases

• Python 0.1.12 — structured outputs, chat.completions.parse().
• Python 0.1.11 — realtime GA protocol.
• Python 0.1.10 — realtime TLS trusts the certifi bundle; stricter request params; error mapping matches the gateway’s error codes; image_bytes() helper for reading generated images; spec fields that had been dropped are now declared.
• Python 0.1.9 — transcription language_code example fixed.
• Python 0.1.8 — audio translations.
• Go v0.1.12 — realtime GA protocol.
• Go v0.1.11 — SSE buffer no longer truncates large frames; error mapping matches the gateway’s error codes; Bytes() helper for generated images; missing spec fields added.
• Go v0.1.10 — transcription language_code example fixed.
• Go v0.1.9 — audio translations.
• Node.js 1.0.0 — first stable release. Covers the full public data plane: moderations, web search, router select, models search and get, Responses API list and get, image edits, audio translations, plus structured outputs. The unreleased /v1/documents wrapper was removed ahead of 1.0.