Sylfaen wybodaeth Ymchwiliad
Lluniau, Audio a Embeddings
Mae'r generators o'r app, a'r blwch adeiladu ar gyfer chwilio: lluniau, fideo, gofynion, transcription a embeddings, yr un yn cael ei gyfrifo ar gyfer defnyddiadau o'ch sylfaen.
Mae'r dudalen hon wedi'i chyfieithu â pheiriant er hwylustod. Y fersiwn Saesneg wreiddiol yw'r fersiwn berthnasol.
generadur o fideo
Mae'n gwneud un i fideos 4 o'r lluniau o'r prompt ac yn mynd i lawr ar ôl ei wneud. Mae'n un set o generators fel ?image Yn y app.
POST https://nymbot.ai/api/v1/images/generations — mae angen cleiant API, neu Pecyn Lightning ar gyfer gwestiynau.
Mae'r IDs yn dod o GET /api/v1/models?type=imagey generadur standard,
@cf/black-forest-labs/flux-1-schnell, cost a flat 5 credyd standard (50 sats) un llun. Cedwir pob generator pro credyd ar ei pris ei hun, gyda'r farchnad arferol a marw, fel mewn Ymchwiliad. n Fotograffeg prisiau
n Mae'r llinell a'r generadur yn dod yn oed yn dod yn ôl; mae'r generadur standard yn defnyddio'r prompt yn unig.
| Ymchwiliad | Ymchwiliad | Ymchwiliad | Disgrifiad |
|---|---|---|---|
model | Ymchwiliad | Oes | Mae generadur ID, fel nano-banana. |
prompt | Ymchwiliad | Oes | Mae'n cael ei ddefnyddio dim ond y 2000 o'r cyfres cyntaf. |
n | Ymchwiliad | yn | 1 i 4. Defawr 1. Mae hefyd yn cael ei adnabod fel num_images. |
size | Ymchwiliad | yn | Mae'r aspect ratio fel "16:9", neu gwahanol maint OpenAI fel "1792x1024", sy'n cael y rhan fwyaf o 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 5:4 a 4:5. "auto" Ychwanegu at y generadur. |
aspect_ratio | Ymchwiliad | yn | Mae'r un fel sizeMae'n cael ei wella os yw'r ddau yn cael eu chwilio. |
quality | Ymchwiliad | yn | peiriant generadurol, fel "low", "medium" Yn "high". |
negative_prompt | Ymchwiliad | yn | Ydych chi'n dal i mewn. |
output_format | Ymchwiliad | yn | "png", "jpeg" Yn "webp". |
response_format | Ymchwiliad | yn | "url" (Ydych chi'n cael y defnyddiadau) neu "b64_json". |
image_url | Ymchwiliad | yn | Mae'n dechrau gan: A https:// cyswllt o hyd at hyd at 4,096 cyfres gyda dim enw defnyddiwr neu password mewn ei, neu data:image/…;base64 URL (PNG, JPEG, WebP neu GIF; nid yw'n SVG). editYmchwiliad â'r rhai gyda requires_image_url. |
resolution Nid yw'n cael ei ddefnyddio: Mae pob generadur yn gwneud ei hun maint. url, mae pob llun yn cael ei lawrlwytho i'r gwmpas Blossom public a byddwch yn cael ei gysylltiad (maint rhai generators yn unig yn darparu gysylltiad ei hun, sy'n cael ei ddarparu). Mae'r cofrestr yn gwybodMae gyda
b64_json Mae'r fideos yn cael ei adnabod yn ôl i'r adolygiadau ac yn cael ei adnabod. data: Ymchwiliad image_url Mae'n chwilio fel un
Ewch a lawrlwytho i Blossom yn gyntaf i'r generadur i lawrlwytho; mae'n cael ei ddylunio'n ôl os yw'r gofynion yn awgrymiad.
Os yw rhai o'r n ffeiliau yn falch, mae'n cael y rhai sy'n gweithio, yn cael eu llwytho yn unig ar gyfer y rhai (cyson unrhyw un o'r cyflenwr yn llwytho i'w falch), a nymbot.failed Mae'r rhan fwyaf o'r defnyddiadau yn cael eu hwyluso. Os ydych chi'n hwyluso, mae'r defnyddiadau yn cael eu hwyluso. 502.
Ymchwiliad
{
"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 }
}
| statws | Ymladd |
|---|---|
400 | Ni fydd yn gyflym n Yn unol â 1 i 4 (invalid_valueMae'r rhan fwyaf o'r rhan fwyaf (invalid_size) neu lluniau (invalid_image, invalid_image_url); model sy'n bwysig, ond nid yw'r generadur image (invalid_model); lluniau ar gyfer generadur sy'n cael ei redeg (edit_unsupported); nid oes lluniau ar gyfer un sy'n angen ei (image_required). |
402 | Mae'r cyfanswm yn gallu cwmpasu pob llunion a ddefnyddir. |
404 | Nid yw'r model gyda'r enw hwn (model_not_found). |
502 | Mae'r generadur yn falch (upstream_errorNid yw'n cael ei gyfrifiad os yw'r cyflenwr yn cael ei gyfrifiad ar gyfer y brofiad; yna mae'r defnyddiwr yn cael ei gyfrifiad. charged_sats. |
503 | Mae'r fideo yn cael ei hysbysu yn awr (media_hosting_unavailable). b64_json Ymchwiliad . |
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);
Ymchwiliad image
Mae'r swyddogaethau yn cael ei ddibynnu ar y rhan fwyaf o'r swyddogaethau.This is OpenAI's editing endpoint, so the OpenAI SDKs' images.edit yn gweithio fel y mae'n. Yn unig Generators Pro gyda edit Yn y llwytho model, mae'n croeso.
POST https://nymbot.ai/api/v1/images/edits — mae angen cleiant API, neu Pecyn Lightning ar gyfer gwestiynauMae'r corff yn multipart/form-dataYn fwy na 32 MB.
| Ymchwiliad | Ymchwiliad | Ymchwiliad | Disgrifiad |
|---|---|---|---|
image | Ffeiliau | Oes | Mae'r llun i redeg: PNG, JPEG, WebP neu GIF, hyd at 20 MB. image[]Mae'r cyntaf yn cael ei ddefnyddio. |
prompt | Ymchwiliad | Oes | Ydych chi'n newid. |
model | Ymchwiliad | Oes | Mae generadur gyda edit. |
n | Ymchwiliad | yn | 1 i 4. |
sizeaspect_ratioqualitynegative_promptoutput_format | Ymchwiliad | yn | Yn y generadur. |
response_format | Ymchwiliad | yn | "b64_json" (Ychwanegwch yma) neu "url". |
Mae'r delweddau sy'n chwilio i fod yn PNG, JPEG, WebP neu GIF wedi'i ffurfio yn dda, yn cael eu chwilio fel y math real, ac yn cael ei gosod ar gwerthwr Blossom public, oherwydd mae'r generators yn chwilio'r cyfnewid ar ôl cysylltiad. Trosi'r delweddau fel gwerthwr public. Os yw'r cyfnewid yn awgrymu a dim ond ni'n cael ei leoli, mae'r copy gwerthwr yn cael eu torri yn ôl. Mae'r cyfnewid yn un o'r ffurfio fel y generator.
Ymchwiliad
{
"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 }
}
| statws | Ymladd |
|---|---|
400 | Mae'r ffeiliau a'r ffeiliau a'r ffeiliau a'r ffeiliau a'r ffeiliau a'r ffeiliau a'r ffeiliau (invalid_image), neu generadur sy'n awgrymu (edit_unsupported). |
413 | Mae'r fideo yn fwy na 20 MB (file_too_large), neu'r gofynion cyfan o fwy na 32 MB. |
503 | Mae'r fideo yn cael ei hysbysu yn awr (media_hosting_unavailable). |
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"));
fideo
Mae fideo yn cymryd munud, felly mae'n rhedeg yn y background. Mae'n rhoi'i, yn cael ID yn uniongyrchol, ac yn chwilio am'r id hyd yn cael ei wneud. Mae pob generadur fideo yn trosi'r balanse Pro.
POST https://nymbot.ai/api/v1/videos — mae angen cleiant API, neu Pecyn Lightning ar gyfer gwestiynauYmchwiliad 202.
| Ymchwiliad | Ymchwiliad | Ymchwiliad | Disgrifiad |
|---|---|---|---|
model | Ymchwiliad | Oes | Mae generadur fideo ID o GET /api/v1/models?type=videoYn ogystal â veo. |
prompt | Ymchwiliad | Oes | Mae'n rhaid i wneud. |
duration | cyfres neu string | yn | Mae'n cael ei ddefnyddio yn unig gan generators sy'n caniatáu i chi dewis y hyd; mae'r eraill yn gwneud ei hyd arferol, sy'n hyn seconds Yn y cyswllt a'r pris yn ôl. |
aspect_ratio | Ymchwiliad | yn | Mae'r "16:9" Yn "9:16"Mae'r maint fel "1280x720" Mae'n dod â'r ratio. |
resolutionquality | Ymchwiliad | yn | Un o'r generadur resolutions Yn y llestr model, fel "720p" Yn "1080p"Mae'n sefydlu'r pris. Fodd bynnag, mae'r arall yn cael ei adnabod gyda unsupported_resolution. |
image_url | Ymchwiliad | yn | Mae'n dechrau gan: A https:// Ymchwiliad a data:image/… URL, sy'n cael ei lawrlwytho i hostau Blossom public yn gyntaf. Dylunio gan generators gyda requires_image_url. |
Mae'r pris yn sefydlog pan fyddwch yn chwilio, o'r generadur, adolygiad a dymheredd, felly mae'n cael ei leoli o'ch saledd Pro os yw'r cyflenwr yn dderbyn y gwaith, ac yn dangos fel
cost, estimated_cost a nymbot. Os mae'r cyflenwr yn gofyn i'r gwaith, nid yw'n cael ei gyfrifiad. Os mae'r rendering yn awr yn gofyn, neu mae'r clysiant wedi'i archebu ac mae'r cyflenwr yn cael ei gyfrifiad, mae'r charger yn cael ei gyfrifiad unwaith, yn awtomatig. Mae'r rendering sy'n cael ei gyfrifi ar ôl un amser yn cael ei gyfrifiad, ac mae'n cael ei gyfrifiad, oherwydd bod y cyflenwr yn gyfrifiad unwaith y mae'n cael ei gyfrifiad. Mae'n gyfrifiad yn gyfrifiad y credyd, ond nid yw'r cyfrifiad chi'n gyfrifiad.
Ymchwiliad (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 Yn dechrau in_progresso completed Mae'r fideo wedi'i data Mae'r generadur yn dod yn uniongyrchol.
Chwilio ar fideo
GET https://nymbot.ai/api/v1/videos/{id} - mae'n rhaid i chi gael cleif sy'n hoffi i'r nym sy'n darparu'r cleif. Mae'r cleif sy'n cyrraedd y cap yn gallu cychwilio.
Ymchwiliad 202 Mae'r fideo yn cael ei wneud a 200 unwaith y mae'n cael ei gynlluni neu wedi'i gwblhau. Ychwanegu bob 5 i 10 munudau. Mae pob gwblhau yn chwilio i'r cyflenwr unwaith ac yn ymgynghori yn unwaith; mae'n awgrymu bob amser ar gyfer y fideo. Mae'r swydd yn cael ei hysbysu am 24 awr ar ôl ei ddarparu.
GET /api/v1/videos Mae'r cyswllt o'r 50 swyddiau diweddaraf y cyswllt fel
{"object": "list", "data": […]}.
Ymchwiliad (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 Yn in_progress, completed Yn failed. . . . . . . . . . error ({"code": "generation_failed", "message": …}Os yw'n cael ei ryddhau, cost Mae 0 a nymbot Yn ychwanegu
refunded_credits a refunded_satsMae'r fideo wedi'i gynllunio ar bwrdd Blossom, fel lluniau a gynhyrchion.
| statws | Ymladd |
|---|---|
400 | Ymchwiliad â'r cyswllt 0 i 60 (invalid_value); yn adolygiad y generadur yn cynnig (unsupported_resolution); unrhyw llun ar gyfer generadur sy'n angen un (image_required); model a dim ond generadur fideo (invalid_model). |
402 | Mae'r balanse Pro yn gallu cwmpasu'r fideo. |
404 | Mae'r generadur yn (model_not_found), neu unrhyw gwaith gan y ID ar gyfer eich nym, neu mae'n fwy na 24 awr (video_not_found). |
429 | Mae'r eich nym wedi bod yn cael 10 fideo rendering (video_jobs_limitYdych chi'n ymgorffori'r ystyried ac yn dod o hyd i'r cyfieithu. |
502 | Mae'r generadur yn dod i'r gwaith. Nid yw'n cael ei gyfrifiad os yw'r cyflenwr yn cael ei gyfrifiad. |
503 | Mae'r fideo yn cael ei ddibynnu neu archebu yn awr (media_hosting_unavailable, service_unavailable). |
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);
Tystysgrif
Mae'n llwytho text i mewn i'r ffeiliau audio yn ei hun, nid yw'n gysylltiad. audio.speech.create Mae'r OpenAI SDKs yn gweithio.
POST https://nymbot.ai/api/v1/audio/speech — mae angen cleiant API, neu Pecyn Lightning ar gyfer gwestiynau.
| Ymchwiliad | Ymchwiliad | Ymchwiliad | Disgrifiad |
|---|---|---|---|
model | Ymchwiliad | yn | Mae'r model o Llwytho i'r modelau audio. Default: mae'r ffôn standard, @cf/myshell-ai/melotts. aura-2 Mae hyn yn Deepgram Aura 2. |
input | Ymchwiliad | Oes | Tystysgrif i lawrlwytho: hyd at 800 cartegiau ar gyfer y siopa safonol, 2,000 ar gyfer Aura 2. |
voice | Ymchwiliad | yn | Mae'r ID o Llwytho i lawr: Aura speaker fel luna Ymchwiliad aura-2-luna-enMae'r rhan fwyaf o'r rhan fwyaf o'r rhan fwyaf o'r rhan fwyaf (en, es, fr, zh). OpenAI enw vocal fel alloy Mae'r modelau yn cael ei adnabod ac mae'r modelau yn cael ei adnabod. |
language | Ymchwiliad | yn | Mae'r codau rhyngwladol fel esOs ydych chi'n chwilio am yr un o'r enw, mae'n chwilio am yr un o'r enw, mae'n chwilio am yr un o'r enw. 422 voice_language_mismatch, a'r ystyried y mae'r model nid yw'n haeth i 422 unsupported_language. |
response_format | Ymchwiliad | yn | Mae'r ystyried standard yn dod yn ôl mp3 Mae Aura 2 yn ôl. mp3 (Ydych chi'n cael y defnyddiadau), opus, aac, flac, wav Yn pcm. |
speed | cyfres | yn | Ychwanegu a ignoreiddio. |
Mae'r ffôn safonol yn costau 3 credyd safonol (30 sats) o feysydd, fel yn y app. Aura 2 yw Pro, prisio ar ôl y carregion sy'n send. Mae'r corff cyswllt yw'r audio, gyda'r cyswllt
Content-TypeMae'r cost yn y X-Nymbot-Cost-Sats Os yw'r modelau talu yn falf, nid yw'n cael ei leoli.
Ymchwiliad
HTTP/1.1 200 OK
Content-Type: audio/mpeg
X-Nymbot-Cost-Sats: 4.2
X-Nymbot-Balance-Sats: 41055.6
(audio bytes)
| statws | Ymladd |
|---|---|
400 | Ymchwiliad: Mae'r rhan fwyaf o'r rhan fwyaf o'r model (input_too_long); fformat a'r model yn gallu cynhyrchu (unsupported_response_formatMae'r rhan fwyaf o'r rhan fwyaf o'r rhan fwyaf yn unol (invalid_voice); model sy'n cael ei ddylunio (invalid_model). |
422 | Mae'r ystyried yn parhau'r ddiddordeb, neu mae'r model yn cael ei rwystro. |
502 | Mae'r modelau talu yn gwbl. Ni fydd yn cael ei gyfrifiad. |
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()));
Modelau a Gwestiynau Audio
Mae dwy llysiau arbenigol ar gyfer dewis model y gofynion a'r gofynion, neu'r model y transgrifiad. Mae ganddo 41 Aura 2 o ddiddordebwyr Sbaeneg a gwmni MeloTTS.
GET https://nymbot.ai/api/v1/audio/models Mae'n cael ei angen i chi.
GET https://nymbot.ai/api/v1/audio/voices?language=en Mae'n cael ei angen i chi.
| Ymchwiliad | Ymchwiliad | Ymchwiliad | Disgrifiad |
|---|---|---|---|
language | Ymchwiliad (query) | yn | Rwy'n dod â ffoniadau o'r dull hwn. |
model | Ymchwiliad (query) | yn | Mae'n unig gwestiynau ar gyfer model hwn. |
Ymchwiliad (Voices)
{
"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 }
]
}
Mae'r modelau yn cyswllt {"object": "list", "data": {"tts": […], "stt": […]}}Mae pob modelau talu yn darparu'r sylfaen, pris, max_input_chars,
response_formats, languages a default_voiceMae'r model transgrifiad yn rhoi ei adnoddau, max_file_bytes, max_seconds, fformat a pris per munud.
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);
Tystysgrifau
Mae'r cyfieithu yn cyfieithu â text gyda Whisper. Mae hyn yw'r endpoint transcription o OpenAI, felly
audio.transcriptions.create Ymchwiliad
POST https://nymbot.ai/api/v1/audio/transcriptions — mae angen cleiant API, neu Pecyn Lightning ar gyfer gwestiynauMae'r corff yn multipart/form-data.
| Ymchwiliad | Ymchwiliad | Ymchwiliad | Disgrifiad |
|---|---|---|---|
file | Ffeiliau | Oes | Mae'r archebu, o 256 bytes i 25 MB a hyd at 30 munud: WAV, WebM, MP4 neu M4A, Ogg neu Opus, MP3 a fformatau eraill Whisper lleoli. |
model | Ymchwiliad | yn | Ymchwiliad whisperMae'r rhan fwyaf o whisper v3 turbo. whisper-1, whisper-large-v3-turbo a @cf/openai/whisper-large-v3-turbo Mewngofnodi hefyd. |
language | Ymchwiliad | yn | Ydych chi'n parhau, fel enYmchwiliwyd os yw'n cael ei lawrlwytho |
prompt | Ymchwiliad | yn | Ydych chi'n chwilio am ddiddordeb, er enghraifft o ddiddordeb, er enghraifft yn cael ei ddefnyddio dim ond y 1000 o ddiddordeb cyntaf. |
response_format | Ymchwiliad | yn | json (Ydych chi'n cael y defnyddiadau), text, srt, vtt Yn verbose_json. |
Ar gyfer ffeiliau WAV, WebM, MP4 a Ogg, mae'r hyd yn cael ei lawrlwytho o'r ffeiliau yn ôl i'w rhedeg, felly mae'r recordiau mwy na 30 munud yn cael ei rhyddhau yn y blaen (gyda 3 munud). Mae'r hyd o'r ffeiliau WAV yn dod o'i cyflymder sampl, canllawiau a maint y sampl. Mae'r hyd o fformatiau eraill, megis MP3, yn cael ei rhyddhau yn y blaen, felly mae'n cael eu rhyddhau yn y maint: ar y cyflymder bitiau isel Nymbot yn ddelfryd, 8 kbps, 30 munud yw 1.8 MB, ac mae'r ffeil mawr yn fformat hwn yn cael ei rhyddhau gyda 413
audio_too_long Ydych chi'n ymgorffori'r rhestriau yn fwy na 30 munud, mae'r gwestiynau yn cael ei adnabod fel WAV, WebM, MP4 neu Ogg. Os ydych chi'n ymgorffori'r rhestriau yn fwy na 30 munud, mae'r gwestiynau yn cael ei adnabod gyda
413 audio_too_long, ac os yw Whisper yn rhedeg, 30 munud yn cael ei rhedeg.
Ydych chi'n prynu ar gyfer y hyd y lledr y lledr, yn rhedeg i lawr i lawr: mae'r lledr mwyaf o hyd i'r ffeil, mae'r lledr y rhyddhau y lledr, ac mae'r lledr y lledr y lledr yn caniatáu, ar y pris per-minut y lledr gyda'r farchnad a'r farchnad arferol, ac mae'n rhad ac am ddim 0.05 credyd i'r gofynion. Mae'n cael eu prynu o'r rhyddhau safonol pan fydd yn gallu cwmpasu'r rhyddhau, ac o'r pro eraill; 402 Yn y app, gall transgrifio misiau vocal yn rhad ac am ddim; ar y API mae'n cael ei leoli bob amser. Os Whisper yn gwbl, nid yw'n cael ei leoli.
Ymchwiliad
{
"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 Gwrthdaro text clir, srt a vtt Ymchwiliad subtitl, a
verbose_json Mae'r rhannau yn cael ei addasu â'r ystyried, dymheredd a timed. Ar gyfer y trydydd sy'n nid yw'r JSON, mae'r cost yn y headers.
| statws | Ymladd |
|---|---|
400 | Mae'r ffeil wedi'i wneud yn cael ei ddefnyddio (invalid_audio), fformat heb ei adnabyddus, neu model nid yw'r model transgrifiad (invalid_model). |
402 | Peidiwch â chydweithrediad a chydweithrediad. |
413 | Mae'r ffeil yn fwy na 25 MB (file_too_large) neu'r llwytho yn fwy na 30 munud, neu, yn fformat sy'n golygfeydd a fydd yn cael ei leoli i lawr, yn fwy na 1,8 MB (audio_too_long). |
502 | Gwisgwr yn gallu cynhyrchu'r adolygiadau. Nid yw'n cael ei leoli. |
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);
Trosglodion ar gyfer yr Efryd
POST https://nymbot.ai/api/v1/audio/translations — mae angen cleiant API, neu Pecyn Lightning ar gyfer gwestiynauMae'r corff yn multipart/form-data.
Mae'r cyfieithu yn uniongyrchol â'r cyfieithu, gyda'r uniongyrchol o language, llinellau a phris, ond mae'r text yn dod yn enghraifft i'r gwanwyn. Mae'r OpenAI SDKs yn chwilio am 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);
Ymchwiliad
Ychwanegu text yn vectors ar gyfer chwilio, clusterio a deduplication. Mae'r modelau yn rhedeg ar Cloudflare ac yn trosi'r balanse safonol.
POST https://nymbot.ai/api/v1/embeddings — mae angen cleiant API, neu Pecyn Lightning ar gyfer gwestiynau.
| Ymchwiliad | Ymchwiliad | Ymchwiliad | Disgrifiad |
|---|---|---|---|
model | Ymchwiliad | Oes | Mae'r model o GET /api/v1/models?type=embedding. |
input | String a Array o Strings | Oes | Ymchwiliad â'r cyswllt, mae'r cyswllt yn cael ei ddibynnu i mewn i'r cyswllt. (token_input_unsupportedMae'n rhaid i chi'n cydymffurfio â'r model context_length, cyfrifwyd fel o 4 bytes un token. |
encoding_format | Ymchwiliad | yn | float (Ydych chi'n cael y defnyddiadau) neu base64 (Ychwanegwyd ar gyfer 32-Bit Floats) |
dimensions | Ymchwiliad | yn | o'r maint y model, neu ar gyfer model gyda supported_dimensions Un o'r hyn; mae'r vector yn cael ei broses ac yn cael ei normalized. |
| modelau | Dimensiwn | Ymchwiliad |
|---|---|---|
@cf/baai/bge-m3 | 1024, llawer o adolygiadau | Mae 8192 tokeniau |
@cf/qwen/qwen3-embedding-0.6b | 1024, llawer o adolygiadau | Mae 8192 tokeniau |
@cf/baai/bge-large-en-v1.5 | 1024 - Diwydiannol | Mae 512 o ganlyniadau |
@cf/baai/bge-base-en-v1.5 | 768 yn yr Eglwys | Mae 512 o ganlyniadau |
@cf/baai/bge-small-en-v1.5 | 384 yr Eglwys | Mae 512 o ganlyniadau |
Mae'r list o'r modelau yn ddiddordeb y mae'n cael ei gael ac mae'n cost; mae'r Google's EmbeddingGemma, gyda vectors shorter ar gofynion, yn dangos yma hefyd pan fydd y catalog wedi pris ar gyfer ei. Mae'r embeddings yn cael eu mesur ar gyfer token ynni, ac mae'r minimum 0.05-credyd yn cael ei ddefnyddio ar gyfer pob gofynion, nid ar gyfer pob gofynion, felly mae'n parhau nifer o ffeiliau mewn un gofynion yn fwy rhad ac yn cael eu send un o'r amser.
Ymchwiliad
{
"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 }
}
| statws | Ymladd |
|---|---|
400 | Ymchwiliad â chynhyrchwyr a chyflenwyrtoken_input_unsupported); mwy na 100 ynni (too_many_inputs); cyfrif yn fwy na'r model yn cymryd (input_too_long); y maint y model yn gallu darparu (unsupported_dimensions). |
402 | Mae'r balanse safonol yn isel iawn. Mae'r embeddings yn cael ei ddefnyddio'r balanse Pro. |
404 | Nid yw'r model yn cael ei adnabod gan ei enw. |
502 | Mae'r model yn gwbl. Ni fydd yn cael ei gyfrifiad. |
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);