Isi ihe ọmụma / Ndị na-arụ ọrụ

Ngwa, Audio na Embeddings

The generators site na ngwa, na ndị na-ewu ewu maka search: photos, video, speech, transcription na embeddings, onye ọ bụla na-ere kwa iji site na gị ego.

A sụgharịrị ibe a n'igwe maka ịdị mma. The English mbụ bụ ụdị nke na-emetụta.

Ịmepụta Images

Ọ na-emepụta otu ma ọ bụ atọ foto site na mgbakwunye na-ere ha mgbe ha na-eme. Ọ bụ otu set nke generators dị ka ?image na App.

POST https://nymbot.ai/api/v1/images/generations — dị mkpa API key, ma ọ bụ Lightning ịkwụ ụgwọ on request.

IDs na-abịa site na GET /api/v1/models?type=imageThe Standard Generator, @cf/black-forest-labs/flux-1-schnell, na-eri a flat 5 standard credits (50 sats) a picture. Onye ọ bụla ọzọ generator na-eji Pro credits na ya onwe ya price, na obi ụgwọ na margins, dị ka na ngwa. n Ụdị foto n A na ebe a na generator na-adịghị na-enweta na-atụ anya karịa na-atụ anya; Standard generator na-eji na nkwado naanị.

resolution na-adịghị na-eji: ọ bụla generator na-eme ya onwe ya size. Na url, onye ọ bụla image na-akwụsị na a public Blossom host na ị ga-enweta ya njikọ (ọtụtụ generators na-enye naanị a njikọ nke ha onwe ha, nke na-aga n'ihu). Onye ọ bụla nwere njikọ nwere ike ịmepụta ya na ọ nwere ike ịmepụta ya ọzọ; ịhụ Otu n'ihi na API nwere ike ịhụna b64_json The image na-aga n'ime ntụziaka na ọ na-enweghị ike ime. A photo sent as a data: URL na image_url Ọ na-atụ anya na otu ekwentị na-agba ọsọ na Blossom mbụ ka generator nwere ike ime ya; ọ na-agba ọsọ ọsọ ma ọ bụrụ na chọrọ na-agba ọsọ.

Ọ bụrụ na ụfọdụ nke n foto na-adịghị, ị ga-esi ndị na-arụ ọrụ, na-akwụ ụgwọ naanị maka ndị (plus ihe ọ bụla na-akwụ ụgwọ n'agbanyeghị na-adịghị), na nymbot.failed na-ekwu banyere ọtụtụ ndị na-adịghị. Ọ bụrụ na ndị niile na-adịghị mma, 502.

nzọụkwụ

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

Ịmepụta Images

Ọ na-eme ka a image ị na-akpọ, na-esonụ a ọkọlọtọ. Nke a bụ OpenAI editing endpoint, ya mere OpenAI SDKs ' images.edit na-arụ ọrụ dị ka ọ bụ. Only Pro generators with edit na usoro nchịkọta ekwesị ya.

POST https://nymbot.ai/api/v1/images/edits — dị mkpa API key, ma ọ bụ Lightning ịkwụ ụgwọ on requestThe body bụ multipart/form-dataỌ dị ka 32 MB.

The image ị na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ PNG, JPEG, WebP ma ọ bụ GIF, na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ.

nzọụkwụ

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

Ngwaahịa

A video na-eme nkeji, otú ọ na-agba ọsọ na mpaghara. Ị na-eweta ya, na-enweta a id ugbu a, na-achọ banyere id ruo mgbe ọ na-eme. Onye ọ bụla video generator na-eji Pro ego.

POST https://nymbot.ai/api/v1/videos — dị mkpa API key, ma ọ bụ Lightning ịkwụ ụgwọ on requestỊkwụ Ụgwọ 202.

The price bụ fixed mgbe ị na-esonụ, site na generator, ikpeazụ na ogologo, otú ọ na-akwụ ụgwọ site na gị Pro ego mgbe ndị ọrụ na-akwụ ụgwọ ọrụ, na-egosi dị ka cost, estimated_cost na nymbot. Ọ bụrụ na ndị ọrụ na-agba ọsọ ọrụ, ọ dịghị ihe ọ bụla na-akwụ ụgwọ. Ọ bụrụ na ndị ọrụ na-agba ọsọ na-agba ọsọ, ma ọ bụ ndị ọrụ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ, na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ. A na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ. A na-agba ọsọ na-agba ọsọ na-agba ọsọ

Nkọwa (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 Mmalite dị ka in_progressỌ bụ completed Na video dị na data mgbe generator na-ere ya ugbu a.

Nyocha na video

GET https://nymbot.ai/api/v1/videos/{id} - nwere mkpa a kpọmkwem nke dị na nym na-ere ya. A kpọmkwem na-enweta ya cap nwere ike na-echekwa.

Ọ na-ekwu 202 mgbe video na-eme na 200 mgbe ọ na-agba ọsọ ma ọ bụ na-agba ọsọ. Kpọmkwem ọ bụla 5 ka 10 nkeji. Kpọmkwem ọ bụla na-agba ọsọ na-agba ọsọ ọsọ; ọ na-agba ọsọ maka video. A ọrụ na-agba ọsọ 24 awa mgbe ọ na-ere ya. GET /api/v1/videos lists the key's last 50 ọrụ dị ka {"object": "list", "data": […]}.

Nkọwa (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 Ọ bụ in_progress, completed ọ failedA na-agba ọsọ ọrụ error ({"code": "generation_failed", "message": …}); ma ọ bụrụ na ọ na-ere ya, cost Ọ bụ 0 na nymbot Ọnụ refunded_credits na refunded_satsThe zuru video bụ na a public Blossom n'ụlọ ahịa, dị ka foto na-emepụta.

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

Ngwa na-ekwu

Ọ na-ekwu na-ekwu na-ekwu faịlụ audio faịlụ ahụ, ọ bụghị njikọ. Ọ bụ OpenAI na-esonụ ntụ ntụ, otú audio.speech.create na OpenAI SDKs na-arụ ọrụ.

POST https://nymbot.ai/api/v1/audio/speech — dị mkpa API key, ma ọ bụ Lightning ịkwụ ụgwọ on request.

The ọkọlọtọ na-akwụ ụgwọ a flat 3 ọkọlọtọ akwụ ụgwọ (30 sats) a chọrọ, dị ka na ngwa. Aura 2 bụ Pro, na-akwụ ụgwọ site na akara ị na-esonụ. Ndị na-akwụ ụgwọ ahụ bụ audio, na a kpọmkwem Content-Type; Ọnụ ọgụgụ bụ na X-Nymbot-Cost-Sats header. Ọ bụrụ na ụdị asụsụ na-adịghị mma, ihe ọ bụla na-akwụ ụgwọ.

nzọụkwụ

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

Audio ụdị na akụkọ

Ọtụtụ ndị na-atụ anya na ndị na-atụ anya na ndị na-atụ anya na ndị na-atụ anya na ndị na-atụ anya na ndị na-atụ anya na ndị na-atụ anya.

GET https://nymbot.ai/api/v1/audio/models Ọ dịghị mkpa.

GET https://nymbot.ai/api/v1/audio/voices?language=en Ọ dịghị mkpa.

Nyocha (nyocha)

{
  "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 }
  ]
}

Ụdị Ụdị Ụdị Ụdị {"object": "list", "data": {"tts": […], "stt": […]}}. Onye ọ bụla nkwurịta okwu model na-enye ya ego, price, max_input_chars, response_formats, languages na default_voice; ụdị transcription na-enye ya aliases, max_file_bytes, max_seconds, usoro na price per minute.

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

Ngwa na ederede

Ọ na-agbanwe nchekwa na ederede na Whisper. Nke a bụ OpenAI transcription endpoint, otú audio.transcriptions.create Ọnọdụ

POST https://nymbot.ai/api/v1/audio/transcriptions — dị mkpa API key, ma ọ bụ Lightning ịkwụ ụgwọ on requestThe body bụ multipart/form-data.

N'ihi na WAV, WebM, MP4 na Ogg faịlụ, ogologo a na-akpọ site na faịlụ tupu ihe ọ bụla na-agba ọsọ, n'ihi ya, a akụkọ ihe mere eme ihe karịrị 30 nkeji na-agba ọsọ na-agba ọsọ (na 3 nkeji). A WAV faịlụ ogologo na-abịa site na ya sample ọsọ, channel na sample size. Ogologo nke ndị ọzọ na-agba ọsọ, dị ka MP3, nwere ike na-agba ọsọ na-agba ọsọ, otú ha na-agba ọsọ site na size: na ala bitrate Nymbot na-ekwu, 8 kbps, 30 nkeji bụ 1.8 MB, na a nnukwu faịlụ na ụdị a na-agba ọs 413 audio_too_long tupu ihe ọ bụla na-agba ọsọ. Tinye ogologo nchọgharị dị ka WAV, WebM, MP4 ma ọ bụ Ogg. Ọ bụrụ na Whisper mgbe ahụ na-egosi ihe karịrị 30 nkeji ọ bụla, na-atụ aro na 413 audio_too_long, na n'ihi na Whisper na-agba ọsọ, 30 nkeji na-akwụ ụgwọ.

Ị na-akwụ ụgwọ maka ogologo nke audio, gburugburu ka nke abụọ: ndị kasị ogologo nke ogologo na-akwụ ụgwọ site na faịlụ, ogologo Whisper akụkọ, na ihe kasị obere nke faịlụ ogologo na-enye, na Whisper per-minute price na obi ụgwọ na margin, na ọ dịkarịa ala 0.05 credit a chọrọ. Ọ na-akwụ ụgwọ site na ọkọlọtọ ego mgbe nke nwere ike na-akwụ ụgwọ, na site na Pro ọ dịghị; 402 Ọ na-enye ihe onye ọ bụla ego ga-achọ. Na ngwa, transcripting a asụsụ ozi nwere ike ịbụ free; na API ọ bụ mgbe niile na-akwụ ụgwọ. Ọ bụrụ na Whisper na-adịghị, ọ dịghị ihe na-akwụ ụgwọ.

nzọụkwụ

{
  "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 Tụkwasịnụ text, srt na vtt Back subtitles, na verbose_json na-agụnye asụsụ, oge na oge segments. N'ihi na ndị atọ na-adịghị JSON, ego bụ na 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);

Tụkwasịnụ Ngwa na English

POST https://nymbot.ai/api/v1/audio/translations — dị mkpa API key, ma ọ bụ Lightning ịkwụ ụgwọ on requestThe body bụ multipart/form-data.

Ọzọ dị ka transcription, na otu ụlọ dịka language, obere, na price, ma ederede na-esonụ na English n'agbanyeghị na asụsụ a na-akpọ. The OpenAI SDKs na-akpọ ya na 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);

Ngwuputa

Ọ na-agbanwe ederede na vectors maka search, clustering na deduplication. Ụdị na-agba ọsọ na Cloudflare na-agba ọsọ ego.

POST https://nymbot.ai/api/v1/embeddings — dị mkpa API key, ma ọ bụ Lightning ịkwụ ụgwọ on request.

The nkọwa nke nlereanya bụ ihe n'ihi na ha na-enweta na ihe ha na-eri; Google's EmbeddingGemma, na obere vectors on request, na-egosi n'ebe ahụ ma ọ bụrụ na catalogue nwere price maka ya. Embeddings na-egosi kwa input token, na 0.05-kredite minimum na-atụle maka onye ọ bụla chọrọ, ma ọ bụghị maka onye ọ bụla input, ya mere batching ọtụtụ ederede n'ime otu chọrọ bụ nnọọ obere karịa na-enye ha otu n'otu oge.

nzọụkwụ

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