Base sa kahibalo / Mga Developer

Ang mga imahe, audio ug embeddings

Ang mga generator gikan sa app, ug ang mga building blocks alang sa pag-uswag: pictures, video, speech, transcription ug embeddings, ang matag nga gibutang alang sa paggamit gikan sa imong balanse.

Kini nga panid gihubad sa makina alang sa kasayon. Ang English nga orihinal mao ang bersyon nga magamit.

Ang mga imahe

Kini mao ang usa ka bahin sa pag-uswag sa mga tawo sa pag-uswag sa mga tawo sa pag-uswag sa mga tawo. ?image Ang imong app.

POST https://nymbot.ai/api/v1/images/generations — kinahanglan nga usa ka API key, o Ang Lightning Pagbayad sa Pagpangita.

Ang yuta palibot sa GET /api/v1/models?type=imageAng usa ka generator, @cf/black-forest-labs/flux-1-schnell, mao ang usa ka flat 5 standard credits (50 sats) usa ka picture. Ang uban nga generator gitawag Pro credits sa iyang mga presyo, uban sa usa ka normal nga fee ug margin, sama sa Ang app. n Ang mga imahe n Ang usa ka field nga ang generator dili motan-aw mao ang gisugyot ug dili rejected; ang standard generator usa lamang ang prompt.

resolution Wala, wala sila muadto sa kalibotan. url, ang matag imahe mao ang upload sa usa ka publikong Blossom host ug imong makuha ang link niini (ang pipila ka mga generator lamang magpadala sa usa ka link sa kanila, nga gibahin sa). Unsay iyang gitudlo niini?Ang b64_json ang imahe magpadala diha sa reaksiyon ug wala mag-upload. Ang imahe magpadala sa data: Ang image_url Ipahamtang ang sama sa una Ang ug i-upload sa Blossom sa una aron ang generator makahimo sa pagkuha niini; kini mao ang gikuha sa taas kung ang panginahanglan dili unfibred.

Ang ilang mga n mga imahe bug-os, makakuha ka sa mga nga nagtrabaho, nga gitawag lamang alang sa mga (plus bisan unsa ang provider gitawag bisan sa pag-usab), ug nymbot.failed Tungod niini, tan-awa ang mga bahin sa mga bahin sa mga bahin sa mga bahin sa mga bahin sa mga bahin sa mga bahin. 502.

Tungod niini

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

Ang mga imahe

Kini mao ang edit endpoint sa OpenAI, aron ang OpenAI SDKs ' images.edit Gikan sa mga generator alang sa edit Ang listahan sa mga modelo mao ang pagtuon niini.

POST https://nymbot.ai/api/v1/images/edits — kinahanglan nga usa ka API key, o Ang Lightning Pagbayad sa PagpangitaAng tanan nga multipart/form-dataAlang sa ubang mga dapit sa 32 MB.

Ang imahe nga i-upload mao ang checked alang sa usa ka kaayo-format nga PNG, JPEG, WebP o GIF, gipaila sa ingon sa iyang mga katungod nga matang, ug gibuhat sa usa ka publikong Blossom host, tungod kay ang mga generator makuha ang iyang input pinaagi sa link. Gipaila kini ingon sa publikong. Kung ang editing bug-os ug wala payload, ang hosted kopya gikuha sa taas. Ang pag-uswag mao ang sama sa form nga sama sa sa generator. Price mao ang presyo sa generator, nga alang sa ilang generator naglakip ang usa ka bayad alang sa input picture.

Tungod niini

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

Ang video

Ang usa ka video mahitungod sa mga minuto, aron kini moapil sa background. Ipadala mo kini, makuha ang usa ka id sa karon, ug mahitungod sa id hangtod sa paghimo.

POST https://nymbot.ai/api/v1/videos — kinahanglan nga usa ka API key, o Ang Lightning Pagbayad sa PagpangitaAng balik 202.

Ang presyo mao ang fixed sa pagpadala mo, gikan sa generator, resolusyon ug length, aron kini mao ang gitawag gikan sa imong Pro balanse sa diha nga ang provider nakadungog sa trabaho, ug gipakita ingon cost, estimated_cost ug nymbotKung ang provider moabut ang trabaho, wala pa moabut. Kung ang render sa ubos pa, o ang katapusan nga clip dili makahimo sa pag-alagad ug ang provider dili moabut sa bill alang niini, ang load sa pagbabayad sa usa ka beses, automatically. Ang render nga wala pa moabut sa sulod sa usa ka oras mao ang gikuha, ug makahimo sa iyang charge, tungod kay ang provider moabut sa usa ka render sa diha nga kini makahimo niini.

