知識庫 / 開發者

圖像、音訊與嵌入向量

來自應用程式的生成器，以及搜尋的構建區塊：圖片、 影片、語音、逐字稿和嵌入，每一項皆從您的餘額中按使用量計費。

為了方便起見，此頁面是機器翻譯的。英文原件為適用版本。

生成圖像

根據提示詞生成一到四張圖片，並在完成後回傳。它與以下生成器為同一套： ?image 在應用程式中。

POST https://nymbot.ai/api/v1/images/generations — 需要 API 金鑰，或者 每次請求一次 Lightning 付款.

Ids 來自於 GET /api/v1/models?type=image. 標準生成器， @cf/black-forest-labs/flux-1-schnell，每張圖片固定花費 5 個標準積分 (50 sats)。其他每個生成器都以各自的價格消耗 Pro 積分，並包含通常的費用和利潤，如： 該應用程式. n 圖片費用 n 倍數。產生器不接受的欄位會被捨棄而非拒絕； 標準產生器僅使用提示。

resolution 未使用：每個產生器都會產生自己的大小。With url, 每張圖片都會上傳到公開的 Blossom 主機並提供其連結（只有少數生成器 會回傳自己的連結，並將其轉發）。任何擁有連結的人都可以開啟它，且 一旦上傳便無法撤下；請參閱 API 可以看到什麼。帶著 b64_json 圖片在回應中返回，從未被上傳。一張作為...發送的圖片 data: URL 輸入 image_url 是以與...相同的方式檢查嗎 編輯 並先上傳至 Blossom 以便產生器可以獲取它；它 如果請求失敗

如果其中的一些 n 照片失敗，您只會收到成功的那些，且僅針對 成功的部分（以及提供商儘管失敗仍收取的任何費用）進行計費，並且 nymbot.failed 說明有多少個遺失。如果全部失敗，請求將返回 502.

回應

{
  "created": 1790726400,
  "model": "nano-banana",
  "cost": 0.2126,
  "data": [
    {
      "url": "https://blossom.example/5c0e4b7d3a91f2e8...c4.png",
      "content_type": "image/png"
    }
  ],
  "nymbot": { "balance": "pro", "charged_credits": 1.817, "charged_sats": 181.7, "balance_credits": 410.608, "balance_sats": 41060.8 }
}

cURL

curl https://nymbot.ai/api/v1/images/generations \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana",
    "prompt": "A lighthouse at dusk, oil painting",
    "size": "16:9"
  }'

Python

import os
import requests

res = requests.post(
    "https://nymbot.ai/api/v1/images/generations",
    headers={"Authorization": "Bearer " + os.environ["NYMBOT_API_KEY"]},
    json={"model": "nano-banana", "prompt": "A lighthouse at dusk, oil painting", "size": "16:9"},
)
res.raise_for_status()
print(res.json()["data"][0]["url"])

JavaScript

const res = await fetch("https://nymbot.ai/api/v1/images/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.NYMBOT_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ model: "nano-banana", prompt: "A lighthouse at dusk, oil painting", size: "16:9" }),
});
const body = await res.json();
console.log(body.data[0].url);

編輯圖片

根據提示修改您上傳的照片。這是 OpenAI 的編輯端點，因此 OpenAI SDKs' images.edit 照常運作。只有 Pro 生成器具備 edit 在 模型列表中接受它。

POST https://nymbot.ai/api/v1/images/edits — 需要 API 金鑰，或者 每次請求一次 Lightning 付款. 身體是 multipart/form-data，最高可達 32 MB。

您上傳的圖片會被檢查是否為格式正確的 PNG、JPEG、WebP 或 GIF，並以其真實類型發送，且會放置在公開的 Blossom 主機上，因為生成器是透過連結獲取輸入內容的。 請將其視為公開內容。如果編輯失敗且未收取費用，存放的副本將會再次被刪除。回應的格式與生成時相同。 定價方式為生成器的價格，某些生成器的價格會包含輸入圖片的費用。

