Batayan ti pannakaammo / Developer iti

Addaan iti audio, embeddings.

Ti generator manipud iti app, ken ti building blocks para iti search: pictures, video, speech, transcription, ken embeddings, ti kasta a nairuar iti uso manipud iti balanse.

Daytoy a panid ket naipatarus babaen ti makina para iti kombeniente. Ti Ingles nga orihinal ti bersion nga agaplikar.

Ipabuya ti Imaging

4Sukimatenyo ti bagiyo tapno maammoanyo no pudno met laeng nga agbibiagkayo iti pammati. ?image Addaan iti app.

POST https://nymbot.ai/api/v1/images/generations Naaddaankami iti API key, wenno Adda pay pay laeng ti request..

Addaan iti GET /api/v1/models?type=imageTi generador ket ti standard. @cf/black-forest-labs/flux-1-schnell, cost a flat 5 standard credits (50 sats) a picture. Kasta a generator gasto a Pro credits iti maysa a presyo, iti normal a fee ken margin, kas iti app ti. n Nagbayag iti cost n Ti maysa a campo a generator ket saan a naaddaan ket naidumduma; ti standard generator ket nausar iti prompt.

resolution Daytoy ket addaan iti kaaduan kadagitoy no kalgaw. url, ti tunggal imbagana ti in-upload iti maysa a publikan a Blossom host ken saan a ti link (dakkel a generator laeng ti inaramid iti link ti dadduma, a naaddaan iti link). Apay, diyo am-ammo isuda ket nalatakda met?ti b64_json Pimmanaw ti imbagana iti imbagana ket saan a naaddaan iti imbagana. data: Addaan iti image_url Napintasen ti maysa a Addaan Naaddaankami iti Blossom para iti generator a maaddaan iti generator; ti maaddaankami iti Blossom a maaddaankami iti Blossom.

Isu ket pimmanaw ti n Isu ket pimmusay idiay asideg ti Edinburgh, ken kadua met idi ti pamiliana. nymbot.failed Adda pay laeng ti sumagmamano a mangparegta.Ket saan a mangparegta ti sumagmamano. 502.

Reaksiona

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

Ipabuya ti Imaging

Naaddaankami a mapagpagarup iti maysa a picture, iti ad-adu a prompt.This is OpenAI’s editing endpoint, ta ti OpenAI’s SDKs’ images.edit Ngem saan a naaddaan iti generator. edit Naaddaankami iti model list.

POST https://nymbot.ai/api/v1/images/edits Naaddaankami iti API key, wenno Adda pay pay laeng ti request.Ti Corpo ti multipart/form-dataAgtawenak idi iti 32 MB.

Ti imbagana nga i-upload ket checked a well-formed PNG, JPEG, WebP, wenno GIF, a nairuar iti bilang ti rikna, ket nairuar iti publiko a Blossom host, gapu ta dagiti generator nairuar ti input babaen ti link. I-treat it as public. No saan a ti edit ket saan a nairuar ket saan a nairuar ti kopia, ti hosted a kopia ket nairuar. Ti reaksion ket ti sama a form ken para iti generator.

Reaksiona

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

Video ti

Ti video ket addaan iti lima a minuto, tapno mairuarna iti background. I-submit it, makaparagsak a id iti immadayo, ken maaddaan iti id agingga a maaddaan.

POST https://nymbot.ai/api/v1/videos Naaddaankami iti API key, wenno Adda pay pay laeng ti request.Naaddaankami 202.

Ti presyo ket napigsa idi inlawlawagmo, manipud iti generator, resolution ken length, tapno agbayag iti salun-atmo a Pro saanto nga immay ti provider ti trabaho, ken ipakita kas cost, estimated_cost ken nymbotTi panagballigi ket addaan iti panagballigi ket addaan iti panagballigi ket addaan iti panagballigi ket addaan iti panagballigi ket addaan iti panagballigi.

Agtawenak iti 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 Simrek iti in_progressti completed Ti video ket addaan iti data Imtuodenyo iti bagiyo dagiti sumaganad a saludsod.

Kitaen dagiti ladawan.

GET https://nymbot.ai/api/v1/videos/{id} Napateg a nabileg a nabileg a nabileg a nabileg a nabileg a nabileg a nabileg a nabileg a nabileg.

Agbiruk iti 202 Ipabuya ti video sa pagsasaritaan dagitoy ken 200 Kas iti 5 a 10 a sekundada, nangipasa iti provider iti ad-adu pay iti ad-adu pay; ti video ket maipasngay iti ad-adu pay. GET /api/v1/videos Napateg dagiti 50 a trabaho ti key. {"object": "list", "data": […]}.

