@apicity/fireworks

中文文档

0.27.0发布于 2026/11/06MITTypeScriptES Module近 30 天下载 3.6万

Fireworks AI供应商用于聊天完成,完成,并嵌入.

文档目录7 节

安装
快速启动
真实世界的例子: 重新排序候选段落, 然后流出一个 Llama 3.3 70B 答案
API 参考
推论
中间软件
许可证

@apicity/ 消防工作

Fireworks AI供应商用于聊天完成,完成,并嵌入.

运行时间依赖性 :

zod@^4.6.6 - 请求在每一个 POST 端点上附加计划 .schema

安装

npm install @apicity/fireworks
# or
pnpm add @apicity/fireworks

快速启动

import { createFireworks } from "@apicity/fireworks";

const fireworks = createFireworks({ apiKey: process.env.FIREWORKS_API_KEY! });

真实世界的例子: 重新排序候选段落, 然后流出一个 Llama 3.3 70B 答案

烟花飞来两道推论表面清净地组成一个轻量级RAG管道:主机跨编码器重排(qwen3-reranker-8b(中文(简体) ) 对 N 候选文件的查询进行评分,并且 OpenAI 兼容 llama 3.3 70B Instruct上的流式聊天完成. 重排是硬部分——大多数提供者只销售嵌入式——和流式聊天是个便宜又快的尾巴镜下两步流 tests/integration/fireworks-rerank.test.ts 财务报告和审定财务报表 tests/integration/fireworks-stream.test.ts, (中文(简体) ), 反弹 tests/recordings/fireworks_626462085/rerank-basic_678261817/ 财务报告和审定财务报表 tests/recordings/fireworks_626462085/chat-stream-hello_2801342443/, (中文(简体) ), 因此,每个分数,符号计数,和下面的SSE形状直接来自记录的HARs.

import { createFireworks } from "@apicity/fireworks";
import type {
  FireworksRerankResponse,
  FireworksChatStreamChunk,
} from "@apicity/fireworks";

const fireworks = createFireworks({ apiKey: process.env.FIREWORKS_API_KEY! });

// 1. Cross-encoder rerank. The model sees the query and each document
//    jointly (unlike embedding-based retrieval, which scores them
//    independently), so it picks up phrasing-level signal that ANN
//    search misses. `top_n` caps the response length; `return_documents:
//    true` echoes the document text back inline so you can hand the
//    top hit straight to a chat model without keeping a parallel
//    id→text map.
const ranked: FireworksRerankResponse =
  await fireworks.inference.v1.rerank({
    model: "fireworks/qwen3-reranker-8b",
    query: "What is the capital of France?",
    documents: [
      "Berlin is the capital of Germany.",
      "Paris is the capital and largest city of France.",
      "Madrid is the capital of Spain.",
    ],
    top_n: 2,
    return_documents: true,
  });

// 2. The response is sorted descending by relevance_score. The score
//    spread is huge — Paris ~0.96, Berlin ~0.0001, Madrid dropped — a
//    near-four-orders-of-magnitude gap that a cosine-similarity
//    retriever could never produce. `index` points back into the
//    original `documents` array.
const top = ranked.data[0];
console.log(`#1: index=${top.index}, score=${top.relevance_score.toFixed(4)}`);
console.log(`    "${top.document}"`);
// → "#1: index=1, score=0.9579"
// →     "Paris is the capital and largest city of France."

console.log(`model=${ranked.model}, tokens=${ranked.usage.prompt_tokens}`);
// → "model=accounts/fireworks/models/qwen3-reranker-8b, tokens=261"

// 3. Stream a chat answer through Llama 3.3 70B Instruct. The recorded
//    call below is a generic 'say hello' smoke test — independent from
//    the rerank above — but the request shape is exactly what you'd
//    send in production: drop `top.document` into a system message and
//    the user's original question into the user turn.
//    `temperature: 0` makes the output deterministic; `max_tokens: 64`
//    caps the response. The streaming surface lives under
//    `post.stream.*` and yields OpenAI-shaped
//    `chat.completion.chunk` objects.
let answer = "";
let finish: string | null = null;
let totals = { prompt: 0, completion: 0 };

const stream = fireworks.post.stream.inference.v1.chat.completions({
  model: "accounts/fireworks/models/llama-v3p3-70b-instruct",
  messages: [{ role: "user", content: "Say hello in one sentence." }],
  temperature: 0,
  max_tokens: 64,
});

for await (const chunk of stream) {
  // 4. Each delta carries one or two tokens of `content`. The FIRST
  //    delta carries `delta.role` and no content; the LAST delta has
  //    no content but `finish_reason: "stop"` and final `usage`.
  //    Read defensively — both fields are optional on every chunk.
  const choice: FireworksChatStreamChunk["choices"][number] | undefined =
    chunk.choices[0];
  if (choice?.delta?.content) answer += choice.delta.content;
  if (choice?.finish_reason) finish = choice.finish_reason;
  if (chunk.usage) {
    totals = {
      prompt: chunk.usage.prompt_tokens,
      completion: chunk.usage.completion_tokens,
    };
  }
}

console.log(answer);
// → "Hello, it's nice to meet you and I'm here to help with any questions or topics you'd like to discuss."
console.log(
  `finish=${finish}, prompt=${totals.prompt}, completion=${totals.completion}`,
);
// → "finish=stop, prompt=41, completion=26"

页:1

重排是交叉编码器,不是嵌入模型——它直接计算查询-文档交互,所以它实质上是比同位素相似性更准确而不是独立的嵌入, 但它并没有扩大到数百万候选人。标准混合是基于嵌入的 ANN 来获取一个上- 100, 那么 qwen3-reranker-8b 精炼到顶端3。烟花主机都一半在同一地域( 选项)/v1/embeddings 第一阶段, /v1/rerank 联合国页:1.
流出聊天块是 OpenAI 兼容的 : chat.completion.chunk 与 choices[].delta 含有增量内容。看着 finish_reason 想知道你是否中弹 "stop", (中文(简体) ), "length",或 "content_filter"只有最终块有 usage 人口; 中间块有 usage: null烟花也露出a 每一次通话 fireworks-cached-prompt-tokens 回应头-40 上面的41个缓存, 前缀几乎全部支付, 可见而不分析身体.
对同一Llama目录的Anthropic形状的反应,互换改为 fireworks.inference.v1.messages({...})模式标识和定价匹配,但反应是 { role, content: [{ type: "text", text }], ... } 改为 { choices: [{ message: { content }}] } - 当移植已写入的代码 @apicity/anthropic。。。 .
对于非分流完成,请放下 post.stream. 前缀 : fireworks.inference.v1.chat.completions({...}) 返回单个 FireworksChatResponse 与 choices[0].message.content 人口数完整 usage 在一枪。相同的有效载荷计划,在 fireworks.inference.v1.chat.completions.schema 运行时间在呼叫前验证.
丢出错误 FireworksError 与 status 和被剖析出的身体页:1. 400 从重新排序通常表示空/ 丢失 documents 阵列; 429 是费率限制; 503 是部署冷开始与 withRetry({ retries: 3 }) 从 @apicity/fireworks 没有密码的冷部署.

API 参考

98个终点跨一组. 每个方法都映射出上游的 URL 路径 .

推论

POST fireworks.inference.v1.accounts.apiKeys.create

POST https://api.fireworks.ai/v1/accounts/{accountId}/users/{userId}/apiKeys

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.apiKeys.create({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

DELETE fireworks.inference.v1.accounts.apiKeys

DELETE https://api.fireworks.ai/v1/accounts/{accountId}/users/{userId}/apiKeys:delete

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.apiKeys.delete({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.apiKeys.list

GET https://api.fireworks.ai/v1/accounts/{accountId}/users/{userId}/apiKeys

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.apiKeys.list({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.batchInferenceJobs.create

POST https://api.fireworks.ai/v1/accounts/{accountId}/batchInferenceJobs

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.batchInferenceJobs.create({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

DELETE fireworks.inference.v1.accounts.batchInferenceJobs

DELETE https://api.fireworks.ai/v1/accounts/{accountId}/batchInferenceJobs/{jobId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.batchInferenceJobs.delete({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.batchInferenceJobs

GET https://api.fireworks.ai/v1/accounts/{accountId}/batchInferenceJobs/{jobId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.batchInferenceJobs.get({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.batchInferenceJobs.list

GET https://api.fireworks.ai/v1/accounts/{accountId}/batchInferenceJobs

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.batchInferenceJobs.list({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.datasets.create

POST https://api.fireworks.ai/v1/accounts/{accountId}/datasets

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.datasets.create({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

DELETE fireworks.inference.v1.accounts.datasets

DELETE https://api.fireworks.ai/v1/accounts/{accountId}/datasets/{datasetId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.datasets.delete({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.datasets

GET https://api.fireworks.ai/v1/accounts/{accountId}/datasets/{datasetId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.datasets.get({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.datasets.getDownloadEndpoint

GET https://api.fireworks.ai/v1/accounts/{accountId}/datasets/{datasetId}:getDownloadEndpoint

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.datasets.getDownloadEndpoint({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.datasets.getUploadEndpoint

POST https://api.fireworks.ai/v1/accounts/{accountId}/datasets/{datasetId}:getUploadEndpoint

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.datasets.getUploadEndpoint({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.datasets.list

GET https://api.fireworks.ai/v1/accounts/{accountId}/datasets

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.datasets.list({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

PATCH fireworks.inference.v1.accounts.datasets.update

PATCH https://api.fireworks.ai/v1/accounts/{accountId}/datasets/{datasetId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.datasets.update({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.datasets.validateUpload

POST https://api.fireworks.ai/v1/accounts/{accountId}/datasets/{datasetId}:validateUpload

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.datasets.validateUpload({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.deployedModels.create

POST https://api.fireworks.ai/v1/accounts/{accountId}/deployedModels

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.deployedModels.create({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

DELETE fireworks.inference.v1.accounts.deployedModels

DELETE https://api.fireworks.ai/v1/accounts/{accountId}/deployedModels/{deployedModelId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.deployedModels.delete({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.deployedModels

GET https://api.fireworks.ai/v1/accounts/{accountId}/deployedModels/{deployedModelId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.deployedModels.get({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.deployedModels.list

GET https://api.fireworks.ai/v1/accounts/{accountId}/deployedModels

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.deployedModels.list({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

PATCH fireworks.inference.v1.accounts.deployedModels.update

PATCH https://api.fireworks.ai/v1/accounts/{accountId}/deployedModels/{deployedModelId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.deployedModels.update({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.deploymentShapes

GET https://api.fireworks.ai/v1/accounts/{accountId}/deploymentShapes/{shapeId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.deploymentShapes.get({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.deploymentShapes.versions

GET https://api.fireworks.ai/v1/accounts/{accountId}/deploymentShapes/{shapeId}/versions/{versionId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.deploymentShapes.versions.get({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.deploymentShapes.versions.list

GET https://api.fireworks.ai/v1/accounts/{accountId}/deploymentShapes/{shapeId}/versions

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.deploymentShapes.versions.list({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.deployments.create

POST https://api.fireworks.ai/v1/accounts/{accountId}/deployments

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.deployments.create({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

DELETE fireworks.inference.v1.accounts.deployments

DELETE https://api.fireworks.ai/v1/accounts/{accountId}/deployments/{deploymentId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.deployments.delete({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.deployments

GET https://api.fireworks.ai/v1/accounts/{accountId}/deployments/{deploymentId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.deployments.get({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.deployments.list

GET https://api.fireworks.ai/v1/accounts/{accountId}/deployments

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.deployments.list({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

PATCH fireworks.inference.v1.accounts.deployments.scale

PATCH https://api.fireworks.ai/v1/accounts/{accountId}/deployments/{deploymentId}:scale

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.deployments.scale({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.deployments.undelete

POST https://api.fireworks.ai/v1/accounts/{accountId}/deployments/{deploymentId}:undelete

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.deployments.undelete({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

PATCH fireworks.inference.v1.accounts.deployments.update

PATCH https://api.fireworks.ai/v1/accounts/{accountId}/deployments/{deploymentId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.deployments.update({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.dpoJobs.create

POST https://api.fireworks.ai/v1/accounts/{accountId}/dpoJobs

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.dpoJobs.create({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

DELETE fireworks.inference.v1.accounts.dpoJobs

DELETE https://api.fireworks.ai/v1/accounts/{accountId}/dpoJobs/{jobId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.dpoJobs.delete({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.dpoJobs

GET https://api.fireworks.ai/v1/accounts/{accountId}/dpoJobs/{jobId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.dpoJobs.get({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.dpoJobs.getMetricsFileEndpoint

GET https://api.fireworks.ai/v1/accounts/{accountId}/dpoJobs/{jobId}:getMetricsFileEndpoint

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.dpoJobs.getMetricsFileEndpoint({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.dpoJobs.list

GET https://api.fireworks.ai/v1/accounts/{accountId}/dpoJobs

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.dpoJobs.list({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.dpoJobs.resume

POST https://api.fireworks.ai/v1/accounts/{accountId}/dpoJobs/{jobId}:resume

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.dpoJobs.resume({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.evaluationJobs.create

POST https://api.fireworks.ai/v1/accounts/{accountId}/evaluationJobs

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.evaluationJobs.create({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

DELETE fireworks.inference.v1.accounts.evaluationJobs

DELETE https://api.fireworks.ai/v1/accounts/{accountId}/evaluationJobs/{evaluationJobId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.evaluationJobs.delete({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.evaluationJobs

GET https://api.fireworks.ai/v1/accounts/{accountId}/evaluationJobs/{evaluationJobId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.evaluationJobs.get({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.evaluationJobs.getExecutionLogEndpoint

GET https://api.fireworks.ai/v1/accounts/{accountId}/evaluationJobs/{evaluationJobId}:getExecutionLogEndpoint

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.evaluationJobs.getExecutionLogEndpoint({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.evaluationJobs.list

GET https://api.fireworks.ai/v1/accounts/{accountId}/evaluationJobs

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.evaluationJobs.list({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.evaluators.create

POST https://api.fireworks.ai/v1/accounts/{accountId}/evaluatorsV2

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.evaluators.create({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

DELETE fireworks.inference.v1.accounts.evaluators

DELETE https://api.fireworks.ai/v1/accounts/{accountId}/evaluators/{evaluatorId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.evaluators.delete({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.evaluators

GET https://api.fireworks.ai/v1/accounts/{accountId}/evaluators/{evaluatorId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.evaluators.get({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.evaluators.getBuildLogEndpoint

GET https://api.fireworks.ai/v1/accounts/{accountId}/evaluators/{evaluatorId}:getBuildLogEndpoint

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.evaluators.getBuildLogEndpoint({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.evaluators.getSourceCodeSignedUrl

GET https://api.fireworks.ai/v1/accounts/{accountId}/evaluators/{evaluatorId}:getSourceCodeSignedUrl

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.evaluators.getSourceCodeSignedUrl({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.evaluators.getUploadEndpoint

POST https://api.fireworks.ai/v1/accounts/{accountId}/evaluators/{evaluatorId}:getUploadEndpoint

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.evaluators.getUploadEndpoint({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.evaluators.list

GET https://api.fireworks.ai/v1/accounts/{accountId}/evaluators

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.evaluators.list({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

PATCH fireworks.inference.v1.accounts.evaluators.update

PATCH https://api.fireworks.ai/v1/accounts/{accountId}/evaluators/{evaluatorId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.evaluators.update({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.evaluators.validateUpload

POST https://api.fireworks.ai/v1/accounts/{accountId}/evaluators/{evaluatorId}:validateUpload

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.evaluators.validateUpload({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts

GET https://api.fireworks.ai/v1/accounts/{accountId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.get({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.list

GET https://api.fireworks.ai/v1/accounts

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.list({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.models.create

POST https://api.fireworks.ai/v1/accounts/{accountId}/models

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.models.create({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

DELETE fireworks.inference.v1.accounts.models

DELETE https://api.fireworks.ai/v1/accounts/{accountId}/models/{modelId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.models.delete({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.models

GET https://api.fireworks.ai/v1/accounts/{accountId}/models/{modelId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.models.get({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.models.getDownloadEndpoint

GET https://api.fireworks.ai/v1/accounts/{accountId}/models/{modelId}:getDownloadEndpoint

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.models.getDownloadEndpoint({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.models.getUploadEndpoint

POST https://api.fireworks.ai/v1/accounts/{accountId}/models/{modelId}:getUploadEndpoint

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.models.getUploadEndpoint({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.models.list

GET https://api.fireworks.ai/v1/accounts/{accountId}/models

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.models.list({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.models.prepare

POST https://api.fireworks.ai/v1/accounts/{accountId}/models/{modelId}:prepare

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.models.prepare({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

PATCH fireworks.inference.v1.accounts.models.update

PATCH https://api.fireworks.ai/v1/accounts/{accountId}/models/{modelId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.models.update({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.models.validateUpload

GET https://api.fireworks.ai/v1/accounts/{accountId}/models/{modelId}:validateUpload

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.models.validateUpload({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.reinforcementFineTuningJobs.create

POST https://api.fireworks.ai/v1/accounts/{accountId}/reinforcementFineTuningJobs

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.reinforcementFineTuningJobs.create({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

DELETE fireworks.inference.v1.accounts.reinforcementFineTuningJobs

DELETE https://api.fireworks.ai/v1/accounts/{accountId}/reinforcementFineTuningJobs/{jobId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.reinforcementFineTuningJobs.delete({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.reinforcementFineTuningJobs

GET https://api.fireworks.ai/v1/accounts/{accountId}/reinforcementFineTuningJobs/{jobId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.reinforcementFineTuningJobs.get({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.reinforcementFineTuningJobs.list

GET https://api.fireworks.ai/v1/accounts/{accountId}/reinforcementFineTuningJobs

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.reinforcementFineTuningJobs.list({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.reinforcementFineTuningJobs.resume

POST https://api.fireworks.ai/v1/accounts/{accountId}/reinforcementFineTuningJobs/{jobId}:resume

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.reinforcementFineTuningJobs.resume({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.rlorTrainerJobs.create

POST https://api.fireworks.ai/v1/accounts/{accountId}/rlorTrainerJobs

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.rlorTrainerJobs.create({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

DELETE fireworks.inference.v1.accounts.rlorTrainerJobs

DELETE https://api.fireworks.ai/v1/accounts/{accountId}/rlorTrainerJobs/{jobId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.rlorTrainerJobs.delete({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.rlorTrainerJobs.executeTrainStep

POST https://api.fireworks.ai/v1/accounts/{accountId}/rlorTrainerJobs/{jobId}:executeTrainStep

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.rlorTrainerJobs.executeTrainStep({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.rlorTrainerJobs

GET https://api.fireworks.ai/v1/accounts/{accountId}/rlorTrainerJobs/{jobId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.rlorTrainerJobs.get({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.rlorTrainerJobs.list

GET https://api.fireworks.ai/v1/accounts/{accountId}/rlorTrainerJobs

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.rlorTrainerJobs.list({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.rlorTrainerJobs.resume

POST https://api.fireworks.ai/v1/accounts/{accountId}/rlorTrainerJobs/{jobId}:resume

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.rlorTrainerJobs.resume({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.secrets.create

POST https://api.fireworks.ai/v1/accounts/{accountId}/secrets

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.secrets.create({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

DELETE fireworks.inference.v1.accounts.secrets

DELETE https://api.fireworks.ai/v1/accounts/{accountId}/secrets/{secretId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.secrets.delete({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.secrets

GET https://api.fireworks.ai/v1/accounts/{accountId}/secrets/{secretId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.secrets.get({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.secrets.list

GET https://api.fireworks.ai/v1/accounts/{accountId}/secrets

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.secrets.list({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

PATCH fireworks.inference.v1.accounts.secrets.update

PATCH https://api.fireworks.ai/v1/accounts/{accountId}/secrets/{secretId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.secrets.update({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.supervisedFineTuningJobs.create

POST https://api.fireworks.ai/v1/accounts/{accountId}/supervisedFineTuningJobs

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.supervisedFineTuningJobs.create({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

DELETE fireworks.inference.v1.accounts.supervisedFineTuningJobs

DELETE https://api.fireworks.ai/v1/accounts/{param}/supervisedFineTuningJobs/{param}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.supervisedFineTuningJobs.delete({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.supervisedFineTuningJobs

GET https://api.fireworks.ai/v1/accounts/{param}/supervisedFineTuningJobs/{param}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.supervisedFineTuningJobs.get({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.supervisedFineTuningJobs.list

GET https://api.fireworks.ai/v1/accounts/{accountId}/supervisedFineTuningJobs

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.supervisedFineTuningJobs.list({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.supervisedFineTuningJobs.resume

POST https://api.fireworks.ai/v1/accounts/{param}/supervisedFineTuningJobs/{param}:resume

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.supervisedFineTuningJobs.resume({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.users.create

POST https://api.fireworks.ai/v1/accounts/{accountId}/users

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.users.create({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.users

GET https://api.fireworks.ai/v1/accounts/{accountId}/users/{userId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.users.get({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.accounts.users.list

GET https://api.fireworks.ai/v1/accounts/{accountId}/users

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.users.list({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

PATCH fireworks.inference.v1.accounts.users.update

PATCH https://api.fireworks.ai/v1/accounts/{accountId}/users/{userId}

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.accounts.users.update({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

GET fireworks.inference.v1.audio.batch

GET https://api.fireworks.ai/v1/accounts/{accountId}/batch_job/{batchId}

成本等级 : expensive

上游区域

折旧: 烟花公司于2026-06-10日贬值了音频推论,给出了不关闭日期,不再公布其费率,因此成本估算未能关闭. 2026-11-05 (英语) audio-batch 已回复 submitted 以空请求 endpoint_id=audio-prod 或者说 audio-turbo,而状态端点对其签发的ID进行了404的回答. 真实提交是否运行未证实。这种方法仍然发出请求,没有改变,但烟花公司可能会不通知就停止回答.

const res = await fireworks.inference.v1.audio.batch.get({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.audio.batch.transcriptions

POST https://api.fireworks.ai/inference/v1/audio/transcriptions

成本等级 : expensive

上游区域

折旧: 烟花公司于2026-06-10日贬值了音频推论,给出了不关闭日期,不再公布其费率,因此成本估算未能关闭. 2026-11-05 (英语) audio-batch 已回复 submitted 以空请求 endpoint_id=audio-prod 或者说 audio-turbo,而状态端点对其签发的ID进行了404的回答. 真实提交是否运行未证实。这种方法仍然发出请求,没有改变,但烟花公司可能会不通知就停止回答.

const res = await fireworks.inference.v1.audio.batch.transcriptions({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.audio.batch.translations

POST https://api.fireworks.ai/inference/v1/audio/translations

成本等级 : expensive

上游区域

折旧: 烟花公司于2026-06-10日贬值了音频推论,给出了不关闭日期,不再公布其费率,因此成本估算未能关闭. 2026-11-05 (英语) audio-batch 已回复 submitted 以空请求 endpoint_id=audio-prod 或者说 audio-turbo,而状态端点对其签发的ID进行了404的回答. 真实提交是否运行未证实。这种方法仍然发出请求,没有改变,但烟花公司可能会不通知就停止回答.

const res = await fireworks.inference.v1.audio.batch.translations({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.audio.transcriptions

POST https://api.fireworks.ai/inference/v1/audio/transcriptions

成本等级 : expensive

上游区域

折旧: 烟花公司于2026-06-10日贬值了音频推论,给出了不关闭日期,不再公布其费率,因此成本估算未能关闭. 2026-11-05 (英语) audio-prod 在真实路径和编造路径上,401对有效的密钥进行了回答 audio-turbo 回答503,没有健康的上游。这种方法仍然发出请求,没有改变,但烟花公司可能会不通知就停止回答.

const res = await fireworks.inference.v1.audio.transcriptions({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.audio.translations

POST https://api.fireworks.ai/inference/v1/audio/translations

成本等级 : expensive

上游区域

折旧: 烟花公司于2026-06-10日贬值了音频推论,给出了不关闭日期,不再公布其费率,因此成本估算未能关闭. 2026-11-05 (英语) audio-prod 在真实路径和编造路径上,401对有效的密钥进行了回答 audio-turbo 回答503,没有健康的上游。这种方法仍然发出请求,没有改变,但烟花公司可能会不通知就停止回答.

const res = await fireworks.inference.v1.audio.translations({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.chat.completions

POST https://api.fireworks.ai/inference/v1/chat/completions

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.chat.completions({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.completions

POST https://api.fireworks.ai/inference/v1/completions

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.completions({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.embeddings

POST https://api.fireworks.ai/inference/v1/embeddings

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.embeddings({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.rerank

POST https://api.fireworks.ai/inference/v1/rerank

成本等级 : expensive

上游区域

const res = await fireworks.inference.v1.rerank({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.accounts.users.update

POST https://api.fireworks.ai/v1/accounts/{accountId}/users/{userId}

成本等级 : expensive

上游区域

const res = await fireworks.post.inference.v1.accounts.users.update({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.inference.v1.messages

POST https://api.fireworks.ai/inference/v1/messages

成本等级 : expensive

上游区域

const res = await fireworks.post.inference.v1.messages({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

POST fireworks.post.stream.inference.v1.messages

POST https://api.fireworks.ai/inference/v1/messages

成本等级 : expensive

上游区域

const res = await fireworks.post.stream.inference.v1.messages({ /* ... */ });

资料来源: packages/provider/fireworks/src/fireworks.ts

中间软件

import { createFireworks, withRetry } from "@apicity/fireworks";

const fireworks = createFireworks({ apiKey: process.env.FIREWORKS_API_KEY! });
const listAccounts = withRetry(fireworks.inference.v1.accounts.list, { retries: 3 });

部分辣点单相机.

许可证

麻省理工学院——见自由主义。。。 .

版本与发布记录

@apicity/fireworks 共发布 90 个版本，首次发布于 2026/05/10；过去 12 个月发布了 90 个版本。

版本	发布日期	距今
`0.27.0`latest	2026/11/06	今天
`0.26.0`	2026/11/05	1 天前
`0.25.0`	2026/11/03	3 天前
`0.24.1`	2026/11/02	4 天前
`0.24.0`	2026/11/01	4 天前
`0.23.1`	2026/11/01	5 天前

关于 @apicity/fireworks 的常见问题

@apicity/fireworks 是什么？

Fireworks AI供应商用于聊天完成,完成,并嵌入.

如何安装 @apicity/fireworks？

在项目目录运行 npm install @apicity/fireworks，或使用 pnpm add / yarn add / bun add。

@apicity/fireworks 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

@apicity/fireworks 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。

@apicity/fireworks 需要什么版本的 Node.js？

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

@apicity/fireworks 可以商用吗？

@apicity/fireworks 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

@apicity/fireworks 的下载量有多少？

根据 npm 官方下载统计，@apicity/fireworks 在 2026/10/06 – 2026/11/04 这 30 天内被下载 35,891 次，日均约 1,196 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@apicity/fireworks 还在维护吗？

最新版本 0.27.0 发布于 2026/11/06（今天）；至今共发布 90 个版本，其中过去 12 个月发布了 90 个；首次发布于 2026/05/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

npm install @apicity/fireworks

pnpmpnpm add @apicity/fireworks
yarnyarn add @apicity/fireworks
bunbun add @apicity/fireworks

在你的项目目录中运行此命令。

近 30 天下载

35,891

约 3.6万次日均 1,196 次

统计周期 2026/10/06 – 2026/11/04
数据来自 npm 官方下载统计，今天更新

最新版本0.27.0发布于今天

开源许可MIT宽松许可

包体积557 kB43 个文件 · 解压后

运行依赖1 个

模块格式ES Module无副作用，可 tree-shake

TypeScript自带类型

Node.js>=18.0.0

发布版本90 个近 12 个月 90 个

首次发布2026/05/105 个月前

元数据更新2026/11/06

每一个软件包背后，
都有分享与创造的人。