JavaScript / TypeScript SDK

官方 @emini-ai/sdk 客户端 — 每个类别对应一个类，字段名称与 API 保持一致。

安装

bash

npm install @emini-ai/sdk

用法

typescript

import { EminiAI } from "@emini-ai/sdk";

const client = new EminiAI({ apiKey: process.env.EMINI_API_KEY! });

const result = await client.chat.completions.create({
  messages: [{ role: "user", content: "Bonjour" }],
  model: "claude-opus-5",
});
console.log(result.content);

流式输出

typescript

for await (const chunk of client.chat.completions.stream({
  messages: [{ role: "user", content: "Compte jusqu'a 10" }],
})) {
  process.stdout.write(chunk.delta);
}

异步任务（视频）

typescript

const generation = await client.video.generate({ prompt: "un chat qui code" });
const job = await generation.wait(); // sonde /v1/jobs/{id} jusqu'a completion
console.log(job.result_url);

类型化错误

每个 HTTP 状态码区间对应一个子类，避免手动解析错误代码：

typescript

import { InsufficientCreditsError } from "@emini-ai/sdk";

try {
  await client.chat.completions.create({ messages: [/* ... */] });
} catch (err) {
  if (err instanceof InsufficientCreditsError) {
    // credits insuffisants sur le compte (402)
  }
}

完整的错误类列表及各自对应的 HTTP 代码，请参见错误参考。

已覆盖的资源

chat、images、vision、embeddings、translation、audio、video、jobs、uploads、agents — Gateway 的每个类别对应一个类。

源代码

位于 monorepo 中的 sdks/js。