Basis kawruh / Pembangunan

Gambar, audio lan embeddings

Generator saka aplikasi, lan blok bangunan kanggo pencarian: gambar, video, pidato, transkripsi lan embeddings, saben dihitung saben nggunakake saka saldo.

Kaca iki diterjemahake mesin kanggo penak. Asli Inggris minangka versi sing ditrapake.

Generasi gambar

Nggunakake salah siji nganti empat gambar saka prompt lan ngirimake nalika iku selesai. ?image Ing app iku.

POST https://nymbot.ai/api/v1/images/generations — perlu kunci API, utawa Pembayaran Lightning kanggo permintaan.

Tiyang iku saka GET /api/v1/models?type=imageIng generator standar, @cf/black-forest-labs/flux-1-schnell, biaya flat 5 kredit standar (50 sats) siji gambar. saben generator liyane nggunakake kredit Pro ing harga dhewe, karo biaya biasa lan margin, minangka ing Ing app. n Harga gambar n A field a generator ora njaluk ditumpuk lan ora ditolak; generator standar nggunakake prompt mung.

resolution ora digunakake: saben generator nggawe ukuran dhewe. url, saben gambar diunggah menyang host Blossom umum lan sampeyan njaluk tautan (beberapa generator mung ngirim tautan dhewe, sing ditransmisikake). Apa sing api bisa ndelengDheweke b64_json ing respon lan ora diunggah. gambar dikirim minangka data: URL ing image_url Dheweke diprodhuksi kanthi cara sing padha Tiyang lan ngunggah menyang Blossom pisanan supaya generator bisa njaluk; iku dihapus lagi yen perminta gagal dibukak.

Nalika sawetara saka n gambar gagal, sampeyan njaluk wong sing kerja, dibayarkan mung kanggo wong-wong (plus apa-apa penyedia dibayarkan malah gagal), lan nymbot.failed Ngandika sawetara sing mung. Yen kabeh gagal, permintaan ndadekake 502.

Jawaban

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

Ngirim gambar

Ngganti gambar sing sampeyan ngunggah, sawise prompt. iki iku titik endpoint edit OpenAI, supaya OpenAI SDK's images.edit kerja minangka iku. Hanya Pro generator karo edit Ing model daftar njaluk iku.

POST https://nymbot.ai/api/v1/images/edits — perlu kunci API, utawa Pembayaran Lightning kanggo permintaanTubuh iku multipart/form-dataSampeyan bisa nganti 32 MB.

Ing gambar sing ngunggah, njaluk minangka PNG, JPEG, WebP utawa GIF sing dibentuk kanthi apik, dikirim ing minangka tipe nyata, lan diwenehi host Blossom umum, amarga generator njaluk input kanthi link. Nglakoni minangka publik. Yen edit gagal lan ora ngeculake apa-apa, salinan host sing dihapus lagi. Jawaban duwe bentuk sing padha karo generator. Harga iku harga generator, sing kanggo sawetara generator kalebu biaya kanggo gambar input.

Jawaban

