וויסן באַזע / אַוועקלייגן

ציפער, אודיו און אַביידינגס

די גאַנדראַז פון די אַפּ, און די בויגן בלאָקז פֿאַר פאָרשונג: בילדער, וידאו, רייַך, טרנסקריפּיישאַן און אַביידינגס, יעדער באַצאָלן פּער ניצן פון דיין סאַך.

דער בלאַט איז מאַשין איבערגעזעצט פֿאַר קאַנוויניאַנס. דער ענגלישער אָריגינעל איז די ווערסיע וואָס אַפּלייז.

לייענען Images

און מיך [חלילה, נישט מיך - איך מיין די רעכטע] אויך נישט! ?image אין אַפּ.

POST https://nymbot.ai/api/v1/images/generations איר זקוקן אַ API Key, אָדער באַקומען באַזוכן Lightning Pay by request.

א איידס פון 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 אַפּ. n די תמונה n אַ פעלד אַ גאַנדרער אין טעלעפאָנירן, אַ פעלד אַ גאַנדרער אין טעלעפאָנירן, אַ פעלד אַ פעלד אין טעלעפאָנירן; A field a generator does not take is dropped rather than rejected; the standard generator uses the prompt only.

resolution אין די גאַנץ, כל גאַנץ איז א גאַנץ. url, יעדער בילד איז העלפן צו אַ פאַביע בלאָסמאָ טעלעפאָנירן און איר באַקומען די לינק (כמעט גאַנערז only hand back a link of their own, which is passed on).Everyone with the link can open it and it can't be taken down again; זען איך האב איך בין א באשאון b64_json די בילד איז געפירט אין די בילד אין די בילד אין די בילד אין די בילד data: און URL image_url ער איז געווען באותו א צורה כמו לייענען און העלפן צו Blossom ערשטער צו די גאַנדרער קענען אַוועקלייגן עס; it is deleted again if the request fails unbilled.

און איך בין 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);

לייענען Images

עס איז געווען א טעלעפאָנירן צו דערגרייכן, און עס איז א טעלעפאָנירן צו באַקומען. images.edit און איך בין נישט, און איך בין נישט. edit אויף דעם רשימה, accept it.

POST https://nymbot.ai/api/v1/images/edits איר זקוקן אַ API Key, אָדער באַקומען באַזוכן Lightning Pay by requestאון גופו איז multipart/form-dataאין די 32 MB.

די בילד איר העלפן איז צופריד צו זיין אַ וווי-פורמאַטאַד PNG, JPEG, WebP אָדער GIF, געשלעכט אויף ווי זייַן אמת טיפּ, און געשלעכט אויף אַ פאַביע בלוסמאָ הוסט, because the generators pick up their input by link. Treat it as public. If the editing fails and nothing is charged, the hosted copy is deleted again. The response has the same shape as for generation. Pricing is the generator's price, which for some generators includes a charge for the input image.

תגובה

{
  "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 until it is done. Every video generator spends the Pro balance.

POST https://nymbot.ai/api/v1/videos איר זקוקן אַ API Key, אָדער באַקומען באַזוכן Lightning Pay by requestאון חזרה 202.

די פּרייַז איז פאַקטיש ווען איר פאָרויסזאָגן, פון די גנרטער, ראָוסאָלייישאַן און לאַג, אַזוי עס איז געשלעכט פון דיין Pro סאַלאַגן ברגע די פאָרויסזאָגן אַקענדינג די אַרבעט, און געפירט ווי cost, estimated_cost און nymbotIf the provider refuses the job, nothing is charged. If the rendering later fails, or the finished clip cannot be stored and the provider did not bill for it, the charge is refunded once, automatically. A rendering that is still going after an hour is given up, and keeps its charge, because the provider bills a render once it accepts it. A refund returns the credits but does not lower the key's spending count.

און ענטפער (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} — זקוקן אַ מפתח שייך צו די נימ אַז צוגעשטעלט עס. A key that has reached its cap can still check.

ענה 202 די וידאו איז געגרינדעט און 200 און דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער. 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 Host, אַזאַ ווי ינווערינג בילדים.

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

טעלעפאָנירן צו דיך

לייענען טקסט רעכט און רייַבן די אַודיו קיילע, אין אַ לינק.It is OpenAI's speech endpoint. audio.speech.create דעריבער איז די OpenAI SDKs.

POST https://nymbot.ai/api/v1/audio/speech איר זקוקן אַ API Key, אָדער באַקומען באַזוכן Lightning Pay by request.

די סטאַנדאַרד טאָוס קויסט אַ פאַל 3 סטאַנדאַרד קרעדיט (30 סאַט) אַ פּרייַז, ווי אין די אַפּ. Aura 2 is Pro, priced by the characters you send. The response body is the audio, with a matching Content-Typeדער העלא איז אין X-Nymbot-Cost-Sats דעריבער, 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, פורמט און פּרייַז פּער מינוט.

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

צו טקסט

עס איז געווען א טעלעפאָנירן טעלעפאָנירן.This is OpenAI's transcription endpoint. audio.transcriptions.create און מעשה.

POST https://nymbot.ai/api/v1/audio/transcriptions איר זקוקן אַ API Key, אָדער באַקומען באַזוכן Lightning Pay by requestאון גופו איז multipart/form-data.

פֿאַר WAV, WebM, MP4 און Ogg files the length is read from the file before anything runs, so a recording over 30 minutes is refused up front (with 3 seconds' grace). A WAV file's length comes from its sample rate, channels and sample size. The length of other formats, such as MP3, cannot be read up front, so they are limited by size: at the lowest bitrate Nymbot assumes, 8 kbps, 30 minutes is 1.8 MB, and a larger file in such format is refused with 413 audio_too_long אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקל 413 audio_too_longאון ווי זיי זענען געפירט, 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 און דעריבער, איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך

תגובה

{
  "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 געגרינדעט מיט Subtitles, און verbose_json דעריבער, איר קענען באַקומען די גאַנץ פון JSON.For the three that are not JSON, the cost is in the headers.

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 Key, אָדער באַקומען באַזוכן Lightning Pay by requestאון גופו איז multipart/form-data.

און איך בין נישט, מיט די אותן שדות. languageדי טקסט איז באקאנט אין אנגלי, no matter what language was spoken.The OpenAI SDKs call it with 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);

אַוועקלייגן

טעלעפאָנירן טעלעפאָנירן צו ויקטאָרס פֿאַר פאָרשונג, גאַנסטרייטינג און deduplication. The models run on Cloudflare and spend the standard balance.

POST https://nymbot.ai/api/v1/embeddings איר זקוקן אַ API Key, אָדער באַקומען באַזוכן Lightning Pay by request.

די מאָדעל רשימה איז די קוואָר פון אמת פֿאַר וואָס זענען בנימצא און וואָס זיי קעלן; Google's 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);