回應

{
  "created": 1790726460,
  "model": "nano-banana",
  "cost": 0.2126,
  "data": [{ "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." }],
  "nymbot": { "balance": "pro", "charged_credits": 1.817, "charged_sats": 181.7, "balance_credits": 408.791, "balance_sats": 40879.1 }
}

cURL

curl https://nymbot.ai/api/v1/images/edits \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -F model=nano-banana \
  -F [email protected] \
  -F prompt="Make it a snowy evening"

Python

import base64, os
from openai import OpenAI

client = OpenAI(base_url="https://nymbot.ai/api/v1", api_key=os.environ["NYMBOT_API_KEY"])

with open("photo.png", "rb") as f:
    result = client.images.edit(model="nano-banana", image=f, prompt="Make it a snowy evening")

with open("edited.png", "wb") as out:
    out.write(base64.b64decode(result.data[0].b64_json))

JavaScript

import fs from "node:fs";
import { writeFile } from "node:fs/promises";
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nymbot.ai/api/v1", apiKey: process.env.NYMBOT_API_KEY });

const result = await client.images.edit({
  model: "nano-banana",
  image: fs.createReadStream("photo.png"),
  prompt: "Make it a snowy evening",
});
await writeFile("edited.png", Buffer.from(result.data[0].b64_json, "base64"));

影片

影片需要幾分鐘的時間，因此會在背景執行。你提交影片後會立即獲得一個 ID，並持續詢問該 ID 的狀態直到完成。每個影片生成器都會消耗 Pro 餘額。

POST https://nymbot.ai/api/v1/videos — 需要 API 金鑰，或者 每次請求一次 Lightning 付款. 回傳 202.

價格在您從產生器提交時即已固定，包含解析度與長度，因此一旦供應商接受任務，便會從您的 Pro 餘額中扣除，並顯示為 cost, estimated_cost 和 nymbot若提供者拒絕工作，則不會收取任何費用。若之後渲染失敗，或完成的剪輯無法儲存且提供者未對其進行計費，則該費用將自動退還一次。若渲染進行超過一小時仍未完成，則視為放棄，並保留該筆費用，因為提供者在接受渲染後即會進行計費。退款會退還點數，但不會降低金鑰的支出次數。

回應 (202)

{
  "id": "vid_3e9a51c07b2f4d86e0a1c4f2",
  "object": "video",
  "model": "veo",
  "status": "in_progress",
  "created": 1790726400,
  "seconds": 8,
  "resolution": "1080p",
  "estimated_cost": 3.18,
  "expires_at": 1790812800,
  "cost": 3.18,
  "nymbot": { "balance": "pro", "charged_credits": 31.8, "charged_sats": 3180, "balance_credits": 378.808, "balance_sats": 37880.8 }
}

status 開始於 in_progress, 或者 completed 隨著影片 已經在 data 當發電機立刻回傳時。

正在檢查一段影片

GET https://nymbot.ai/api/v1/videos/{id} — 需要一個屬於提交該 nym 的金鑰。達到上限的金鑰仍可進行檢查。

它回答了 202 在影片製作期間以及 200 一旦完成或失敗。每 5 到 10 秒詢問一次。每次檢查僅向提供者詢問一次並立即回答；它絕不會等待影片。作業在提交後會保留 24 小時。 GET /api/v1/videos 列出金鑰最後的 50 個工作為 {"object": "list", "data": […]}.

回應 (200)

{
  "id": "vid_3e9a51c07b2f4d86e0a1c4f2",
  "object": "video",
  "model": "veo",
  "status": "completed",
  "created": 1790726400,
  "seconds": 8,
  "resolution": "1080p",
  "estimated_cost": 3.18,
  "expires_at": 1790812800,
  "completed_at": 1790726590,
  "data": { "url": "https://blossom.example/9b41d0c2e7a3f658...1e.mp4", "content_type": "video/mp4" },
  "cost": 3.18,
  "nymbot": { "balance": "pro", "charged_credits": 31.8, "charged_sats": 3180 }
}