{
  "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 lan

Video njaluk menit, supaya njaluk ing latar belakang. Sampeyan ngirimake, njaluk id langsung, lan njaluk id nganti selesai. saben generator video nggunakake saldo Pro.

POST https://nymbot.ai/api/v1/videos — perlu kunci API, utawa Pembayaran Lightning kanggo permintaanKembali 202.

Harga ditempatake nalika sampeyan ngirim, saka generator, resolusi lan panjang, supaya iku dibayarkan saka saldo Pro sawetara provider njaluk pekerjaan, lan ditampilake minangka cost, estimated_cost lan 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 which 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.

Tembung (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 Mulane minangka in_progressDheweke completed Ing video iki ana ing data Dheweke bakal nggunakake generator langsung.

Teka ing video

GET https://nymbot.ai/api/v1/videos/{id} - butuh kunci sing dadi milik nym sing ngirimake.

Jawaban iku 202 Nalika video iki digawe lan 200 sawisé iku selesai utawa wis gagal. Tanya saben 5 kanggo 10 detik. saben cek nglakoni penyedia siji lan ngjawab ing wektu; iku ora nglakoni kanggo video. Pekerjaan diwenehi kanggo 24 jam sawise iku dikirim. GET /api/v1/videos Nulisake 50 karya-karya pungkasan saka kunci minangka {"object": "list", "data": […]}.

Ing taun 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 Dheweke in_progress, completed lan failedPekerjaan sing gagal nglakoni error ({"code": "generation_failed", "message": …}Dheweke bakal diwenehi reward. cost Iki 0 lan nymbot Tambah refunded_credits lan refunded_satsVideo selesai ana ing host Blossom umum, kaya gambar sing diprodhuksi.

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

Teks kanggo pidato

Maca teks dhuwur lan ngirim file audio dhewe, ora link. audio.speech.create ing OpenAI SDKs nggunakake.

POST https://nymbot.ai/api/v1/audio/speech — perlu kunci API, utawa Pembayaran Lightning kanggo permintaan.

Standar suara biaya rata 3 kredit standar (30 sats) siji permintaan, minangka ing app. Aura 2 iku Pro, harga dening karakter sing ngirim. Tubuh respon iku audio, karo matching Content-TypeBiaya iku ing X-Nymbot-Cost-Sats Yen model pidato gagal, ora ana apa-apa.

Jawaban

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 model lan suara

Dua daftar umum kanggo milih model bicara lan suara, utawa model transkripsi. Ana 41 Aura 2 basa Inggris lan empat basa MeloTTS.

GET https://nymbot.ai/api/v1/audio/models Ngandhakake kunci sing dibutuhake.

GET https://nymbot.ai/api/v1/audio/voices?language=en Ngandhakake kunci sing dibutuhake.

Jawaban (panggonan)

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

Modèla daftar jawaban {"object": "list", "data": {"tts": […], "stt": […]}}Masing-masing model bicara ngandika keseimbangan, harga, max_input_chars, response_formats, languages lan default_voiceDhèwèké nindakake al-Qur’an lan hadits. max_file_bytes, max_seconds, format lan harga per menit.

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

Panggonan ing teks

Ngubah rekaman menyang teks karo Whisper. iki iku titik akhir transkripsi OpenAI, supaya audio.transcriptions.create lan kerja.

POST https://nymbot.ai/api/v1/audio/transcriptions — perlu kunci API, utawa Pembayaran Lightning kanggo permintaanTubuh iku multipart/form-data.

Kanggo file WAV, WebM, MP4 lan Ogg, panjang iki dibaca saka file sadurunge apa-apa mbukak, supaya rekaman luwih saka 30 menit ditolak ing ndhuwur (dengan 3 detik). Panjang file WAV ana saka tingkat sampel, saluran, lan ukuran sampel. Panjang format liyane, kayata MP3, ora bisa dibaca ing ndhuwur, supaya padha dibatasi dening ukuran: ing bitrate paling rendah Nymbot njupuk, 8 kbps, 30 menit iku 1.8 MB, lan file luwih gedhe ing format iki ditolak karo 413 audio_too_long Ngirim rekaman sing luwih gedhe minangka WAV, WebM, MP4 utawa Ogg. Yen Whisper banjur melaporkan luwih saka 30 menit, permintaan ditolak karo 413 audio_too_long, lan wiwit Whisper digawe, 30 menit dibayar.

Sampeyan mbayar kanggo panjang audio, diwenehi nganti detik: paling panjang panjang dibaca saka file, panjang laporan Whisper, lan paling cilik ukuran file ngidini, ing harga per menit Whisper karo biaya biasa lan margin, lan minimal 0.05 kredit permintaan. 402 Ing aplikasi, transkripsi pesan suara bisa gratis; ing API iku uga dibayarkan.

Jawaban

{
  "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 Nggunakake teks sing jelas, srt lan vtt Kembali ing subtitles, lan verbose_json Ngandhut basa, durasi, lan segmen timed. Kanggo tiga segmen sing ora JSON, biaya ing header.

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

Translate ing basa ing basa ing basa ing Inggris

POST https://nymbot.ai/api/v1/audio/translations — perlu kunci API, utawa Pembayaran Lightning kanggo permintaanTubuh iku multipart/form-data.

Sama minangka transkripsi, karo kutha padha bagean saka language, limits lan harga, nanging teks mbukak ing basa ing basa Inggeris apa wae basa digunakake. 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);

Ingkang

Ngubah teks dadi vektor kanggo pencarian, clustering, lan deduplikasi. Model mbukak ing Cloudflare lan nggunakake keseimbangan standar.

POST https://nymbot.ai/api/v1/embeddings — perlu kunci API, utawa Pembayaran Lightning kanggo permintaan.

Daftar model iku sumber saka kebenaran kanggo apa sing kasedhiya lan apa biaya; Google's EmbeddingGemma, karo vektor sing luwih pendek ing permintaan, muncul ana uga nalika katalog duwe harga kanggo iku. Embeddings diukur per token input, lan minimum 0.05-kredit digunakake kanggo saben permintaan, ora kanggo saben input, supaya batch teks akeh ing siji permintaan iku luwih murah saka ngirimake siji ing wektu.

Jawaban

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