Base di cunniscenza / Sviluppatori

Immagini, audio è embeddings

I generatori di l'app, è i blocchi di costruzione per a ricerca: immagini, video, parlu, trascrizzione è embeddings, ciasunù fatturatu per ogni utilizazione da u vostru saldu.

Questa pagina hè tradutta in macchina per comodità. L'uriginale in inglese hè a versione chì si applica.

Generazione di imaghini

Fa da una à quattru imaghjini da un prompt è le restituisce quandu sò fatte. Hè u stessu set di generatori chì ?image in l'app.

POST https://nymbot.ai/api/v1/images/generations — hà bisognu di una chìave API, o un pagamentu Lightning per dumanda.

I ID chjamanu da GET /api/v1/models?type=imageU generatore standard, @cf/black-forest-labs/flux-1-schnell, costa 5 crediti standard fissi (50 sats) per imaghjina. Ogni altru generatore spende crediti Pro à u so prìzu, cù a tariffa è u margine usuali, cum'è in l'app. n prezzu di e foto n vez di tantu. Un campu chì u generatore ùn accetta ùn hè scartatu invece di esse rifiutatu;\n u generatore standard usa solu u prompt.

resolution si ùn u usa micca: ogni generatore fà u so propiu dimensione. Cù url, ogni imaghjina hè caricata nantu à un ospite Blossom pulbicu è vi tù u so ligame (alcun generatori solu restituiscinu un ligame propiu, chì hè passatu). Chiconunque hà u ligame pò apre it è ùn pò micca esse rimossa di novu; vede chì pò u API vede. Cum b64_json a ritrattu torna in a risposta è ùn hè mai caricatu. Un ritrattu mandatu cum'è un data: URL in image_url si verifica assai cum'è un modifica è caricatu in Blossom prima perchè u generatore possa pigliàlu; ellu hè eliminatu di novu si a dumanda fallisce senza fatturazione.

Sì una parte di u n l'imaghjini falliscenu, riceviti quelle chì anu funzionatu, vi fatturanu solu per quelle (più quelle chì u fornitore hà fatturatu malgradu u fallimentu), è nymbot.failed dice quantu suntu mancanti. S'ellu tutti falliscenu, a dumanda torna 502.

Risposta

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

Edizione di imaghjini

Cambia una imaghjina chì avete caricata, seguendu un prompt. Hè u endpoint di editazione di OpenAI, quindi i SDK di OpenAI images.edit funziona com'è. Sò solu i generatori Pro cù edit in a lista di mudelli accettatelu.

POST https://nymbot.ai/api/v1/images/edits — hà bisognu di una chìave API, o un pagamentu Lightning per dumanda. U corpu hè multipart/form-data, finu à 32 MB.

A foto chì vulgate hè verificata per esse un PNG, JPEG, WebP o GIF ben formulatu, mandatu cum'è u so tipu reale, è mettutu nantu à un ospite Blossom publicu, perchè i generatori pighenu u so input per ligame. Trattatelu cum'è publicu. S'ellu a modifica fallisce è ùn hè chjamatu micca nente, a copia ospitata hè eliminata ancu ela. A risposta hè di a stessa forma di quella per a generazione. U prezzu hè u prezzu di u generatore, chì per alcuni generatori include un fattu per a foto d'input.

Risposta

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

Vidéo

Un video pigghia minuti, cusì s'una in backgroundu. Vui u sottemettite, pigliate un id subitu, è dumandate di l'id finché ùn hè micca finitu. Ogni generatore di video spende u saldu Pro.

POST https://nymbot.ai/api/v1/videos — hà bisognu di una chìave API, o un pagamentu Lightning per dumanda. Ritorni 202.

U prezzu hè fissu quande mandate, da u generatore, a risoluzzione è a lunghezza, dunque hè debitatu da u vostre saldu Pro appena u furnitore accetta u travagliu, è mostratu cum'è cost, estimated_cost è nymbotSì u furnitore rifiuta lu travagliu, ùn si carica nantu à nenti. S'ellu u render fallisce dopu, o u clip finitu ùn pò micca esse ripostu è u furnitore ùn l'ha micca fatturatu, u debitu hè rimandatu una volta, in modu automaticu. Un render chì si sta ancu dopu un'ura hè abbandunatu, è mantene u so debitu, perchè u furnitore fattura un render una volta chì u accetta. Un rimbussu torna i crediti ma ùn abbassa micca u conte di a spesa di a chìave.