status 是 in_progress, completed 或者 failed. A 失敗的工作帶來了 error ({"code": "generation_failed", "message": …}); 如果已退款， cost 是 0 和 nymbot 新增 refunded_credits 和 refunded_sats. 完成後的影片位於公開的 Blossom 主機上，就像生成的圖片一樣。

cURL

curl https://nymbot.ai/api/v1/videos \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "veo", "prompt": "Waves rolling onto a beach at sunrise", "duration": 8, "aspect_ratio": "16:9"}'

curl https://nymbot.ai/api/v1/videos/vid_3e9a51c07b2f4d86 \
  -H "Authorization: Bearer $NYMBOT_API_KEY"

Python

import os, time
import requests

headers = {"Authorization": "Bearer " + os.environ["NYMBOT_API_KEY"]}

job = requests.post(
    "https://nymbot.ai/api/v1/videos",
    headers=headers,
    json={"model": "veo", "prompt": "Waves rolling onto a beach at sunrise", "duration": 8, "aspect_ratio": "16:9"},
).json()

while True:
    time.sleep(8)
    status = requests.get("https://nymbot.ai/api/v1/videos/" + job["id"], headers=headers).json()
    if status["status"] in ("completed", "failed"):
        break

print(status["data"]["url"] if status["status"] == "completed" else status["error"])

JavaScript

const headers = {
  "Authorization": "Bearer " + process.env.NYMBOT_API_KEY,
  "Content-Type": "application/json",
};

const job = await (await fetch("https://nymbot.ai/api/v1/videos", {
  method: "POST",
  headers,
  body: JSON.stringify({ model: "veo", prompt: "Waves rolling onto a beach at sunrise", duration: 8, aspect_ratio: "16:9" }),
})).json();

let status;
do {
  await new Promise((r) => setTimeout(r, 8000));
  status = await (await fetch("https://nymbot.ai/api/v1/videos/" + job.id, { headers })).json();
} while (status.status !== "completed" && status.status !== "failed");

console.log(status.status === "completed" ? status.data.url : status.error);

文字轉語音

朗讀文本並回傳音訊檔案本身，而非連結。這是 OpenAI 的語音端點， 所以 audio.speech.create 在 OpenAI SDKs 中運作。

POST https://nymbot.ai/api/v1/audio/speech — 需要 API 金鑰，或者 每次請求一次 Lightning 付款.

標準語音每次請求固定消耗 3 個標準積分 (30 sats)，與 App 中相同。Aura 2 是 Pro 版本，按您發送的字元計費 Content-Type; 成本在於 X-Nymbot-Cost-Sats 頁首。如果 語音模型失敗，則不收取任何費用。

回應

HTTP/1.1 200 OK
Content-Type: audio/mpeg
X-Nymbot-Cost-Sats: 4.2
X-Nymbot-Balance-Sats: 41055.6

(audio bytes)

cURL

curl https://nymbot.ai/api/v1/audio/speech \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "aura-2", "voice": "luna", "input": "Your invoice has been paid."}' \
  --output speech.mp3

Python

import os
from openai import OpenAI

client = OpenAI(base_url="https://nymbot.ai/api/v1", api_key=os.environ["NYMBOT_API_KEY"])

audio = client.audio.speech.create(
    model="aura-2",
    voice="luna",
    input="Your invoice has been paid.",
)
audio.write_to_file("speech.mp3")

JavaScript

import { writeFile } from "node:fs/promises";
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nymbot.ai/api/v1", apiKey: process.env.NYMBOT_API_KEY });

const audio = await client.audio.speech.create({
  model: "aura-2",
  voice: "luna",
  input: "Your invoice has been paid.",
});
await writeFile("speech.mp3", Buffer.from(await audio.arrayBuffer()));

音訊模型與聲音

兩份用於挑選語音模型與聲音，或逐字稿模型的公開清單。共有 41 位 Aura 2 英語說話者與四種 MeloTTS 語言。

