知識ベース / 開発者

画像、オーディオ、embeddings

アプリからのジェネレーターと検索のビルドブロック:写真、ビデオ、スピーチ、トランスクリプション、および埋め込み、それぞれあなたのバランスから使用ごとに請求されます。

このページは便宜上機械翻訳されています。英語原文が該当するバージョンとなります。

画像生成

プロンプトから1〜4枚の画像を作成し、完成したときに返します。 ?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, cost a flat 5 standard credits (50 sats) a picture. Every other generator spends Pro credits at its own price, with the usual fee and margin, as in ♪ app. n 写真コスト n ジェネレーターが取らないフィールドは、拒否するのではなく落とされます; 標準ジェネレーターは、プロンプトのみを使用します。

resolution 使用されていない:各発電機は独自のサイズを作ります。 url, each image is uploaded to a public Blossom host and you get its link (some generators only hand back a link of their own, which is passed on). リンクを持っている誰でも開くことができ、再びダウンロードすることはできません。 火が見えるもの♪With b64_json 画像は返信時に返信され、一度もアップロードされません。 data: URL入力 image_url 同様の方法で検証されているのは、A EDIT 最初にBlossomにアップロードし、発電機がそれを取得できるようにして、リクエストが請求されない場合に再度削除されます。

If some of the 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 SDKの images.edit プロジェクターのみで動作します。 edit モデルリストで受け入れます。

POST https://nymbot.ai/api/v1/images/edits API キーが必要、または リクエストによる Lightning 支払い身体は、 multipart/form-data32MBまで。

アップロードした画像は、よく形成された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について尋ねます。

POST https://nymbot.ai/api/v1/videos API キーが必要、または リクエストによる Lightning 支払い戻る 202.

価格は、発電機から解像度と長さから送信するときに固定されますので、プロのバランスをプロが仕事を受け入れるとすぐに請求されます。 cost, estimated_cost そして nymbot. プロバイダーが仕事を拒否した場合、何も請求されません。 再生が後で失敗した場合、または完成したクリップが保存されず、プロバイダーが請求しなかった場合、料金は自動的に一度返還されます。 1 時間後にまだ続いている再生は放棄され、プロバイダーがそれを受け入れたときに再生を請求するため、その料金は保持されます。 返金はクレジットを返しますが、キーの支出数を下げません。

答え(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 スタート As in_progressあるいは completed すでにビデオでは、 data 直ちに発電機が返してくれた。

ビデオでチェック

GET https://nymbot.ai/api/v1/videos/{id} 提出したNIMに属するキーを必要とします。そのカップに達したキーはまだチェックできます。

答えは 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失敗した仕事は運ぶ 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);

テキスト スピーチ

テキストを大声で読んで、リンクではなくオーディオファイル自体を返します。 audio.speech.create 「OpenAI SDK」の機能

POST https://nymbot.ai/api/v1/audio/speech API キーが必要、または リクエストによる Lightning 支払い.

Aura 2 is Pro, priced by the characters you send. The response body is the audio, with a matching Aura 2 is Pro, priced by the characters you send. Aura 2 is Pro, priced by the characters you send. Aura 2 is Pro, priced by the characters you send. Aura 2 is Pro, priced by the characters you send. Aura 2 is Pro, priced by the characters you send. Aura 2 is Pro, priced by the characters you send. Aura 2 is Pro, priced by the characters you send. Content-Typeコストは, in the X-Nymbot-Cost-Sats header. If the speech model fails, nothing is charged. スピーチモデルが失敗した場合、何も請求されません。

応答

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()));

オーディオモデルと声

スピーチモデルと音声、またはトランスクリプションモデルを選択するための2つの公開リスト. There are 41 Aura 2 English speakers and four MeloTTS languages.

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, 形式と1分あたりの価格。

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 を使用してレコーディングをテキストに変換します. This is OpenAI's transcription endpoint, so 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は、8kbps、30分は 1.8 MBであり、そのようなフォーマットの大きなファイルは拒否されます。 413 audio_too_long WAV、WebM、MP4、Oggなどの長いレコーディングを送信します. Whisper が 30 分を超えるレポートを送信した場合、その要求は拒否されます。 413 audio_too_long, and since Whisper did run, 30 minutes are charged. 30分が充電されます。

You pay for the length of the audio, rounded up to the second: the longest of the length read from the file, the length Whisper reports, and the least the file's size allows, at Whisper's per-minute price with the usual fee and margin, and at least 0.05 credit a request. It is paid from the standard balance when that can cover the hold, and from Pro otherwise. あなたは、オーディオの長さのために支払うことができます。 402 それぞれのバランスを必要とするものを提供します。アプリでは、音声メッセージの書き換えは無料であり、APIでは常に充電されます。

応答

{
  "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でない3つのセグメントの場合、コストはヘッダーに含まれます。

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, 制限と価格ですが、テキストは言語が何であれ英語で返ってきます。 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);

Embeddings

テキストをベクトルに変換して検索、クラスタリング、およびデドプリクションを実行します。 モデルはCloudflareで実行され、標準バランスを消費します。

POST https://nymbot.ai/api/v1/embeddings API キーが必要、または リクエストによる Lightning 支払い.

モデルリストは、入力トークンあたりの真実の源であり、それらのコストは何ですか? リクエストに応じてより短いベクトルを持つGoogleのEmbeddingGemmaは、カタログに価格がある場合にもそこに表示されます。

応答

{
  "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);