Alang sa ubang mga dapit sa mao gihapon nga ngalan (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 Ang in_progressAng completed Ang video karon anaa sa data Ang generator nagpatin-aw sa mga tawo ug nagpatin-aw.

Maayo gani sa video

GET https://nymbot.ai/api/v1/videos/{id} — gikinahanglan ang usa ka key nga bahin sa nym nga nagpadala niini. Ang usa ka key nga nakadungog sa iyang cap mahimo sa pag-check.

Naa kay 202 Ang video mao ang gihimo ug 200 sa diha nga kini sa katapusan o sa pag-usab. Pangutana sa matag 5 ngadto sa 10 segundo. Ang matag pag-usab nag-usab sa provider usa ka beses ug nag-usab sa usa ka paagi; kini wala pa moadto sa pag-usab sa video. Ang usa ka trabaho gibuhat alang sa 24 ka oras sa diha nga kini gihatag. GET /api/v1/videos Ang mga 50 ka mga trabaho sa key mao ang {"object": "list", "data": […]}.

Adunay 200 ka molupyo.

{
  "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 Ang in_progress, completed Ang failedAng usa ka misulod nga trabaho error ({"code": "generation_failed", "message": …}Ug kamo magapanag-iya sa yuta, ug magapuyo diha; cost Ang 0 ug nymbot Ang refunded_credits ug refunded_satsAng katapusan nga video mao ang sa usa ka publikong Blossom host, sama sa mga imahe nga gihimo.

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

Tungod niini, ang

Pag-usab sa teksto ug magpatalinghog sa audio file, wala pa sa usa ka link. Kini mao ang OpenAI speech endpoint, ug audio.speech.create Alang sa ubang mga dapit sa mao gihapon nga ngalan, tan-awa ang OpenAI SDK.

POST https://nymbot.ai/api/v1/audio/speech — kinahanglan nga usa ka API key, o Ang Lightning Pagbayad sa Pagpangita.

Ang standard voice mao ang usa ka flat 3 standard credits (30 sats) sa usa ka request, sama sa sa app. Aura 2 mao ang Pro, nga hinungdanan sa mga character nga imong magpadala. Ang responsive body mao ang audio, uban sa usa ka matching Content-TypeAng gasto mao ang sa X-Nymbot-Cost-Sats Kung ang modelo sa pagpakig-uswag dili maayo, wala pa kinahanglan ang pag-uswag.

Tungod niini

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

Ang mga modelo sa audio ug mga vokal

Duha ka publikong listahan alang sa pagpilit sa usa ka speech model ug voice, o usa ka transcription model. Kini mao ang 41 Aura 2 English speakers ug 4 MeloTTS mga pinulongan.

GET https://nymbot.ai/api/v1/audio/models maayo ang key.

GET https://nymbot.ai/api/v1/audio/voices?language=en maayo ang key.

Ang tawo nagtuo (

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

Ang mga modelo sa listahan sa mga replies {"object": "list", "data": {"tts": […], "stt": […]}}Ang matag modelo sa speech naghatag sa iyang balanse, presyo, max_input_chars, response_formats, languages ug default_voiceAng transcription model naghatag sa iyang aliases, max_file_bytes, max_seconds, mga format ug presyo sa matag 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);

Kusog kaayo ang teksto.

Ipahamtang ang usa ka transcription endpoint sa OpenAI. audio.transcriptions.create Ang trabaho.

POST https://nymbot.ai/api/v1/audio/transcriptions — kinahanglan nga usa ka API key, o Ang Lightning Pagbayad sa PagpangitaAng tanan nga multipart/form-data.

Alang sa mga file sa WAV, WebM, MP4 ug Ogg, ang lengtan nga gisulat gikan sa file sa wala pa moadto, aron ang usa ka recording sa labaw pa kay sa 30 minutos mao ang gikuha sa front (sa 3 seconds' grace). Ang lengtan sa usa ka file sa WAV mao ang gikan sa iyang sample rate, mga channel ug sample size. Ang lengtan sa ubang mga format, sama sa MP3, dili magsulat sa front, kay sila limitado sa size: sa ubos nga bitrate Nymbot gikuha, 8 kbps, 30 minutos mao ang 1.8 MB, ug usa ka labaw pa nga file sa ingon nga format mao ang gikuha sa 413 audio_too_long Pagpadala sa dugang nga mga recordings sama sa WAV, WebM, MP4 o Ogg. Kung Whisper unya report sa labaw pa kay sa 30 minutos, ang mga panginahanglan nga gihubit sa 413 audio_too_long, ug tungod kay Whisper gihimo, 30 minutos mao ang sa pag-charge.

Ipahamtang sa dugang sa audio, nga gikuha ngadto sa mga segundo: ang dugang sa dugang nga gikuha gikan sa file, ang dugang sa Whisper reports, ug ang ubos sa gidak-on sa file ang makahimo, sa per-minute nga presyo sa Whisper uban sa normal nga bayad ug margin, ug sa ubos pa kay sa 0.05 credit usa ka request. Kini mao ang pagbayad gikan sa usa ka standard nga balanse kada nga mahimo sa pagtukod, ug gikan sa Pro sa lain-lain; 402 Ang transcription sa usa ka vocabulary mensahe mao ang free sa app; sa API, kini mao ang bug-os.

Tungod niini

{
  "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 Ipahamtang ang teksto, srt ug vtt Ipahamtang ang subtitle, ug verbose_json Ipahamtang ang mga segmento nga dili, duration ug timed. Para sa mga tulo nga dili JSON, ang gasto anaa sa mga 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);

Ang pag-uswag sa English

POST https://nymbot.ai/api/v1/audio/translations — kinahanglan nga usa ka API key, o Ang Lightning Pagbayad sa PagpangitaAng tanan nga multipart/form-data.

Sama sa transcription, uban sa sama nga mga fields uban sa language, mga limitasyon ug presyo, apan ang teksto mikuha sa English bisan unsa nga pinulongan. Ang OpenAI SDK naghubad niini ug 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);

Ang

Gikan sa teksto ngadto sa vectors alang sa paghimo, clustering ug deduplication. Ang mga modelo sa paghimo sa Cloudflare ug pag-usab sa standard balance.

POST https://nymbot.ai/api/v1/embeddings — kinahanglan nga usa ka API key, o Ang Lightning Pagbayad sa Pagpangita.

Ang listahan sa mga modelo mao ang kinatibuk-ang kasaysayan alang sa unsa ang anaa ug unsa ang kinahanglanon; ang Google's EmbeddingGemma, uban sa labaw pa nga vectors sa pagtan-aw, nagpakita niini usab kada ang catalog adunay usa ka presyo alang niini.

Tungod niini

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