GET https://nymbot.ai/api/v1/audio/models — 不需要金鑰。

GET https://nymbot.ai/api/v1/audio/voices?language=en — 不需要金鑰。

回應 (聲音)

{
  "object": "list",
  "data": [
    { "id": "luna", "name": "Luna", "provider": "deepgram", "model_id": "aura-2", "models": ["aura-2"], "language": "en", "description": "Aura 2 English voice", "gender": "female", "preview_url": null },
    { "id": "en", "name": "MeloTTS English", "provider": "myshell", "model_id": "@cf/myshell-ai/melotts", "models": ["@cf/myshell-ai/melotts", "melotts"], "language": "en", "description": "English (MeloTTS)", "gender": null, "preview_url": null }
  ]
}

模型列表回答 {"object": "list", "data": {"tts": […], "stt": […]}}. 每個語音模型都提供其平衡、價格， max_input_chars, response_formats, languages 和 default_voice; 轉錄模型給出了它的別名， max_file_bytes, max_seconds, 格式與每分鐘價格。

cURL

curl https://nymbot.ai/api/v1/audio/models
curl "https://nymbot.ai/api/v1/audio/voices?language=en"

Python

import requests

print(requests.get("https://nymbot.ai/api/v1/audio/models").json())
for voice in requests.get("https://nymbot.ai/api/v1/audio/voices", params={"language": "en"}).json()["data"]:
    print(voice["id"], voice["model_id"])

JavaScript

console.log(await (await fetch("https://nymbot.ai/api/v1/audio/models")).json());
const voices = await (await fetch("https://nymbot.ai/api/v1/audio/voices?language=en")).json();
for (const v of voices.data) console.log(v.id, v.model_id);

語音轉文字

使用 Whisper 將錄音轉換為文字。這是 OpenAI 的逐字稿端點，所以 audio.transcriptions.create 有效。

POST https://nymbot.ai/api/v1/audio/transcriptions — 需要 API 金鑰，或者 每次請求一次 Lightning 付款. 身體是 multipart/form-data.

對於 WAV、WebM、MP4 和 Ogg 檔案，長度會在任何程序執行前從檔案中讀取，因此超過 30 分鐘的錄音會被直接拒絕（具有 3 秒的緩衝時間）。WAV 檔案的長度取決於其取樣率、聲道數和取樣大小。其他格式（例如 MP3）的長度無法預先讀取，因此它們受到檔案大小的限制：在 Nymbot 假設的最低位元率 8 kbps 下，30 分鐘為 1.8 MB，而此格式中更大的檔案將會被拒絕，其原因為 413 audio_too_long 在任何程序執行前。請將較長的錄音以 WAV、WebM、MP4 或 Ogg 格式傳送。如果 Whisper 仍回報超過 30 分鐘，該請求將會因...而被拒絕。 413 audio_too_long，且由於 Whisper 已運行，因此將收取 30 分鐘的費用。

您支付的費用取決於音訊長度，並以秒為單位無條件進位：取下列三者中的最大值：從檔案讀取的長度、Whisper 回報的長度，以及檔案大小所允許的最小長度；費用按 Whisper 的每分鐘價格加上通常的費用與利潤計算，且每次請求至少為 0.05 credit。若標準餘額足以支付預留款項，則從標準餘額中扣除，否則從 Pro 餘額中扣除；a 402 說明了每種 餘額的需求。在 App 中，轉錄語音訊息可能是免費的；但在 API 上， 則總是會收費。如果 Whisper 失敗，則不會收取任何費用。

回應

{
  "text": "Your invoice has been paid.",
  "usage": { "type": "duration", "seconds": 3 },
  "nymbot": { "balance": "standard", "charged_credits": 0.05, "charged_sats": 0.5, "balance_credits": 120.35, "balance_sats": 1203.5 }
}

text 回傳純文字， srt 和 vtt 回傳字幕，以及 verbose_json 新增語言、時長和定時分段。對於那三個 不是 JSON 的項目，成本會在標頭中。