Risposta (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 cumencia cum'è in_progress, o completed cu u videu già in data quandu u generatore l'ha rimandatu subitu.

Verificà un video

GET https://nymbot.ai/api/v1/videos/{id} — serve una chiave ca appartene à u nym chì l'ha sottumettu. Una chiave chì hà raggiuntu u so capu pò tutt'avanti verificà.

Ùn risponde 202 mentre u videu hè in pruduzzione è 200 una volta chì hè finitu o hè fallitu. Chjamate ogni 5 à 10 sicunzioni. Ogni verificazione chjamate u fornitore una volta è risponde subitu; ùn aspetta mai u videu. Un travagliu hè conservatu per 24 ore dopu chì hè stati sottumessu. GET /api/v1/videos lista i azzeultimi 50 impieghi di a chìave cum'è {"object": "list", "data": […]}.

Risposta (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 o failed. A un travagliu fallitu porta error ({"code": "generation_failed", "message": …}); se era rimandatu, cost hè 0 è nymbot aghjunti refunded_credits è refunded_satsU videu finitu hè nantu à un host Blossom publicu, cum'è e immagini generate.

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

Testu à parlatura

Legge u test audio.speech.create in i SDK di OpenAI funziona.

POST https://nymbot.ai/api/v1/audio/speech — hà bisognu di una chìave API, o un pagamentu Lightning per dumanda.

A voce standard costa 3 crediti standard (30 sats) per ogni richiesta, cum'è in l'app. Aura 2 hè Pro, prizzatu in base à i caratteri chì mandate. U corpu di a risposta hè l'audio, cù un corrispondente Content-Type; u prezzu hè in u X-Nymbot-Cost-Sats intestazione. S'ellu u mudellu di fala fallisce, niente ùn hè chjargu.

Risposta

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

Modelli audio è voci

Dui liste pubbliche per sceglie un mudellu di discorsu è una voce, o un mudellu di trascrizione. Ci sò 41 parlanti Aura 2 in inglese è quattru lingue MeloTTS.

GET https://nymbot.ai/api/v1/audio/models — micca di chìave necessariu.

GET https://nymbot.ai/api/v1/audio/voices?language=en — micca di chìave necessariu.

Risposta (voci)

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

A lista di i mudelli risponde {"object": "list", "data": {"tts": […], "stt": […]}}Ogni mudellu di parlatura dà u so equilibru, u so prezzu, max_input_chars, response_formats, languages è default_voice; u mudellu di trascrizione dà i so aliassi, max_file_bytes, max_seconds, formatu è u prezzu per minutu.

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

Parlà à u testu

Trasforma una registrazione in testu cù Whisper. Questu hè l'endpoint di trascrizione di OpenAI, quindi audio.transcriptions.create funziuna.

POST https://nymbot.ai/api/v1/audio/transcriptions — hà bisognu di una chìave API, o un pagamentu Lightning per dumanda. U corpu hè multipart/form-data.

Per i file WAV, WebM, MP4 è Ogg, a durata hè letta da u file prima chì quarchì cosa sia executata, dunque una registrazione di più di 30 minuti hè rifiutata subitu (cum'è un margine di 3 sicondi). A durata di un file WAV vene da a so frequenza di campionamentu, i canali è a dimensione di u campionamentu. A durata di altri furmati, cum'è l'MP3, ùn pò micca esse letta subitu, dunque sò limitati da u dimensione: à u bitrate più bassu chì Nymbot assume, 8 kbps, 30 minuti sò 1.8 MB, è un file più grande in un tale furmatu hè rifiutatu cù 413 audio_too_long prima chì quìsiellu runne. Mandate registrazioni più lunghe in WAV, WebM, MP4 o Ogg. Si Whisper raporta comunque più di 30 minuti, a dumanda hè rifiutata cù 413 audio_too_long, è sicché Whisper hà funzionatu, 30 minuti sò fatturati.

Vivu paghjate per a lunghezza di l'audio, arrotondata à a seconda superiore: a più lunga di a lunghezza letta da u file, a lunghezza chì Whisper riferisce, è a più chjuca chì a dimensione di u file permette, à u prezzu di Whisper per minutu cum'è a tarifa è u margine usuali, è almenu 0.05 creditu per una richiesta. Si paga da u saldu standard quandu questu pò cunvèrsi u bloccu, è da Pro altri casu; a 402 indica ciò chì ogni bilanciu avaria bisognu. In l'app, a trascrizione di un messaghju vocale pò esse gratuita; nantu à l'API hè sempre fatturata. Si Whisper fallisce, ùn si fattura nente.

Risposta

{
  "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 trase testu semplice, srt è vtt restituite i sottituli, è verbose_json aghjunge a lingua, a durata è i segmenti temporale. Per i tre chì ùn sò micca JSON, u coste hè in i 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);

Traduciendu u parlu in inglese

POST https://nymbot.ai/api/v1/audio/translations — hà bisognu di una chìave API, o un pagamentu Lightning per dumanda. U corpu hè multipart/form-data.

U medemu cum'è a trascrizione, cù i medemi campi eccettu language, limiti è prezzu, ma u testu torna in inglese qualunque lingua sia stata parlatu. I SDK di OpenAI u chjamanu cù 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

Trasforma u testu in vettori per a ricerca, u raggruppamentu è a deduplicazione. I mudelli funzionanu nantu à Cloudflare è spennenu u saldu standard.

POST https://nymbot.ai/api/v1/embeddings — hà bisognu di una chìave API, o un pagamentu Lightning per dumanda.

A lista di i mudelli hè a sùrzi di a verità per ciò chì hè dispunsibule è u so prezzu; l'EmbeddingGemma di Google, cù vettori più curti su dumanda, hè ancu lì quandu u catalughe hà un prezzu per ellu. I "embeddings" sò misurati per ogni token d'input, è u minimu di 0,05 crediti si applica à ogni dumanda, micca à ogni input, dunque raggruppà molti testi in una sola dumanda hè assai più conveniente chì mandà elli unu per unu.

Risposta

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