Agtawenak idi iti 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 ti in_progress, completed ti failedNagpatingga ti trabaho a mangparegta error ({"code": "generation_failed", "message": …}Ngem ibabaonnatayo ni Apo Dios a birukentayo isuna. cost 0 iti nymbot Agbiruk refunded_credits ken refunded_satsTi nagbaetan a video ket iti publiko a Blossom host, kas iti generated pictures.

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

Kitaen dagiti ladawan.

Inlawlawag ti teksto iti naudi ken imbagana ti audio file, ket awan ti link. It’s OpenAI’s speech endpoint audio.speech.create Naaddaankami iti OpenAI SDK.

POST https://nymbot.ai/api/v1/audio/speech Naaddaankami iti API key, wenno Adda pay pay laeng ti request..

Ti standarta a balakad ket addaan iti flat 3 standard credits (30 sats) a request, kas iti app. Aura 2 isu a Pro, ti nagpatingga kadagiti karakter ti inaramidda. Ti reaksion ti cuerpo ket ti audio, iti maysa a matching. Content-TypeAdda pay laeng ti cost iti X-Nymbot-Cost-Sats Ngem saan a nagpateg ti panagballigian, saan a ti panagballigian ket nagpateg.

Reaksiona

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

Addaan iti audio model ken voice.

Ipapaupana ketdi ti kaaduan kadagitoy no kalgaw ti kaaduan kadagitoy no kalgaw.

GET https://nymbot.ai/api/v1/audio/models Ket saan a nangaramid iti key.

GET https://nymbot.ai/api/v1/audio/voices?language=en Ket saan a nangaramid iti key.

Kitaen dagiti ladawan.

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

Modelo ti reaksionda. {"object": "list", "data": {"tts": […], "stt": […]}}Adda pay laeng ti balanse, ti price. max_input_chars, response_formats, languages ken default_voiceTi transcription model ket addaan kadagiti aliase. max_file_bytes, max_secondsNapateg a pay laeng iti minuto.

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

Kitaen dagiti ladawan.

Daytoy ket addaan iti transcription endpoint ti OpenAI. audio.transcriptions.create Aktor iti trabaho.

POST https://nymbot.ai/api/v1/audio/transcriptions Naaddaankami iti API key, wenno Adda pay pay laeng ti request.Ti Corpo ti multipart/form-data.

Para iti WAV, WebM, MP4 ken Ogg file, ti lenguahe ti imbagana manipud iti file ngem iti runset, tapno maaddaan iti nasurok a 30 a minuto ti imbagana manipud iti front (ti 3 a segundo). Ti lenguahe ti file ti WAV ket maaddaan manipud iti sample rate, channel ken sample size. Ti lenguahe ti dadduma a format, kas iti MP3, ket saan a maaddaan manipud iti front, agingga a limitado iti size: iti lowest bitrate Nymbot assumes, 8 kbps, 30 a minuto ket 1.8 MB, ken maysa a bigger file iti daytoy a format ti maaddaan manipud iti 8 kbps. 413 audio_too_long Ngem saan a naaddaan iti WAV, WebM, MP4 wenno Ogg. No pimmanaw ti pimmanaw iti 30 a minuto ngem saan a naaddaan ti pimmanaw iti WAV, ti pimmanaw ket naaddaan iti WAV. 413 audio_too_long, ken kuna ti Whisper ket nagturong, 30 a minuto ti kararuam.

Ti pagbayad iti lenguahe ti audio, nga agbuteng agingga iti segundo: ti lenguahe a nairekord iti file, ti lenguahe ti Whisper reports, ken ti minimum ti size ti file permita, iti per-minuto a presyo ti Whisper iti usual fee ken margin, ken iti minimum 0.05 a credit a request. 402 Iti app, ti transcribing a voice message ti libre; iti API, ti laeng ti kararuam.

Reaksiona

{
  "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 Kitaen dagiti ladawan. srt ken vtt Kitaen dagiti ladawan. verbose_json Agipatpatarus kadagiti 3 a segmento a saan a saan a JSON, ti gastos ket iti 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);

Umadawtayo iti English.

POST https://nymbot.ai/api/v1/audio/translations Naaddaankami iti API key, wenno Adda pay pay laeng ti request.Ti Corpo ti multipart/form-data.

Daytoy ti transcription, iti sama a fields agsipud iti languageTi teksto ket naaddaan iti English no ania ti lengguahe. 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);

Impanna iti

Agipatpatarus ti teksto iti vector para iti search, clustering, ken deduplication. Ti modelo ket nairuar iti Cloudflare ken agpatarus iti standard balance.

POST https://nymbot.ai/api/v1/embeddings Naaddaankami iti API key, wenno Adda pay pay laeng ti request..

Ti list ti modelo ket ti al-aldaw ti panangmatmat ti maipapan kadagiti naidumduma ken ti panangmatmatda; ti Google’s EmbeddingGemma, nga addaan iti korte a vektor iti pedido, ket nairaman iti kasta a kaduana ti katalog ti nagkauna.

Reaksiona

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