cURL

curl https://nymbot.ai/api/v1/audio/transcriptions \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -F [email protected] \
  -F model=whisper \
  -F response_format=json

Python

import os
from openai import OpenAI

client = OpenAI(base_url="https://nymbot.ai/api/v1", api_key=os.environ["NYMBOT_API_KEY"])

with open("memo.m4a", "rb") as f:
    transcript = client.audio.transcriptions.create(model="whisper", file=f)
print(transcript.text)

JavaScript

import fs from "node:fs";
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nymbot.ai/api/v1", apiKey: process.env.NYMBOT_API_KEY });

const transcript = await client.audio.transcriptions.create({
  model: "whisper",
  file: fs.createReadStream("memo.m4a"),
});
console.log(transcript.text);

將演講翻譯成英文

POST https://nymbot.ai/api/v1/audio/translations — 需要 API 金鑰，或者 每次請求一次 Lightning 付款. 身體是 multipart/form-data.

與逐字稿相同，除了以下欄位外，其餘欄位皆相同 language, 限制與 價格，但無論說的是哪種語言，文字都會以英文返回。OpenAI SDK 使用 它調用 audio.translations.create.

cURL

curl https://nymbot.ai/api/v1/audio/translations \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -F [email protected] \
  -F model=whisper

Python

import os
from openai import OpenAI

client = OpenAI(base_url="https://nymbot.ai/api/v1", api_key=os.environ["NYMBOT_API_KEY"])

with open("nota.m4a", "rb") as f:
    translation = client.audio.translations.create(model="whisper", file=f)
print(translation.text)

JavaScript

import fs from "node:fs";
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nymbot.ai/api/v1", apiKey: process.env.NYMBOT_API_KEY });

const translation = await client.audio.translations.create({
  model: "whisper",
  file: fs.createReadStream("nota.m4a"),
});
console.log(translation.text);

嵌入

將文本轉換為向量，用於搜尋、分群與去重。模型在 Cloudflare 上執行，並消耗標準餘額。

POST https://nymbot.ai/api/v1/embeddings — 需要 API 金鑰，或者 每次請求一次 Lightning 付款.

模型列表是關於可用模型及其成本的唯一事實來源；當目錄中包含其價格時，Google 的 EmbeddingGemma（可根據需求提供較短的向量）也會顯示在那裡。 嵌入（Embeddings）按輸入 token 計費，且每次請求適用 0.05 積分的最低消費，而非每次輸入， 因此將大量文本批次處理成一個請求，會比逐一發送便宜得多。

回應

{
  "object": "list",
  "data": [
    { "object": "embedding", "index": 0, "embedding": [0.0213, -0.0487, 0.0112] }
  ],
  "model": "@cf/baai/bge-m3",
  "usage": { "prompt_tokens": 9, "total_tokens": 9 },
  "nymbot": { "balance": "standard", "charged_credits": 0.05, "charged_sats": 0.5, "balance_credits": 1204.35, "balance_sats": 12043.5 }
}

cURL

curl https://nymbot.ai/api/v1/embeddings \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "@cf/baai/bge-m3", "input": ["Lightning invoices expire.", "Invoices on Lightning have a time limit."]}'

Python

import os
from openai import OpenAI

client = OpenAI(base_url="https://nymbot.ai/api/v1", api_key=os.environ["NYMBOT_API_KEY"])

result = client.embeddings.create(
    model="@cf/baai/bge-m3",
    input=["Lightning invoices expire.", "Invoices on Lightning have a time limit."],
)
print(len(result.data), len(result.data[0].embedding))

JavaScript

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nymbot.ai/api/v1", apiKey: process.env.NYMBOT_API_KEY });

const result = await client.embeddings.create({
  model: "@cf/baai/bge-m3",
  input: ["Lightning invoices expire.", "Invoices on Lightning have a time limit."],
});
console.log(result.data.length, result.data[0].embedding.length);